List Blockchain Contacts

{
"query": {
  "limit": 20,
  "cursor": null,
  "status": "PENDING"
}
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request GET \
  --url "https://api.primevault.com/api/external/contacts/?limit=20&status=PENDING" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Accept: application/json"

getContacts(
  params?: Record<string, string>,
  limit?: number,
  cursor?: string | null,
): Promise<ContactListResponse>

const firstPage = await apiClient.getContacts(
  { status: "PENDING" },
  20,
  null,
);

{
  "results": [
    {
      "id": "contact_123",
      "orgId": "org_456",
      "subOrgId": "sub_org_123",
      "name": "Operations Wallet",
      "blockChain": "ETHEREUM",
      "address": "0xAbC1234567890abcdef1234567890abcdef1234",
      "status": "PENDING",
      "tags": [
        "vendor",
        "priority"
      ],
      "createdById": "api_user_123",
      "externalId": "vendor-1001",
      "assetList": [
        "USDC",
        "ETH"
      ],
      "createdAt": "2026-08-04T10:30:00Z",
      "updatedAt": "2026-08-04T10:30:00Z",
      "isDeleted": false
    }
  ],
  "nextCursor": "eyJpZCI6ImNvbnRhY3RfMTIzIn0=",
  "hasNext": true
}

interface ContactListResponse {
  results: Contact[];
  nextCursor?: string | null;
  hasNext?: boolean;
}