{
"type": "resource_not_found",
"code": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}
{
"type": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}
Verified Identities
Look up an individual by pairwise reference
Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.
GET
/
issuance
/
identities
/
individuals
/
{individual_ref}
Look up an individual by pairwise reference
curl --request GET \ --url https://api.baselayer.com/issuance/identities/individuals/{individual_ref} \ --header 'X-API-Key: <api-key>'
{
"type": "resource_not_found",
"code": 1,
"message": "Could not locate the resource for the given URI.",
"metadata": {}
}
{
"type": "validation_failed",
"code": 7112,
"message": "The request is invalid.",
"metadata": {}
}
Authorizations
X-API-Key
string
header
required
Path Parameters
individual_ref
string
required
Response
Response
Body for GET /issuance/identities/individuals/{individual_ref}.
Strictly scoped to the calling organization: only links it covered with
its own sessions are counted, and no PII beyond what the organization
itself submitted is echoed — display_name repeats the verified name
the list row already returns to the same caller, nothing more.
individual_ref
string
required
The queried pairwise individual reference.
created_at
string<date-time>
required
When your organization first held a reference to the individual.
operator_link_count
integer
required
Businesses your organization holds an operator link to the individual for, in any status: the rows GET /issuance/identities/operator_links?individual_ref=… lists.
submission_count
integer
required
This organization's approved verifications of the individual: the rows of GET /issuance/identities/individuals/{individual_ref}/submissions.
credential_counts
CredentialSummaryResponse (v1) · object
required
This organization's agent credentials for the individual, counting business credentials they acted for; the rows are GET /issuance/credentials?individual_ref=….
Show child attributes
record_count
integer
required
This organization's accepted records of the individual, the current one included: the rows of GET /issuance/identities/individuals/{individual_ref}/records.
display_name
string | null
The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.
reference_id
string | null
Your reference_id for the individual, on the reference they are listed under; null when you never sent one. A push or a PATCH answers the reference_id it wrote under.
updated_at
string<date-time> | null
When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.
active_keys
RecordedActiveKeys · object
Each individual verification check the identity currently holds (e.g. phone_possession, ssn_identity_match), from the token-exchange profile's key vocabulary, with its basis (verified when Baselayer ran the check, attested when a customer vouched for it) and time (the UTC day, a NumericDate). A key an earlier verification proved stays held while the latest one carries the same values (the same phone for phone_possession).
Show child attributes
available_disclosure_paths
string[]
The subject-relative credential disclosure paths a mint from the current verification can disclose: a held key proves each and a value is on file, hash leaves included (e.g. hashes.ssn). Paths only, never values. Empty when this organization holds no current verification.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Baselayer","colors":{"primary":"#384ce3","light":"#c6dbf6","dark":"#2232b5"},"logo":{"light":"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a","dark":"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a","href":"https://www.baselayer.com"},"favicon":"https://mintcdn.com/baselayer-81245324/y8jjNyo-CIhfj2Df/favicon.ico?fit=max\u0026auto=format\u0026n=y8jjNyo-CIhfj2Df\u0026q=85\u0026s=5f1029f95d2abd5d4ffd1699330f82ff","navbar":{"links":[{"href":"https://console.baselayer.com","label":"Console"}]},"fonts":{"heading":{"family":"Season Mix","source":"fonts/SeasonMix-Variable.woff2","format":"woff2"},"body":{"family":"Uncut Sans","source":"fonts/UncutSans-Variable.woff2","format":"woff2"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"baselayer-81245324","hasAudioNarration":false,"actualSubdomain":"baselayer-81245324","customDomains":["docs.baselayer.com"],"gitSource":{"type":"github","owner":"osiris-ratings","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0060ca6c736afc6845e54b","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":286},{"language":"default","tag":"Changelog","count":172},{"language":"default","tag":"Businesses","count":133},{"language":"default","tag":"Webhooks","count":81},{"language":"default","tag":"Know Your Agent","count":75},{"language":"default","tag":"Webhook Events","count":68},{"language":"default","tag":"PRODUCT GUIDES","count":65},{"language":"default","tag":"Verify Businesses \u0026 People","count":60},{"language":"default","tag":"Business Verification","count":49},{"language":"default","tag":"Portfolio Monitoring","count":48}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #navbar{background:#384ce3!important}html:not(.dark) #navbar div,html:not(.dark) #navbar nav{background-color:transparent!important;backdrop-filter:none!important}html:not(.dark) #navbar *{border-color:rgba(255, 255, 255, 0.18)!important}html:not(.dark) #navbar a,html:not(.dark) #navbar span,html:not(.dark) #navbar svg,html:not(.dark) #navbar button,html:not(.dark) #navbar p,html:not(.dark) #navbar div{color:#fff!important}html:not(.dark) #navbar button{background:rgba(255, 255, 255, 0.12)!important;border-color:rgba(255, 255, 255, 0.25)!important}"}]}
{"page":{"pagePath":"api-reference/identities/look-up-an-individual-by-pairwise-reference","slug":"/api-reference/identities/look-up-an-individual-by-pairwise-reference","pageMetadata":{"title":"Look up an individual by pairwise reference","description":"Returns when your latest record of the individual was accepted, the keys it holds with their `basis` (`verified` or `attested`), and how many credentials, submissions, verifications and operator links they have, for an `individual_ref` issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable `404`s.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals/{individual_ref}","href":"/api-reference/identities/look-up-an-individual-by-pairwise-reference","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns when your latest record of the individual was accepted, the keys it holds with their \", _jsx(_components.code, {\n children: \"basis\"\n }), \" (\", _jsx(_components.code, {\n children: \"verified\"\n }), \" or \", _jsx(_components.code, {\n children: \"attested\"\n }), \"), and how many credentials, submissions, verifications and operator links they have, for an \", _jsx(_components.code, {\n children: \"individual_ref\"\n }), \" issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable \", _jsx(_components.code, {\n children: \"404\"\n }), \"s.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Look up an individual by pairwise reference","description":"Returns when your latest record of the individual was accepted, the keys it holds with their `basis` (`verified` or `attested`), and how many credentials, submissions, verifications and operator links they have, for an `individual_ref` issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable `404`s.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals/{individual_ref}","href":"/api-reference/identities/look-up-an-individual-by-pairwise-reference","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/baselayer-81245324/8f3f8776472b6600/kya-nudge.js"],"openApiReferenceData":{"operation":{"tags":["Identities"],"summary":"Look up an individual by pairwise reference","description":"Returns when your latest record of the individual was accepted, the keys it holds with their `basis` (`verified` or `attested`), and how many credentials, submissions, verifications and operator links they have, for an `individual_ref` issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable `404`s.","operationId":"issuance_identities_individuals_get","security":["9007c892-cf02-43c9-97cb-3052d1f5fe32"],"parameters":["bf644efa-bb7a-4f38-899b-269962bde686"],"responses":{"200":"03c334bd-0964-4d82-886f-2c4b5b3d24ef","404":"0c7b5831-6c4e-4613-9475-b8b51bbe9662","422":"ab854ef2-2dc4-43cb-9d78-65c52d414414"},"method":"get","type":"path","servers":["62382a77-8b01-44a7-a119-eef1372efca3"],"path":"/issuance/identities/individuals/{individual_ref}","baseUrlOptions":["https://api.baselayer.com/"],"title":"Look up an individual by pairwise reference","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bf644efa-bb7a-4f38-899b-269962bde686":{"name":"individual_ref","in":"path","required":true,"schema":{"title":"Individual Ref","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"03c334bd-0964-4d82-886f-2c4b5b3d24ef":{"description":"Response","content":{"application/json":{"schema":{"description":"Body for ``GET /issuance/identities/individuals/{individual_ref}``.\n\nStrictly scoped to the calling organization: only links it covered with\nits own sessions are counted, and no PII beyond what the organization\nitself submitted is echoed — ``display_name`` repeats the verified name\nthe list row already returns to the same caller, nothing more.","properties":{"individual_ref":{"description":"The queried pairwise individual reference.","title":"Individual Ref","type":"string","isRequired":true,"uniqueKey":"individual_ref","typeLabel":"string"},"created_at":{"description":"When your organization first held a reference to the individual.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"operator_link_count":{"description":"Businesses your organization holds an operator link to the individual for, in any status: the rows `GET /issuance/identities/operator_links?individual_ref=…` lists.","title":"Operator Link Count","type":"integer","isRequired":true,"uniqueKey":"operator_link_count","typeLabel":"integer"},"submission_count":{"description":"This organization's approved verifications of the individual: the rows of `GET /issuance/identities/individuals/{individual_ref}/submissions`.","title":"Submission Count","type":"integer","isRequired":true,"uniqueKey":"submission_count","typeLabel":"integer"},"credential_counts":{"description":"This organization's agent credentials for the individual, counting business credentials they acted for; the rows are `GET /issuance/credentials?individual_ref=…`.","properties":{"issued_30d":{"description":"Agent credentials issued in the last 30 days.","title":"Issued 30D","type":"integer","isRequired":true,"uniqueKey":"credential_counts.issued_30d","typeLabel":"integer"},"active":{"description":"Agent credentials neither revoked nor expired.","title":"Active","type":"integer","isRequired":true,"uniqueKey":"credential_counts.active","typeLabel":"integer"},"revoked_30d":{"description":"Agent credentials revoked in the last 30 days.","title":"Revoked 30D","type":"integer","isRequired":true,"uniqueKey":"credential_counts.revoked_30d","typeLabel":"integer"}},"required":["issued_30d","active","revoked_30d"],"title":"CredentialSummaryResponse (v1)","type":"object","isRequired":true,"uniqueKey":"credential_counts","typeLabel":"CredentialSummaryResponse (v1) · object"},"record_count":{"description":"This organization's accepted records of the individual, the current one included: the rows of `GET /issuance/identities/individuals/{individual_ref}/records`.","title":"Record Count","type":"integer","isRequired":true,"uniqueKey":"record_count","typeLabel":"integer"},"display_name":{"oneOf":[{"type":"string","title":"Display Name","description":"The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.","uniqueKey":"display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Display Name","description":"The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.","uniqueKey":"display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"display_name","typeLabel":"string | null"},"reference_id":{"oneOf":[{"type":"string","title":"Reference Id","description":"Your `reference_id` for the individual, on the reference they are listed under; null when you never sent one. A push or a `PATCH` answers the `reference_id` it wrote under.","uniqueKey":"reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reference Id","description":"Your `reference_id` for the individual, on the reference they are listed under; null when you never sent one. A push or a `PATCH` answers the `reference_id` it wrote under.","uniqueKey":"reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_id","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","description":"When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.","format":"date-time","uniqueKey":"updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated At","description":"When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time> | null"},"active_keys":{"additionalProperties":{"additionalProperties":false,"description":"One key's basis and the UTC day it was established.\n\nDirect construction, ``KeyEvidence(...)``, raises ``TypeError``. Build\nevidence through the named constructors ``from_proof``, ``from_record``\nand ``proven_at``. ``model_validate`` is for parsing stored JSON that one\nof them serialized, never for building new evidence. The day is ours,\nnever a customer's own timestamp, so sites cannot correlate on a value a\ncustomer chose.","properties":{"basis":{"description":"Who established a key: Baselayer ran the check, or a customer vouched for it.","enum":["verified","attested"],"title":"KeyBasis","type":"string","isRequired":true,"uniqueKey":"active_keys.additionalProperties.basis","typeLabel":"enum\u003cstring>"},"time":{"title":"Time","type":"integer","isRequired":true,"uniqueKey":"active_keys.additionalProperties.time","typeLabel":"integer"}},"required":["basis","time"],"title":"KeyEvidence","type":"object","uniqueKey":"active_keys.additionalProperties","typeLabel":"KeyEvidence · object"},"description":"Each individual verification check the identity currently holds (e.g. `phone_possession`, `ssn_identity_match`), from the token-exchange profile's key vocabulary, with its `basis` (`verified` when Baselayer ran the check, `attested` when a customer vouched for it) and `time` (the UTC day, a NumericDate). A key an earlier verification proved stays held while the latest one carries the same values (the same phone for `phone_possession`).","maxProperties":9,"title":"RecordedActiveKeys","type":"object","uniqueKey":"active_keys","typeLabel":"RecordedActiveKeys · object"},"available_disclosure_paths":{"description":"The subject-relative credential disclosure paths a mint from the current verification can disclose: a held key proves each and a value is on file, hash leaves included (e.g. `hashes.ssn`). Paths only, never values. Empty when this organization holds no current verification.","items":{"type":"string","uniqueKey":"available_disclosure_paths.items.[INDEX]","typeLabel":"string"},"title":"Available Disclosure Paths","type":"array","uniqueKey":"available_disclosure_paths","typeLabel":"string[]"}},"required":["individual_ref","created_at","operator_link_count","submission_count","credential_counts","record_count"],"title":"IdentityStatusResponse (v1)","type":"object","uniqueKey":"","typeLabel":"IdentityStatusResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"individual_ref":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","operator_link_count":123,"submission_count":123,"credential_counts":{"issued_30d":123,"active":123,"revoked_30d":123},"record_count":123,"display_name":"\u003cstring>","reference_id":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z","active_keys":{},"available_disclosure_paths":["\u003cstring>"]}}},"exampleType":"generated"},"application/vnd.baselayer.v1+json":{"schema":{"description":"Body for ``GET /issuance/identities/individuals/{individual_ref}``.\n\nStrictly scoped to the calling organization: only links it covered with\nits own sessions are counted, and no PII beyond what the organization\nitself submitted is echoed — ``display_name`` repeats the verified name\nthe list row already returns to the same caller, nothing more.","properties":{"individual_ref":{"description":"The queried pairwise individual reference.","title":"Individual Ref","type":"string","isRequired":true,"uniqueKey":"individual_ref","typeLabel":"string"},"created_at":{"description":"When your organization first held a reference to the individual.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"operator_link_count":{"description":"Businesses your organization holds an operator link to the individual for, in any status: the rows `GET /issuance/identities/operator_links?individual_ref=…` lists.","title":"Operator Link Count","type":"integer","isRequired":true,"uniqueKey":"operator_link_count","typeLabel":"integer"},"submission_count":{"description":"This organization's approved verifications of the individual: the rows of `GET /issuance/identities/individuals/{individual_ref}/submissions`.","title":"Submission Count","type":"integer","isRequired":true,"uniqueKey":"submission_count","typeLabel":"integer"},"credential_counts":{"description":"This organization's agent credentials for the individual, counting business credentials they acted for; the rows are `GET /issuance/credentials?individual_ref=…`.","properties":{"issued_30d":{"description":"Agent credentials issued in the last 30 days.","title":"Issued 30D","type":"integer","isRequired":true,"uniqueKey":"credential_counts.issued_30d","typeLabel":"integer"},"active":{"description":"Agent credentials neither revoked nor expired.","title":"Active","type":"integer","isRequired":true,"uniqueKey":"credential_counts.active","typeLabel":"integer"},"revoked_30d":{"description":"Agent credentials revoked in the last 30 days.","title":"Revoked 30D","type":"integer","isRequired":true,"uniqueKey":"credential_counts.revoked_30d","typeLabel":"integer"}},"required":["issued_30d","active","revoked_30d"],"title":"CredentialSummaryResponse (v1)","type":"object","isRequired":true,"uniqueKey":"credential_counts","typeLabel":"CredentialSummaryResponse (v1) · object"},"record_count":{"description":"This organization's accepted records of the individual, the current one included: the rows of `GET /issuance/identities/individuals/{individual_ref}/records`.","title":"Record Count","type":"integer","isRequired":true,"uniqueKey":"record_count","typeLabel":"integer"},"display_name":{"oneOf":[{"type":"string","title":"Display Name","description":"The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.","uniqueKey":"display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Display Name","description":"The name on your organization's latest accepted record of the individual — the same value the list row carries. Null when your organization holds no accepted record of the individual. Mask it in shared surfaces; the API returns what the organization itself submitted.","uniqueKey":"display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"display_name","typeLabel":"string | null"},"reference_id":{"oneOf":[{"type":"string","title":"Reference Id","description":"Your `reference_id` for the individual, on the reference they are listed under; null when you never sent one. A push or a `PATCH` answers the `reference_id` it wrote under.","uniqueKey":"reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reference Id","description":"Your `reference_id` for the individual, on the reference they are listed under; null when you never sent one. A push or a `PATCH` answers the `reference_id` it wrote under.","uniqueKey":"reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference_id","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","description":"When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.","format":"date-time","uniqueKey":"updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated At","description":"When your organization's latest record of the individual was accepted: a verification or a push. Null when it holds none.","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time> | null"},"active_keys":{"additionalProperties":{"additionalProperties":false,"description":"One key's basis and the UTC day it was established.\n\nDirect construction, ``KeyEvidence(...)``, raises ``TypeError``. Build\nevidence through the named constructors ``from_proof``, ``from_record``\nand ``proven_at``. ``model_validate`` is for parsing stored JSON that one\nof them serialized, never for building new evidence. The day is ours,\nnever a customer's own timestamp, so sites cannot correlate on a value a\ncustomer chose.","properties":{"basis":{"description":"Who established a key: Baselayer ran the check, or a customer vouched for it.","enum":["verified","attested"],"title":"KeyBasis","type":"string","isRequired":true,"uniqueKey":"active_keys.additionalProperties.basis","typeLabel":"enum\u003cstring>"},"time":{"title":"Time","type":"integer","isRequired":true,"uniqueKey":"active_keys.additionalProperties.time","typeLabel":"integer"}},"required":["basis","time"],"title":"KeyEvidence","type":"object","uniqueKey":"active_keys.additionalProperties","typeLabel":"KeyEvidence · object"},"description":"Each individual verification check the identity currently holds (e.g. `phone_possession`, `ssn_identity_match`), from the token-exchange profile's key vocabulary, with its `basis` (`verified` when Baselayer ran the check, `attested` when a customer vouched for it) and `time` (the UTC day, a NumericDate). A key an earlier verification proved stays held while the latest one carries the same values (the same phone for `phone_possession`).","maxProperties":9,"title":"RecordedActiveKeys","type":"object","uniqueKey":"active_keys","typeLabel":"RecordedActiveKeys · object"},"available_disclosure_paths":{"description":"The subject-relative credential disclosure paths a mint from the current verification can disclose: a held key proves each and a value is on file, hash leaves included (e.g. `hashes.ssn`). Paths only, never values. Empty when this organization holds no current verification.","items":{"type":"string","uniqueKey":"available_disclosure_paths.items.[INDEX]","typeLabel":"string"},"title":"Available Disclosure Paths","type":"array","uniqueKey":"available_disclosure_paths","typeLabel":"string[]"}},"required":["individual_ref","created_at","operator_link_count","submission_count","credential_counts","record_count"],"title":"IdentityStatusResponse (v1)","type":"object","uniqueKey":"","typeLabel":"IdentityStatusResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"individual_ref":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","operator_link_count":123,"submission_count":123,"credential_counts":{"issued_30d":123,"active":123,"revoked_30d":123},"record_count":123,"display_name":"\u003cstring>","reference_id":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z","active_keys":{},"available_disclosure_paths":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"0c7b5831-6c4e-4613-9475-b8b51bbe9662":{"description":"The individual_ref is unknown or was issued to another organization — the two are indistinguishable.","content":{"application/json":{"schema":{"properties":{"type":{"type":"string","title":"Type","description":"Stable snake_case name of the error. Branch on this, never on `message`.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"type":"integer","title":"Code","description":"Integer catalog code of the error.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","title":"Message","description":"For a person reading a log; not stable and not localized.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Context documented per `type`.","uniqueKey":"metadata","typeLabel":"Metadata · object"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"The `X-Request-ID` of the failed request.","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"The `X-Request-ID` of the failed request.","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"type":"object","required":["type","code","message"],"title":"ResourceNotFound","description":"Could not locate the resource for the given URI.","examples":[{"type":"resource_not_found","code":1,"message":"Could not locate the resource for the given URI.","metadata":{}}],"uniqueKey":"","typeLabel":"ResourceNotFound · object"},"examples":{"Example":{"title":"Example","value":{"type":"resource_not_found","code":1,"message":"Could not locate the resource for the given URI.","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"ab854ef2-2dc4-43cb-9d78-65c52d414414":{"description":"The request is invalid.","content":{"application/json":{"schema":{"properties":{"type":{"type":"string","title":"Type","description":"Stable snake_case name of the error. Branch on this, never on `message`.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"type":"integer","title":"Code","description":"Integer catalog code of the error.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","title":"Message","description":"For a person reading a log; not stable and not localized.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Context documented per `type`.","uniqueKey":"metadata","typeLabel":"Metadata · object"},"request_id":{"oneOf":[{"type":"string","title":"Request Id","description":"The `X-Request-ID` of the failed request.","uniqueKey":"request_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Request Id","description":"The `X-Request-ID` of the failed request.","uniqueKey":"request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"request_id","typeLabel":"string | null"}},"type":"object","required":["type","code","message"],"title":"ValidationFailed","description":"The request is invalid.","examples":[{"type":"validation_failed","code":7112,"message":"The request is invalid.","metadata":{}}],"uniqueKey":"","typeLabel":"ValidationFailed · object"},"examples":{"Example":{"title":"Example","value":{"type":"validation_failed","code":7112,"message":"The request is invalid.","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9007c892-cf02-43c9-97cb-3052d1f5fe32":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"62382a77-8b01-44a7-a119-eef1372efca3":{"url":"https://api.baselayer.com/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"baselayer-81245324","siteName":"Baselayer","title":"Look up an individual by pairwise reference - Baselayer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T02:32:18.105Z","originalFileLocation":"api-reference/identities/look-up-an-individual-by-pairwise-reference.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=\"Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Baselayer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Look up an individual by pairwise reference - Baselayer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Baselayer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://baselayer-81245324.mintlify.site/_mintlify/api/og/v2?division=Verified+Identities\u0026amp;title=Look+up+an+individual+by+pairwise+reference\u0026amp;description=Returns+when+your+latest+record+of+the+individual+was+accepted%2C+the+keys+it+holds+with+their+%60basis%60+%28%60verified%60+or+%60attested%60%29%2C+and+how+many+credentials%2C+submi\u0026amp;theme=8062a696da8f8e4202f95a94\u0026amp;signature=058218d83a727a83332c713c653b4f5166337b34f0389dca47af371e25de0ce2\">\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=\"Look up an individual by pairwise reference - Baselayer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://baselayer-81245324.mintlify.site/_mintlify/api/og/v2?division=Verified+Identities\u0026amp;title=Look+up+an+individual+by+pairwise+reference\u0026amp;description=Returns+when+your+latest+record+of+the+individual+was+accepted%2C+the+keys+it+holds+with+their+%60basis%60+%28%60verified%60+or+%60attested%60%29%2C+and+how+many+credentials%2C+submi\u0026amp;theme=8062a696da8f8e4202f95a94\u0026amp;signature=058218d83a727a83332c713c653b4f5166337b34f0389dca47af371e25de0ce2\">\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/baselayer-81245324/PX_ZXIXr1oHoY_hi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Baselayer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#384ce3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/identities/look-up-an-individual-by-pairwise-reference.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.baselayer.com/#organization\",\"name\":\"Baselayer\",\"url\":\"https://docs.baselayer.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/baselayer-81245324/D2HqlyNVJCqb8u23/logo/baselayer-wordmark-white.svg?fit=max\u0026auto=format\u0026n=D2HqlyNVJCqb8u23\u0026q=85\u0026s=533e2ee556334e910d3a6d1f2f66ca6a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.baselayer.com#website\",\"name\":\"Baselayer\",\"url\":\"https://docs.baselayer.com\",\"publisher\":{\"@id\":\"https://docs.baselayer.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference#webpage\",\"url\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference\",\"name\":\"Look up an individual by pairwise reference\",\"description\":\"Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.\",\"dateModified\":\"2026-11-20T02:32:18.105Z\",\"isPartOf\":{\"@id\":\"https://docs.baselayer.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Identities\",\"item\":\"https://docs.baselayer.com/api-reference/onboarding/start-a-hosted-enrollment-session\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Verified Identities\",\"item\":\"https://docs.baselayer.com/api-reference/identities/push-an-individual-you-verified\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Look up an individual by pairwise reference\",\"item\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference#apireference\",\"headline\":\"Look up an individual by pairwise reference\",\"name\":\"Look up an individual by pairwise reference\",\"description\":\"Returns when your latest record of the individual was accepted, the keys it holds with their basis (verified or attested), and how many credentials, submissions, verifications and operator links they have, for an individual_ref issued to your organization. Any reference you hold for the person resolves, and the response carries the one your lists show for them. References issued to other organizations and unknown references are indistinguishable 404s.\",\"url\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference\",\"mainEntityOfPage\":{\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-an-individual-by-pairwise-reference#webpage\"},\"dateModified\":\"2026-11-20T02:32:18.105Z\",\"publisher\":{\"@id\":\"https://docs.baselayer.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.baselayer.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Baselayer\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Baselayer\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/identities/look-up-an-individual-by-pairwise-reference.md","siteName":"Baselayer","nav":{"global":null,"tabs":[{"tab":"Get Started","icon":"rocket","pages":[{"title":"Get Started","href":"/docs/meet-baselayer"}]},{"tab":"Verify Businesses \u0026 People","icon":"book-open","pages":[{"title":"Verify Businesses \u0026 People","href":"/docs/business-verification-basics"}]},{"tab":"Know Your Agent","icon":"robot","pages":[{"title":"Know Your Agent","href":"/docs/kya-overview"}]},{"tab":"Hosted Enrollment","icon":"id-card","pages":[{"title":"Hosted Enrollment","href":"/hosted-enrollment/overview"}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/docs/mcp"}]},{"tab":"API Reference","icon":"square-terminal","anchors":[{"anchor":"Businesses","icon":"building","pages":[{"title":"Businesses","href":"/api-reference/search/post-search"}]},{"anchor":"People","icon":"user","pages":[{"title":"People","href":"/api-reference/people/create-person"}]},{"anchor":"Know Your Agent","icon":"robot","groups":[{"group":"Credentials","pages":[{"group":"Mint","pages":[{"title":"Mint a credential for a person or a business operator","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials","href":"/api-reference/credentials/mint-a-credential-for-a-person-or-a-business-operator"},{"title":"Preview what a mint would disclose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/preview","href":"/api-reference/credentials/preview-what-a-mint-would-disclose"},{"title":"List the presets a mint can disclose by","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials/presets","href":"/api-reference/credentials/list-the-presets-a-mint-can-disclose-by"},{"title":"Mint a test credential for a person or a business operator","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/test","href":"/api-reference/credentials/mint-a-test-credential-for-a-person-or-a-business-operator"},{"title":"Preview what a test mint would disclose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/test/preview","href":"/api-reference/credentials/preview-what-a-test-mint-would-disclose"}]},{"group":"Issued Credentials","pages":[{"title":"Resolve one credential record by its credential_id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials/{credential_id}","href":"/api-reference/credentials/resolve-one-credential-record-by-its-credential_id"},{"title":"List your organization's credential records","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials","href":"/api-reference/credentials/list-your-organizations-credential-records"},{"title":"Revoke one credential","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/{credential_id}/revoke","href":"/api-reference/credentials/revoke-one-credential"}]},{"group":"Credential Events","pages":[{"title":"List your organization's credential events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials/events","href":"/api-reference/credentials/list-your-organizations-credential-events"},{"title":"Export your organization's credential events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials/events/export","href":"/api-reference/credentials/export-your-organizations-credential-events"}]}]},{"group":"Identities","pages":[{"group":"Hosted Sessions","pages":[{"title":"Start a hosted enrollment session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /onboarding/sessions","href":"/api-reference/onboarding/start-a-hosted-enrollment-session"},{"title":"Get a hosted enrollment session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /onboarding/sessions/{session_id}","href":"/api-reference/onboarding/get-a-hosted-enrollment-session"},{"title":"Get a hosted enrollment session's results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /onboarding/sessions/{session_id}/results","href":"/api-reference/onboarding/get-a-hosted-enrollment-sessions-results"}]},{"group":"Direct Verifications","pages":[{"title":"Start a direct verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/identities/verifications","href":"/api-reference/identities/start-a-direct-verification"},{"title":"Get a direct verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/verifications/{verification_id}","href":"/api-reference/identities/get-a-direct-verification"},{"title":"List direct verifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/verifications","href":"/api-reference/identities/list-direct-verifications"}]},{"group":"Verified Identities","pages":[{"title":"Push an individual you verified","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/identities/individuals","href":"/api-reference/identities/push-an-individual-you-verified"},{"title":"List the individuals your organization has onboarded","description":"Lists every individual your organization holds an accepted record of, whether Baselayer verified them or you pushed them as verified yourself, most recent activity first by default: their keys with each one's basis, how many businesses they operate under your coverage, and when they were last updated. Filter by business link and by the day the latest record was accepted (`start_date`/`end_date`, over `updated_at`); search by reference, name, email or phone. Scoped to your own population — references issued by other organizations are not listed and are not searchable.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals","href":"/api-reference/identities/list-the-individuals-your-organization-has-onboarded"},{"title":"Look up an individual by pairwise reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals/{individual_ref}","href":"/api-reference/identities/look-up-an-individual-by-pairwise-reference"},{"title":"List the businesses your organization has verified","description":"Lists every business your organization holds a `bus_` reference for, most recent activity first by default: its registered name and state, what your latest evaluation concluded, how its operators stand, and when it last saw activity. Operator counts are reported per link status rather than collapsed into one verdict — a business can have settled operators and one awaiting review at the same time. Search by reference, EIN, or name.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/businesses","href":"/api-reference/identities/list-the-businesses-your-organization-has-verified"},{"title":"Look up a verified business by pairwise reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/businesses/{business_ref}","href":"/api-reference/identities/look-up-a-verified-business-by-pairwise-reference"}]},{"group":"Operator Links","pages":[{"title":"List your organization's operator links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/operator_links","href":"/api-reference/identities/list-your-organizations-operator-links"},{"title":"Get one operator link with its evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/businesses/{business_ref}/operator_links/{individual_ref}","href":"/api-reference/identities/get-one-operator-link-with-its-evidence"},{"title":"Verify or reject that an individual operates a business","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/identities/businesses/{business_ref}/operator_links/{individual_ref}/decision","href":"/api-reference/identities/verify-or-reject-that-an-individual-operates-a-business"}]}]},{"group":"Public keys and status lists","pages":[{"title":"Resolve the credential issuer's DID document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/did.json","href":"/api-reference/registry/resolve-the-credential-issuers-did-document"},{"title":"Fetch the credential issuer's public keys (JWKS)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/jwks.json","href":"/api-reference/registry/fetch-the-credential-issuers-public-keys-jwks"},{"title":"Fetch the credential issuer's JWT VC Issuer Metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/jwt-vc-issuer","href":"/api-reference/registry/fetch-the-credential-issuers-jwt-vc-issuer-metadata"},{"title":"Fetch the credential status list token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /statuslists/{list_id}","href":"/api-reference/registry/fetch-the-credential-status-list-token"},{"title":"Fetch the individual credential's type metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /vct/kya/individual/v1","href":"/api-reference/registry/fetch-the-individual-credentials-type-metadata"},{"title":"Fetch the business credential's type metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /vct/kya/business/v1","href":"/api-reference/registry/fetch-the-business-credentials-type-metadata"}]},{"group":"Audit Log","pages":[{"title":"Read the calling organization's slice of the audit log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/audit_log","href":"/api-reference/audit-log/read-the-calling-organizations-slice-of-the-audit-log"}]},{"group":"Acceptance","pages":[{"group":"Visits","pages":[{"title":"List your application's visits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/visits","href":"/api-reference/acceptance/list-your-applications-visits"},{"title":"Get one visit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/visits/{visit_id}","href":"/api-reference/acceptance/get-one-visit"},{"title":"List one visit's timeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/visits/{visit_id}/timeline","href":"/api-reference/acceptance/list-one-visits-timeline"},{"title":"List one visit's decisions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/visits/{visit_id}/decisions","href":"/api-reference/acceptance/list-one-visits-decisions"}]},{"group":"Decisions","pages":[{"title":"List your application's decisions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/decisions","href":"/api-reference/acceptance/list-your-applications-decisions"},{"title":"Get one decision","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/decisions/{decision_id}","href":"/api-reference/acceptance/get-one-decision"}]},{"group":"Policy","pages":[{"title":"Get your application's acceptance policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/policy","href":"/api-reference/acceptance/get-your-applications-acceptance-policy"},{"title":"Replace your application's acceptance policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /acceptance/policy","href":"/api-reference/acceptance/replace-your-applications-acceptance-policy"},{"title":"List your application's acceptance policy versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/policy/versions","href":"/api-reference/acceptance/list-your-applications-acceptance-policy-versions"},{"title":"Get one version of your application's acceptance policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/policy/versions/{policy_version_id}","href":"/api-reference/acceptance/get-one-version-of-your-applications-acceptance-policy"}]},{"group":"Domains","pages":[{"title":"Get your application's audiences and allowed origins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/domains","href":"/api-reference/acceptance/get-your-applications-audiences-and-allowed-origins"},{"title":"Replace your application's audiences and allowed origins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /acceptance/domains","href":"/api-reference/acceptance/replace-your-applications-audiences-and-allowed-origins"}]},{"group":"Browser Keys","pages":[{"title":"Create a browser key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /acceptance/browser_keys","href":"/api-reference/acceptance/create-a-browser-key"},{"title":"List your application's browser keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/browser_keys","href":"/api-reference/acceptance/list-your-applications-browser-keys"},{"title":"Get one of your application's browser keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /acceptance/browser_keys/{browser_key_id}","href":"/api-reference/acceptance/get-one-of-your-applications-browser-keys"},{"title":"Delete a browser key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /acceptance/browser_keys/{browser_key_id}","href":"/api-reference/acceptance/delete-a-browser-key"}]}]}]},{"anchor":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/api-reference/organization-management/create-organization-for-federation"}]},{"anchor":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/api-reference/webhook-management/create-webhook-endpoint"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/kyb-score-settings-unknown-status-and-missing-address"}]}]},"basePath":"","title":"Look up an individual by pairwise reference - Baselayer","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"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","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}