# Get Counterparty

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

Endpoint: GET /api/v2/counterparties/{counterparty_id}/
Version: Version: cf52545e
Security: CodeBearer

## Path parameters:

  - `counterparty_id` (string, required)

## Response 200 fields (application/json):

  - `id` (string, required)

  - `time_created` (string, required)

  - `status` (string, required)
    Enum: "PENDING", "FAILED", "LINKED", "UNLINKED", "CLOSED"

  - `verification` (any, required)

  - `verification.id` (string, required)

  - `verification.description` (any, required)

  - `verification.type` (string, required)

  - `verification.supporting_documents` (array, required)

  - `verification.supporting_documents.id` (string, required)

  - `verification.supporting_documents.document_id` (string, required)

  - `verification.supporting_documents.status` (string, required)
    Enum: "PENDING_REVIEW", "APPROVED", "REJECTED"

  - `verification.status` (string, required)
    Enum: "PENDING_REVIEW", "APPROVED", "REJECTED"

  - `verification.wire_id` (string, required)

  - `verification.account_number_masked` (string, required)

  - `verification.verification_failure_count` (integer, required)

  - `display_name` (any)
    An optional custom display name for the counterparty, useful for distinguishing multiple counterparties that share the same legal name.

  - `type` (string, required)

  - `counterparty_name` (string, required)

  - `institution_name` (any, required)

  - `routing_number` (any, required)

  - `account_number` (any, required)

  - `account_type` (string, required)
    Enum: "CHECKING", "SAVINGS"

  - `object_type` (string, required)

  - `address` (object, required)

  - `address.street_address` (string, required)
    Street address

  - `address.street_address2` (any)
    Apartment, Suite, Box number, etc.

  - `address.city` (string, required)
    City / Town

  - `address.postal_code` (string, required)
    Postal code / ZIP code

  - `address.state` (string, required)
    State (Postal Abbreviations. Example: "AL", "NJ", "OH")

  - `address.country` (string, required)
    A ISO-3166 Alpha-2 country code (Abbreviated. Example: "US")

  - `identifier` (string, required)

  - `identifier_code` (string, required)
    Enum: "SWIFT_BIC", "CHIPS_PARTICIPANT", "DIRECT_DEPOSIT_ACCOUNT", "FED_ROUTING_NUMBER", "SWIFT_ID_AND_ACCOUNT_NUMBER", "CHIPS_IDENTIFIER", "PASSPORT_NUMBER", "TAX_IDENTIFICATION_NUMBER", "DRIVERS_LICENSE_NUMBER", "ALIEN_REGISTRATION_NUMBER", "CORPORATE_IDENTIFICATION", "OTHER_IDENTIFICATION"

  - `wire_instructions` (any)
    Any additional wire instructions required for the wire to be processed correctly.

  - `ownership_type` (any)
    Relationship of the counterparty to the account holder. FIRST_PARTY means the counterparty is owned by the account holder, THIRD_PARTY means it is owned by a different entity.

  - `account_number` (string, required)
    Represents the Jiko network address of the pocket.

  - `swift_bic` (string, required)

  - `identifier_type` (string)
    Enum: "iban", "local"

  - `bank_name` (string, required)

  - `wallet_address` (string, required)

  - `chain` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)

