# Counterparties

## Get Counterparties

 - [GET /api/v2/counterparties/](https://docs.jiko.io/products/customer-api/reference/counterparties/list-counterparties-v2.md): This endpoint allows you to list all the counterparties associated with a customer's pocket. You can filter the results by
counterparty type (ach, wire, international_wire, on_us, etc.) and status (PENDING, LINKED, UNLINKED, etc.).

It returns a paginated list of Counterparty objects. The response includes a next_page token for retrieving more results.

## Create Counterparty

 - [POST /api/v2/counterparties/](https://docs.jiko.io/products/customer-api/reference/counterparties/create-counterparty-v2.md): This endpoint is used to create a new counterparty for a customer. You can create different types of counterparties,
including ach, on-us, wire, and international_wire, by providing the relevant details in the request body.

Note: The account_number field for creating an on-us counterparty represents the Jiko network address of the pocket.

The request body must conform to one of the request schemas. On success, it returns the newly created counterparty object.

## Get Counterparty

 - [GET /api/v2/counterparties/{counterparty_id}/](https://docs.jiko.io/products/customer-api/reference/counterparties/get-counterparty-v2.md): This endpoint retrieves the details of a specific counterparty by its unique ID. It returns a single counterparty object corresponding to the provided counterparty_id.

## Update Counterparty

 - [PATCH /api/v2/counterparties/{counterparty_id}/](https://docs.jiko.io/products/customer-api/reference/counterparties/update-counterparty-v2.md): This endpoint is used to update the status of a counterparty. For example, you can use it to unlink a counterparty that is no longer needed.

The request body takes an UpdateCounterpartyRequest object. On success, it returns the updated counterparty object.