# Counterparties

Use these endpoints to view Counterparties. Counterparties represent external accounts when moving funds in or out of a Jiko Account. Jiko will only transfer funds between accounts where the Counterparty has `status: “VERIFIED”`, meaning ownership of the account has been confirmed.

## 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.

Each Counterparty object includes an optional display_name — a custom, human-friendly label that, when set, can be shown in place of the counterparty's default name to distinguish counterparties that belong to the same legal entity.

## 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.

Note: The optional display_name field lets you assign a custom, human-friendly name to a counterparty — useful for
distinguishing multiple counterparties that belong to the same legal entity. When set, it is returned on the counterparty
and can be shown in place of the counterparty's default name.

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 a counterparty. For example, you can use it to unlink a counterparty that is no longer needed, or to set or change its display_name.

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