Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.
.svg?fit=max&auto=format&n=IA3LwxdwplQ2w-t1&q=85&s=b292e78038d8c39788a4b2fa0c31ff8e)
.svg?fit=max&auto=format&n=IA3LwxdwplQ2w-t1&q=85&s=935bf5f31a64df6f5d9fed108e9fba67)
/api/external/contacts/?limit={limit}&cursor={cursor}&{filters}
name, status, or externalId when supported.interface ContactListResponse {
results: Contact[];
nextCursor?: string | null;
hasNext?: boolean;
}
const firstPage = await apiClient.getContacts(
{ status: "PENDING" },
20,
null,
);
{
"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>
{
"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
}
{
"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>
{
"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
}