# 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"
# 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"
# 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"
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"PrimeVault","description":"A stablecoin-native global money movement platform that helps fintechs, PSPs and global corporations move money across their corridors better, faster and cheaper.","colors":{"primary":"#552225","light":"#C29C58","dark":"#552225"},"logo":{"light":"https://mintcdn.com/prime-vault/IA3LwxdwplQ2w-t1/images/primevault-maroon(1).svg?fit=max\u0026auto=format\u0026n=IA3LwxdwplQ2w-t1\u0026q=85\u0026s=b292e78038d8c39788a4b2fa0c31ff8e","dark":"https://mintcdn.com/prime-vault/IA3LwxdwplQ2w-t1/images/primevault-white(1).svg?fit=max\u0026auto=format\u0026n=IA3LwxdwplQ2w-t1\u0026q=85\u0026s=935bf5f31a64df6f5d9fed108e9fba67"},"favicon":{"light":"https://mintcdn.com/prime-vault/fD82yjQAdhu8u2sR/images/favicon.svg?fit=max\u0026auto=format\u0026n=fD82yjQAdhu8u2sR\u0026q=85\u0026s=bbbbec18adfc91e5b9438f6e22ea2911","dark":"https://mintcdn.com/prime-vault/fD82yjQAdhu8u2sR/images/favicon.svg?fit=max\u0026auto=format\u0026n=fD82yjQAdhu8u2sR\u0026q=85\u0026s=bbbbec18adfc91e5b9438f6e22ea2911"},"navbar":{"links":[{"href":"mailto:contact@primevault.com","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/primevaultHQ","linkedin":"https://www.linkedin.com/company/primevault"}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Product Documentation","href":"https://help.primevault.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"prime-vault","hasAudioNarration":false,"actualSubdomain":"prime-vault","customDomains":["docs.primevault.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-prime-vault-08ed8241","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aeb2fcccc761ce6b05b0715","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Guide","count":47},{"language":"default","tag":"Transactions","count":17},{"language":"default","tag":"Payment Flows","count":11},{"language":"default","tag":"API User Setup","count":8},{"language":"default","tag":"Setting Up an API User","count":8},{"language":"default","tag":"API Basics","count":7},{"language":"default","tag":"Trade","count":7},{"language":"default","tag":"Vaults","count":6},{"language":"default","tag":"Blockchain Contacts","count":5},{"language":"default","tag":"On-chain Operations","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"blockchain-contacts/list-contacts","slug":"/blockchain-contacts/list-contacts","pageMetadata":{"api":"GET https://api.primevault.com/api/external/contacts/","playground":"none","title":"List Contacts","sidebarTitle":"List Contacts","description":"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.","href":"/blockchain-contacts/list-contacts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`GET`}),` `,_jsx(_components.code,{children:`/api/external/contacts/?limit={limit}\u0026cursor={cursor}\u0026{filters}`})]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`number`,id:`param-limit`,children:_jsx(_components.p,{children:`Requested page size. SDK default: 20.`})}),`\n`,_jsx(ParamField,{query:`cursor`,type:`string | null`,id:`param-cursor`,children:_jsx(_components.p,{children:`Cursor for the next page.`})}),`\n`,_jsx(ParamField,{query:`Filters`,type:`Record\u003cstring, string>`,id:`param-filters`,children:_jsxs(_components.p,{children:[`Contact filters, for example `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`status`}),`, or `,_jsx(_components.code,{children:`externalId`}),` when supported.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns a page of `,_jsx(_components.a,{href:`/api-basics/data-models#contact`,children:`Contact`}),` objects. See `,_jsx(_components.a,{href:`/api-basics/filtering-and-pagination#cursor-response`,children:`Cursor response`}),`.`]}),`\n`,_jsxs(ResponseField,{name:`results`,type:`Contact[]`,id:`param-results`,children:[_jsxs(_components.p,{children:[`Contacts on this page. Each item is a `,_jsx(_components.a,{href:`/api-basics/data-models#contact`,children:`Contact`}),`.`]}),_jsxs(Expandable,{title:`Properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Contact ID.`})}),_jsx(ResponseField,{name:`orgId`,type:`string`,id:`param-org-id`,children:_jsx(_components.p,{children:`Organization that owns the contact.`})}),_jsx(ResponseField,{name:`subOrgId`,type:`string`,id:`param-sub-org-id`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/sub-orgs/overview`,children:`Sub-org`}),` that owns the contact, if any.`]})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`Contact display name.`})}),_jsx(ResponseField,{name:`blockChain`,type:`string`,id:`param-block-chain`,children:_jsx(_components.p,{children:`Chain of the address.`})}),_jsx(ResponseField,{name:`address`,type:`string`,id:`param-address`,children:_jsx(_components.p,{children:`Blockchain address.`})}),_jsx(ResponseField,{name:`status`,type:`ContactStatus`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`PENDING`}),`, `,_jsx(_components.code,{children:`APPROVED`}),`, or `,_jsx(_components.code,{children:`DECLINED`}),`. A new contact stays `,_jsx(_components.code,{children:`PENDING`}),` until it’s `,_jsx(_components.a,{href:`/approvals/overview`,children:`approved`}),`. See `,_jsx(_components.a,{href:`/api-basics/data-models#contactstatus`,children:`ContactStatus`}),`.`]})}),_jsx(ResponseField,{name:`isSmartContractAddress`,type:`boolean`,id:`param-is-smart-contract-address`,children:_jsx(_components.p,{children:`Whether the address is a smart contract.`})}),_jsx(ResponseField,{name:`tags`,type:`string[]`,id:`param-tags`,children:_jsx(_components.p,{children:`Searchable contact tags.`})}),_jsx(ResponseField,{name:`createdById`,type:`string`,id:`param-created-by-id`,children:_jsx(_components.p,{children:`User or API user that created the contact.`})}),_jsx(ResponseField,{name:`isSanctioned`,type:`boolean`,id:`param-is-sanctioned`,children:_jsx(_components.p,{children:`Whether the address is flagged by sanctions screening.`})}),_jsx(ResponseField,{name:`externalId`,type:`string`,id:`param-external-id`,children:_jsx(_components.p,{children:`Your own reference, if you set one.`})}),_jsx(ResponseField,{name:`assetList`,type:`string[]`,id:`param-asset-list`,children:_jsx(_components.p,{children:`Assets permitted for the contact.`})}),_jsx(ResponseField,{name:`createdAt`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Creation timestamp (ISO 8601).`})}),_jsx(ResponseField,{name:`updatedAt`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Last update timestamp (ISO 8601).`})}),_jsx(ResponseField,{name:`isDeleted`,type:`boolean`,id:`param-is-deleted`,children:_jsx(_components.p,{children:`Whether the contact is deleted.`})})]})]}),`\n`,_jsx(ResponseField,{name:`nextCursor`,type:`string | null`,id:`param-next-cursor`,children:_jsxs(_components.p,{children:[`Cursor for the next page. `,_jsx(_components.code,{children:`null`}),` on the last page.`]})}),`\n`,_jsx(ResponseField,{name:`hasNext`,type:`boolean`,id:`param-has-next`,children:_jsx(_components.p,{children:`Whether another page exists.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"api":"GET https://api.primevault.com/api/external/contacts/","playground":"none","title":"List Contacts","sidebarTitle":"List Contacts","description":"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.","href":"/blockchain-contacts/list-contacts"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`GET`}),` `,_jsx(_components.code,{children:`/api/external/contacts/?limit={limit}\u0026cursor={cursor}\u0026{filters}`})]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`number`,id:`param-limit`,children:_jsx(_components.p,{children:`Requested page size. SDK default: 20.`})}),`\n`,_jsx(ParamField,{query:`cursor`,type:`string | null`,id:`param-cursor`,children:_jsx(_components.p,{children:`Cursor for the next page.`})}),`\n`,_jsx(ParamField,{query:`Filters`,type:`Record\u003cstring, string>`,id:`param-filters`,children:_jsxs(_components.p,{children:[`Contact filters, for example `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`status`}),`, or `,_jsx(_components.code,{children:`externalId`}),` when supported.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns a page of `,_jsx(_components.a,{href:`/api-basics/data-models#contact`,children:`Contact`}),` objects. See `,_jsx(_components.a,{href:`/api-basics/filtering-and-pagination#cursor-response`,children:`Cursor response`}),`.`]}),`\n`,_jsxs(ResponseField,{name:`results`,type:`Contact[]`,id:`param-results`,children:[_jsxs(_components.p,{children:[`Contacts on this page. Each item is a `,_jsx(_components.a,{href:`/api-basics/data-models#contact`,children:`Contact`}),`.`]}),_jsxs(Expandable,{title:`Properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Contact ID.`})}),_jsx(ResponseField,{name:`orgId`,type:`string`,id:`param-org-id`,children:_jsx(_components.p,{children:`Organization that owns the contact.`})}),_jsx(ResponseField,{name:`subOrgId`,type:`string`,id:`param-sub-org-id`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/sub-orgs/overview`,children:`Sub-org`}),` that owns the contact, if any.`]})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`Contact display name.`})}),_jsx(ResponseField,{name:`blockChain`,type:`string`,id:`param-block-chain`,children:_jsx(_components.p,{children:`Chain of the address.`})}),_jsx(ResponseField,{name:`address`,type:`string`,id:`param-address`,children:_jsx(_components.p,{children:`Blockchain address.`})}),_jsx(ResponseField,{name:`status`,type:`ContactStatus`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`PENDING`}),`, `,_jsx(_components.code,{children:`APPROVED`}),`, or `,_jsx(_components.code,{children:`DECLINED`}),`. A new contact stays `,_jsx(_components.code,{children:`PENDING`}),` until it’s `,_jsx(_components.a,{href:`/approvals/overview`,children:`approved`}),`. See `,_jsx(_components.a,{href:`/api-basics/data-models#contactstatus`,children:`ContactStatus`}),`.`]})}),_jsx(ResponseField,{name:`isSmartContractAddress`,type:`boolean`,id:`param-is-smart-contract-address`,children:_jsx(_components.p,{children:`Whether the address is a smart contract.`})}),_jsx(ResponseField,{name:`tags`,type:`string[]`,id:`param-tags`,children:_jsx(_components.p,{children:`Searchable contact tags.`})}),_jsx(ResponseField,{name:`createdById`,type:`string`,id:`param-created-by-id`,children:_jsx(_components.p,{children:`User or API user that created the contact.`})}),_jsx(ResponseField,{name:`isSanctioned`,type:`boolean`,id:`param-is-sanctioned`,children:_jsx(_components.p,{children:`Whether the address is flagged by sanctions screening.`})}),_jsx(ResponseField,{name:`externalId`,type:`string`,id:`param-external-id`,children:_jsx(_components.p,{children:`Your own reference, if you set one.`})}),_jsx(ResponseField,{name:`assetList`,type:`string[]`,id:`param-asset-list`,children:_jsx(_components.p,{children:`Assets permitted for the contact.`})}),_jsx(ResponseField,{name:`createdAt`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Creation timestamp (ISO 8601).`})}),_jsx(ResponseField,{name:`updatedAt`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Last update timestamp (ISO 8601).`})}),_jsx(ResponseField,{name:`isDeleted`,type:`boolean`,id:`param-is-deleted`,children:_jsx(_components.p,{children:`Whether the contact is deleted.`})})]})]}),`\n`,_jsx(ResponseField,{name:`nextCursor`,type:`string | null`,id:`param-next-cursor`,children:_jsxs(_components.p,{children:[`Cursor for the next page. `,_jsx(_components.code,{children:`null`}),` on the last page.`]})}),`\n`,_jsx(ResponseField,{name:`hasNext`,type:`boolean`,id:`param-has-next`,children:_jsx(_components.p,{children:`Whether another page exists.`})}),`\n`,_jsxs(RequestExample,{dropdown:true,children:[_jsx(CodeBlock,{filename:`Request example`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"query\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cursor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PENDING\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Sample only. Generate a new signed token for each request`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# (see Authentication). Tokens expire after 120 seconds.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --request GET \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --url `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.primevault.com/api/external/contacts/?limit=20\u0026status=PENDING\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer \u003csigned JWT>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Api-Key: \u003cAPI key>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Accept: application/json\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript SDK`,numberOfLines:`11`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`getContacts(`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` params?: Record\u003cstring, string>,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` limit?: number,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` cursor?: string | `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`): Promise\u003cContactListResponse>`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` firstPage = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` apiClient.getContacts(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { status: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PENDING\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 20,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{dropdown:true,children:[_jsx(CodeBlock,{filename:`Response example`,numberOfLines:`28`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`28`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"contact_123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"orgId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"org_456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subOrgId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sub_org_123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Operations Wallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"blockChain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ETHEREUM\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0xAbC1234567890abcdef1234567890abcdef1234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PENDING\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"vendor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"priority\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdById\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api_user_123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"externalId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vendor-1001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assetList\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"USDC\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ETH\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-04T10:30:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-04T10:30:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isDeleted\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nextCursor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eyJpZCI6ImNvbnRhY3RfMTIzIn0=\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"hasNext\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript SDK`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`interface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ContactListResponse {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` results: Contact[];`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` nextCursor?: string | `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` hasNext?: boolean;`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"api":"GET https://api.primevault.com/api/external/contacts/","playground":"none","title":"List Contacts","sidebarTitle":"List Contacts","description":"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.","href":"/blockchain-contacts/list-contacts"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Query parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"Request example","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"query\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"limit\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">20\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cursor\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PENDING\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\"># Sample only. Generate a new signed token for each request\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\"># (see Authentication). Tokens expire after 120 seconds.\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --request GET \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --url \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.primevault.com/api/external/contacts/?limit=20\u0026#x26;status=PENDING\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authorization: Bearer \u0026#x3C;signed JWT>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Api-Key: \u0026#x3C;API key>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Accept: application/json\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript SDK","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"typescript\">\u003ccode language=\"typescript\" numberOfLines=\"11\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">getContacts(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> params?: Record\u0026#x3C;string, string>,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> limit?: number,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> cursor?: string | \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">): Promise\u0026#x3C;ContactListResponse>\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> firstPage = \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> apiClient.getContacts(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { status: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PENDING\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> 20,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[{"type":"mdxJsxAttribute","name":"dropdown","value":"\"\""}]},"response":{"type":"ResponseExample","children":[{"filename":"Response example","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"28\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"results\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"contact_123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"orgId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"org_456\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"subOrgId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sub_org_123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Operations Wallet\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"blockChain\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ETHEREUM\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"address\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0xAbC1234567890abcdef1234567890abcdef1234\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PENDING\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tags\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"vendor\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"priority\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdById\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"api_user_123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"externalId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"vendor-1001\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"assetList\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"USDC\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"ETH\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-04T10:30:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updatedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-08-04T10:30:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isDeleted\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"nextCursor\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"eyJpZCI6ImNvbnRhY3RfMTIzIn0=\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"hasNext\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript SDK","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"typescript\">\u003ccode language=\"typescript\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">interface\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ContactListResponse {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> results: Contact[];\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> nextCursor?: string | \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> hasNext?: boolean;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[{"type":"mdxJsxAttribute","name":"dropdown","value":"\"\""}]}},"endpoint":{"title":"List Contacts","path":"/api/external/contacts/","servers":[{"url":"https://api.primevault.com"}],"method":"get","request":{"security":[],"parameters":{"query":{"limit":{"schema":[{"type":"number","description":"Requested page size. SDK default: 20."}]},"cursor":{"schema":[{"type":"object","properties":{},"description":"Cursor for the next page."}]},"Filters":{"schema":[{"type":"object","properties":{},"description":"Contact filters, for example `name` , `status` , or `externalId` when supported."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"results":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"string","description":"Contact ID."}],"orgId":[{"type":"string","description":"Organization that owns the contact."}],"subOrgId":[{"type":"string","description":"Sub-org that owns the contact, if any."}],"name":[{"type":"string","description":"Contact display name."}],"blockChain":[{"type":"string","description":"Chain of the address."}],"address":[{"type":"string","description":"Blockchain address."}],"status":[{"type":"object","properties":{},"description":"`PENDING` , `APPROVED` , or `DECLINED` . A new contact stays `PENDING` until it’s approved . See ContactStatus ."}],"isSmartContractAddress":[{"type":"boolean","description":"Whether the address is a smart contract."}],"tags":[{"type":"array","items":[{"type":"string"}],"description":"Searchable contact tags."}],"createdById":[{"type":"string","description":"User or API user that created the contact."}],"isSanctioned":[{"type":"boolean","description":"Whether the address is flagged by sanctions screening."}],"externalId":[{"type":"string","description":"Your own reference, if you set one."}],"assetList":[{"type":"array","items":[{"type":"string"}],"description":"Assets permitted for the contact."}],"createdAt":[{"type":"string","description":"Creation timestamp (ISO 8601)."}],"updatedAt":[{"type":"string","description":"Last update timestamp (ISO 8601)."}],"isDeleted":[{"type":"boolean","description":"Whether the contact is deleted."}]}}],"description":"Contacts on this page. Each item is a Contact ."}],"nextCursor":[{"type":"object","properties":{},"description":"Cursor for the next page. `null` on the last page."}],"hasNext":[{"type":"boolean","description":"Whether another page exists."}]}}],"examples":{"example":{"value":{"results":[{"id":"\u003cstring>","orgId":"\u003cstring>","subOrgId":"\u003cstring>","name":"\u003cstring>","blockChain":"\u003cstring>","address":"\u003cstring>","status":{},"isSmartContractAddress":true,"tags":["\u003cstring>"],"createdById":"\u003cstring>","isSanctioned":true,"externalId":"\u003cstring>","assetList":["\u003cstring>"],"createdAt":"\u003cstring>","updatedAt":"\u003cstring>","isDeleted":true}],"nextCursor":{},"hasNext":true}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"prime-vault","siteName":"PrimeVault","title":"List Contacts - PrimeVault","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T07:38:33.502Z","originalFileLocation":"blockchain-contacts/list-contacts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PrimeVault\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Contacts - PrimeVault\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PrimeVault\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.primevault.com/blockchain-contacts/list-contacts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://prime-vault.mintlify.site/_mintlify/api/og/v2?division=Blockchain+Contacts\u0026amp;title=List+Contacts\u0026amp;description=Retrieve+a+paginated+list+of+contacts%2C+optionally+filtered+by+name%2C+status%2C+or+external+ID.\u0026amp;theme=70011a51ae140d4af5721305\u0026amp;signature=70173a482aa6fde20fcf39ce642be37fb7863a5d544b0514686ac9bf6d174b37\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Contacts - PrimeVault\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://prime-vault.mintlify.site/_mintlify/api/og/v2?division=Blockchain+Contacts\u0026amp;title=List+Contacts\u0026amp;description=Retrieve+a+paginated+list+of+contacts%2C+optionally+filtered+by+name%2C+status%2C+or+external+ID.\u0026amp;theme=70011a51ae140d4af5721305\u0026amp;signature=70173a482aa6fde20fcf39ce642be37fb7863a5d544b0514686ac9bf6d174b37\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/prime-vault/N5YPU8PmR3BcoWiL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PrimeVault\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#552225\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.primevault.com/blockchain-contacts/list-contacts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/blockchain-contacts/list-contacts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.primevault.com/#organization\",\"name\":\"PrimeVault\",\"url\":\"https://docs.primevault.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/prime-vault/IA3LwxdwplQ2w-t1/images/primevault-maroon(1).svg?fit=max\u0026auto=format\u0026n=IA3LwxdwplQ2w-t1\u0026q=85\u0026s=b292e78038d8c39788a4b2fa0c31ff8e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.primevault.com#website\",\"name\":\"PrimeVault\",\"url\":\"https://docs.primevault.com\",\"publisher\":{\"@id\":\"https://docs.primevault.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.primevault.com/blockchain-contacts/list-contacts#webpage\",\"url\":\"https://docs.primevault.com/blockchain-contacts/list-contacts\",\"name\":\"List Contacts\",\"description\":\"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\",\"dateModified\":\"2026-10-08T07:38:33.502Z\",\"isPartOf\":{\"@id\":\"https://docs.primevault.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.primevault.com/blockchain-contacts/list-contacts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.primevault.com/blockchain-contacts/list-contacts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blockchain Contacts\",\"item\":\"https://docs.primevault.com/blockchain-contacts/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Contacts\",\"item\":\"https://docs.primevault.com/blockchain-contacts/list-contacts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.primevault.com/blockchain-contacts/list-contacts#apireference\",\"headline\":\"List Contacts\",\"name\":\"List Contacts\",\"description\":\"Retrieve a paginated list of contacts, optionally filtered by name, status, or external ID.\",\"url\":\"https://docs.primevault.com/blockchain-contacts/list-contacts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.primevault.com/blockchain-contacts/list-contacts#webpage\"},\"dateModified\":\"2026-10-08T07:38:33.502Z\",\"publisher\":{\"@id\":\"https://docs.primevault.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.primevault.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PrimeVault\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"PrimeVault\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/blockchain-contacts/list-contacts.md","siteName":"PrimeVault","nav":{"global":{"anchors":[{"anchor":"Product Documentation","href":"https://help.primevault.com/"}]},"tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":""}]},{"tab":"Payment Flows","icon":"money-bill-transfer","pages":[{"title":"Payment Flows","href":"/payment-flows/overview"}]},{"tab":"API User Setup","icon":"user-gear","pages":[{"title":"API User Setup","href":"/api-user-setup/setting-up-api-user"}]},{"tab":"API Guide","icon":"code","groups":[{"group":"API Basics","pages":[{"title":"API Fundamentals","sidebarTitle":"API Fundamentals","href":"/api-basics/api-fundamentals"},{"title":"Authentication","href":"/api-basics/authentication"},{"title":"Status Codes","href":"/api-basics/status-codes"},{"title":"Custom Error Codes","href":"/api-basics/custom-error-codes"},{"title":"Filtering and Pagination","href":"/api-basics/filtering-and-pagination"},{"title":"Webhooks","sidebarTitle":"Webhooks","href":"/api-basics/webhooks"},{"title":"Data Models","href":"/api-basics/data-models"}]},{"group":"Approvals","pages":[{"title":"Approvals","sidebarTitle":"Overview","href":"/approvals/overview"},{"title":"Get an Approval Message","sidebarTitle":"Get Approval Message","api":"GET https://api.primevault.com/api/external/change_requests/approvals/approval_message/","playground":"none","href":"/approvals/get-approval-message"},{"title":"Submit an Approval Action","sidebarTitle":"Submit Approval Action","api":"POST https://api.primevault.com/api/external/change_requests/approvals/{approvalId}/action/","playground":"none","href":"/approvals/submit-approval-action"}]},{"group":"Vaults","pages":[{"title":"Vaults","sidebarTitle":"Overview","href":"/vaults/overview"},{"api":"GET https://api.primevault.com/api/external/vaults/","playground":"none","title":"List Vaults","sidebarTitle":"List Vaults","href":"/vaults/list-vaults"},{"api":"GET https://api.primevault.com/api/external/vaults/{vaultId}/","playground":"none","title":"Retrieve a Vault","sidebarTitle":"Retrieve a Vault","href":"/vaults/retrieve-vault"},{"api":"POST https://api.primevault.com/api/external/vaults/","playground":"none","title":"Create a Vault","sidebarTitle":"Create a Vault","href":"/vaults/create-vault"},{"api":"GET https://api.primevault.com/api/external/vaults/{vaultId}/detailed_balances/","playground":"none","title":"Get Vault Balances","sidebarTitle":"Balances","href":"/vaults/vault-balances"},{"api":"GET https://api.primevault.com/api/external/vaults/{vaultId}/deposit_instructions/","playground":"none","title":"Get Vault Deposit Instructions","sidebarTitle":"Deposit Instructions","href":"/vaults/vault-deposit-instructions"}]},{"group":"Blockchain Contacts","pages":[{"title":"Blockchain Contacts","sidebarTitle":"Overview","description":"Save external blockchain addresses as contacts, get them approved, and use them as destinations for transfers and payouts from your vaults.","href":"/blockchain-contacts/overview"},{"api":"GET https://api.primevault.com/api/external/contacts/","playground":"none","title":"List Contacts","sidebarTitle":"List Contacts","href":"/blockchain-contacts/list-contacts"},{"api":"GET https://api.primevault.com/api/external/contacts/{contactId}/","playground":"none","title":"Retrieve a Contact","sidebarTitle":"Retrieve a Contact","description":"Retrieve a single contact by ID, including its blockchain, address, status, tags, and assets.","href":"/blockchain-contacts/retrieve-contact"},{"api":"POST https://api.primevault.com/api/external/contacts/","playground":"none","title":"Create a Contact","sidebarTitle":"Create a Contact","href":"/blockchain-contacts/create-contact"},{"api":"PUT https://api.primevault.com/api/external/contacts/{contactId}/","playground":"none","title":"Update a Contact","sidebarTitle":"Update a Contact","href":"/blockchain-contacts/update-contact"}]},{"group":"Bank Accounts","pages":[{"api":"GET https://api.primevault.com/api/external/bank_accounts/","playground":"none","title":"List Bank Accounts","sidebarTitle":"List Bank Accounts","href":"/bank-accounts/list-bank-accounts"},{"api":"GET https://api.primevault.com/api/external/bank_accounts/{bankAccountId}/","playground":"none","title":"Retrieve a Bank Account","sidebarTitle":"Retrieve Bank Account","href":"/bank-accounts/retrieve-bank-account"},{"api":"POST https://api.primevault.com/api/external/bank_accounts/","playground":"none","title":"Create a Bank Account","sidebarTitle":"Create Bank Account","href":"/bank-accounts/create-bank-account"}]},{"group":"Assets and Chains","pages":[{"title":"Assets and Chains","sidebarTitle":"Overview","href":"/assets-and-chains/overview"},{"api":"GET https://api.primevault.com/api/external/assets/","playground":"none","title":"List Assets","sidebarTitle":"List Assets","href":"/assets-and-chains/list-assets"},{"api":"GET https://api.primevault.com/api/external/assets/supported_chains/","playground":"none","title":"List Supported Chains","sidebarTitle":"List Supported Chains","href":"/assets-and-chains/list-supported-chains"}]},{"group":"Sub-Orgs","pages":[{"title":"Sub-Orgs","sidebarTitle":"Overview","href":"/sub-orgs/overview"},{"api":"POST https://api.primevault.com/api/external/sub_orgs/","playground":"none","title":"Create a Sub-Org","sidebarTitle":"Create Sub-Org","href":"/sub-orgs/create-sub-org"},{"api":"GET https://api.primevault.com/api/external/sub_orgs/","playground":"none","title":"List Sub-Orgs","sidebarTitle":"List Sub-Orgs","href":"/sub-orgs/list-sub-orgs"}]},{"group":"Transactions","pages":[{"title":"Transactions","sidebarTitle":"Overview","href":"/transactions/overview"},{"title":"List Transactions","sidebarTitle":"List Transactions","api":"GET https://api.primevault.com/api/external/transactions/","playground":"none","href":"/transactions/list-transactions"},{"api":"GET https://api.primevault.com/api/external/transactions/{transactionId}/","playground":"none","title":"Retrieve a Transaction","sidebarTitle":"Retrieve Transaction","href":"/transactions/retrieve-transaction"},{"group":"Ramps","pages":[{"title":"Ramps","sidebarTitle":"Overview","href":"/transactions/ramps"},{"api":"POST https://api.primevault.com/api/external/transactions/v2/quote/","playground":"none","title":"Get a Ramp Quote","sidebarTitle":"Get Quote","href":"/transactions/ramps/get-quote"},{"api":"POST https://api.primevault.com/api/external/transactions/intent/create/","playground":"none","title":"Execute a Ramp Quote","sidebarTitle":"Execute Quote","href":"/transactions/ramps/execute-quote"}]},{"group":"FX","pages":[{"title":"FX","sidebarTitle":"Overview","href":"/transactions/fx"},{"api":"POST https://api.primevault.com/api/external/transactions/v2/quote/","playground":"none","title":"Get an FX Quote","sidebarTitle":"Get Quote","href":"/transactions/fx/get-quote"},{"api":"POST https://api.primevault.com/api/external/transactions/intent/create/","playground":"none","title":"Execute an FX Quote","sidebarTitle":"Execute Quote","href":"/transactions/fx/execute-quote"}]},{"group":"Trade","pages":[{"title":"Trade","sidebarTitle":"Overview","href":"/transactions/trade"},{"api":"POST https://api.primevault.com/api/external/transactions/v2/quote/","playground":"none","title":"Get a Trade Quote","sidebarTitle":"Get Quote","href":"/transactions/trade/get-quote"},{"api":"POST https://api.primevault.com/api/external/transactions/intent/create/","playground":"none","title":"Execute a Trade Quote","sidebarTitle":"Execute Quote","href":"/transactions/trade/execute-quote"}]},{"group":"On-chain Operations","pages":[{"api":"POST https://api.primevault.com/api/external/transactions/","playground":"none","title":"Create a Transfer","sidebarTitle":"Create Transfer","href":"/transactions/on-chain-operations/create-transfer"},{"api":"POST https://api.primevault.com/api/external/transactions/","playground":"none","title":"Create a Contract Call","sidebarTitle":"Create Contract Call","href":"/transactions/on-chain-operations/create-contract-call"},{"api":"POST https://api.primevault.com/api/external/transactions/","playground":"none","title":"Stake a Resource","sidebarTitle":"Stake Resource","href":"/transactions/on-chain-operations/stake-resource"},{"api":"POST https://api.primevault.com/api/external/transactions/","playground":"none","title":"Delegate a TRON Resource","sidebarTitle":"Delegate Resource","href":"/transactions/on-chain-operations/delegate-resource"},{"api":"POST https://api.primevault.com/api/external/transactions/replace_transaction/","playground":"none","title":"Replace a Transaction","sidebarTitle":"Replace Transaction","href":"/transactions/on-chain-operations/replace-transaction"}]}]}]}]},"basePath":"","title":"List Contacts - PrimeVault","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}