# Get Counterparty

Endpoint: GET /api/v2/customers/{customer_id}/counterparties/{counterparty_id}/
Version: Version: 970cd0fc
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer

## Path parameters:

  - `customer_id` (string, required)

  - `counterparty_id` (string, required)

## Header parameters:

  - `x-jiko-idempotency` (string, required)
    A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

  - `x-jiko-signature` (string, required)
    Base64-encoded HMAC-SHA256 hash of `x-jiko-idempotency + request pathname + body`, keyed with your shared secret. See [Authentication](/products/partner-api/guides/building/auth) for the full algorithm and a code sample.

## Response 200:

  - `200` (unknown)
    Successful Response

## 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.wire_id` (string, required)

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

  - `verification.verification_failure_count` (integer, required)

  - `verification.account_number_masked` (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"

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

  - `422` (unknown)
    Validation Error

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