Skip to main content
GET
/
counterparty-lookups
/
{id}
Retrieves specific counterparty lookup information for the authenticated user or entity.
curl --request GET \
  --url https://api.nuvion.tech/counterparty-lookups/{id} \
  --header 'Authorization: <authorization>'
{
  "message": "Counterparty lookup retrieved successfully",
  "status": 200,
  "data": {
    "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
    "lookup_type": "bank_account",
    "status": "completed",
    "result": {
      "account_holder_name": "John Doe",
      "account_number": "1234567890",
      "routing_number": "021000021",
      "bank_name": "JPMorgan Chase Bank",
      "bank_code": "CHASE",
      "account_type": "checking",
      "country": "US",
      "status": "active"
    },
    "created_at": "2025-09-11T14:30:00.000Z",
    "updated_at": "2025-09-11T14:32:00.000Z",
    "meta": {
      "verification_method": "instant",
      "verification_source": "plaid"
    }
  }
}

Headers

​
Authorization
string
required

Authorization header: Bearer {jwt or Secretkey}

Example:

"Bearer {jwt or Secretkey}"

Path Parameters

​
id
string
required

The unique identifier (ULID) of the counterparty lookup to retrieve

Response

Successful operation

​
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 lookup details