Skip to main content
POST
Retrieve a counterparty

Authorizations

X-Ivy-Api-Key
string
header
required

API key for authentication

Body

application/json
id
string<uuid>
required

The counterparty id

Response

200 - application/json

The counterparty

id
string
required

The counterparty id

name
string | null
required

The counterparty name

entityType
enum<string>
required

Whether the counterparty is a business or an individual

Available options:
business,
individual
isSelfOwned
boolean
required

Whether the counterparty is owned by the merchant

blocked
boolean
required

Whether payments to and from the counterparty are blocked

financialAddress
object
required

The counterparty financial address

physicalAddress
object | null
required

A structured physical postal address.

dateOfBirth
string | null
required

The counterparty date of birth as YYYY-MM-DD

metadata
object
required

The counterparty metadata

createdAt
any
required

When the counterparty was created

updatedAt
any
required

When the counterparty was last updated