Skip to main content
POST
/
counterparty-lookups
Validates and retrieves counterparty information for the authenticated user or entity.
curl --request POST \
  --url https://api.nuvion.tech/counterparty-lookups \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_number": "1234567890",
  "issuer": {
    "code": "CHASE"
  },
  "country": "US",
  "currency": "USD"
}
'
{
  "message": "Account retrieved successfully",
  "status": 200,
  "data": {
    "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F7",
    "account_holder_name": "John Doe",
    "account_number": "1234567890",
    "issuer": {
      "code": "CHASE",
      "name": "JPMorgan Chase Bank",
      "short_name": "Chase"
    },
    "routing_number": "021000021",
    "account_type": "checking",
    "country": "US",
    "status": "active",
    "lookup_type": "bank_account",
    "created_at": "2025-09-12T09:15:00.000Z"
  }
}

Headers

​
Authorization
string
required

Authorization header: Bearer {jwt or Secretkey}

Example:

"Bearer {jwt or Secretkey}"

Body

application/json
​
account_number
string
required

The account number to look up

​
issuer
object
required

Information about the bank or financial institution

​
country
string

The country where the account is located

​
currency
string

The currency of the account

Response

Created successfully

​
message
string
required

A descriptive message indicating the result of the operation

​
status
string
required

The status of the API operation (successful, error, failed, pending)

​
data
object
required

Contains the counterparty account details