{
"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 a verified business by pairwise reference
Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. References issued to other organizations and unknown references are indistinguishable 404s.
GET
/
issuance
/
identities
/
businesses
/
{business_ref}
Look up a verified business by pairwise reference
curl --request GET \ --url https://api.baselayer.com/issuance/identities/businesses/{business_ref} \ --header 'X-API-Key: <api-key>'
Body for GET /issuance/identities/businesses/{business_ref}.
Strictly scoped to the calling organization, like the person profile:
the outcome and checks read the session behind its latest confirmation,
the people are the operator links it covered, and the submission history
is its own approved sessions. No global business id and no EIN are ever
echoed.
EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (kyb_outcome still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.
The subject-relative credential disclosure paths the business's records can populate, hash leaves included (e.g. hashes.ein). Paths only, never values. A requested path missing here is skipped at mint, not refused. The acting person's actor.* paths are on their person profile without the actor. prefix.
This organization's approved sessions that covered the business, newest first.
Show child attributes
{"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":""},"chroma":{"collectionId":"c01b8a96-72e8-47f2-acae-28665212b8cb","liveDeploymentHistoryId":"6ae2cd9ed5f357b7dcda2db3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2cd9ed5f357b7dcda2db3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b13c39bc6f1b8c505ffe","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":270},{"language":"default","tag":"Changelog","count":162},{"language":"default","tag":"Businesses","count":133},{"language":"default","tag":"Webhooks","count":81},{"language":"default","tag":"Webhook Events","count":68},{"language":"default","tag":"PRODUCT GUIDES","count":61},{"language":"default","tag":"Verify Businesses \u0026 People","count":60},{"language":"default","tag":"Know Your Agent","count":54},{"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":"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":"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":"llms-txt-v2","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","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,.18)!important}html:not(.dark) #navbar a,html:not(.dark) #navbar button,html:not(.dark) #navbar div,html:not(.dark) #navbar p,html:not(.dark) #navbar span,html:not(.dark) #navbar svg{color:#fff!important}html:not(.dark) #navbar button{background:rgba(255,255,255,.12)!important;border-color:rgba(255,255,255,.25)!important}"}],"page":{"pagePath":"api-reference/identities/look-up-a-verified-business-by-pairwise-reference","slug":"/api-reference/identities/look-up-a-verified-business-by-pairwise-reference","pageMetadata":{"title":"Look up a verified business by pairwise reference","description":"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a `business_ref` issued to your organization. References issued to other organizations and unknown references are indistinguishable `404`s.","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","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 what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a \", _jsx(_components.code, {\n children: \"business_ref\"\n }), \" issued to your organization. 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 a verified business by pairwise reference","description":"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a `business_ref` issued to your organization. References issued to other organizations and unknown references are indistinguishable `404`s.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/baselayer-81245324/8f3f8776472b6600/kya-nudge.js"],"openApiReferenceData":{"operation":{"tags":["Identities"],"summary":"Look up a verified business by pairwise reference","description":"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a `business_ref` issued to your organization. References issued to other organizations and unknown references are indistinguishable `404`s.","operationId":"issuance_identities_businesses_get","security":["d060b278-41bb-4c67-b024-c642d6b7741e"],"parameters":["01b2df85-3cf2-45bb-89a4-d33318fa43fb"],"responses":{"200":"56b41295-8698-485c-bf50-1849227cf62a","404":"9c5be1d8-fb24-4143-98e4-b31a73596621","422":"c899b70a-dcca-4837-8d1a-d68033807e91"},"method":"get","type":"path","servers":["788562d2-18e0-4de1-8ca6-c9b3fd720b2d"],"path":"/issuance/identities/businesses/{business_ref}","baseUrlOptions":["https://api.baselayer.com/"],"title":"Look up a verified business by pairwise reference","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"01b2df85-3cf2-45bb-89a4-d33318fa43fb":{"name":"business_ref","in":"path","required":true,"schema":{"type":"string","title":"Business Ref","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"56b41295-8698-485c-bf50-1849227cf62a":{"description":"Response","content":{"application/json":{"schema":{"description":"Body for ``GET /issuance/identities/businesses/{business_ref}``.\n\nStrictly scoped to the calling organization, like the person profile:\nthe outcome and checks read the session behind its latest confirmation,\nthe people are the operator links it covered, and the submission history\nis its own approved sessions. No global business id and no EIN are ever\nechoed.","properties":{"business_ref":{"description":"The queried pairwise business reference.","title":"Business Ref","type":"string","isRequired":true,"uniqueKey":"business_ref","typeLabel":"string"},"legal_name":{"description":"The business's registered legal name.","title":"Legal Name","type":"string","isRequired":true,"uniqueKey":"legal_name","typeLabel":"string"},"kyb_outcome":{"description":"What this organization's latest confirmation concluded.","enum":["VERIFIED","NOT_VERIFIED"],"title":"BusinessKybOutcome","type":"string","isRequired":true,"uniqueKey":"kyb_outcome","typeLabel":"enum\u003cstring>"},"checks":{"description":"Each check of the evaluation behind the latest confirmation, in card order; empty when `checks_unavailable_reason` is set.","items":{"description":"One line of the business verification card.","properties":{"key":{"description":"Which check.","enum":["REGISTRY_RECORD_FOUND","REGISTRATION_ACTIVE","TAX_ID_MATCHED","WATCHLIST_CLEAR"],"title":"BusinessKybCheckKey","type":"string","isRequired":true,"uniqueKey":"checks.items.[INDEX].key","typeLabel":"enum\u003cstring>"},"result":{"description":"PASSED or FAILED; NOT_RUN when the check produced no evidence either way, never a failure.","enum":["PASSED","FAILED","NOT_RUN"],"title":"BusinessKybCheckResult","type":"string","isRequired":true,"uniqueKey":"checks.items.[INDEX].result","typeLabel":"enum\u003cstring>"}},"required":["key","result"],"title":"BusinessKybCheckResponse (v1)","type":"object","uniqueKey":"checks.items.[INDEX]","typeLabel":"BusinessKybCheckResponse (v1) · object"},"title":"Checks","type":"array","isRequired":true,"uniqueKey":"checks","typeLabel":"BusinessKybCheckResponse (v1) · object[]"},"incorporation":{"description":"The registry facts of the incorporation.","properties":{"state":{"enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","PR","VI","AE","AA","AP","GU","AS"],"title":"StateAbbreviation","type":"string","description":"State of incorporation.","isRequired":true,"uniqueKey":"incorporation.state","typeLabel":"enum\u003cstring>"},"filing_number":{"description":"Registry filing number in that state.","title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"incorporation.filing_number","typeLabel":"string"},"incorporation_date":{"oneOf":[{"type":"string","title":"Incorporation Date","description":"Date of incorporation, when the registry publishes it.","format":"date","uniqueKey":"incorporation.incorporation_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Incorporation Date","description":"Date of incorporation, when the registry publishes it.","uniqueKey":"incorporation.incorporation_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.incorporation_date","typeLabel":"string\u003cdate> | null"},"structure":{"oneOf":[{"type":"string","title":"BusinessStructure","description":"Legal structure, when known.","enum":["SOLE_PROPRIETORSHIP","GENERAL_PARTNERSHIP","LLC","LLP","LLLP","LP","C_CORPORATION","S_CORPORATION","B_CORPORATION","NONPROFIT","COOPERATIVE","TRUST","PROFESSIONAL_ASSOCIATION","PROFESSIONAL_CORPORATION","TRADE_NAME","BANK","CREDIT_UNION","INSURANCE","OTHER"],"uniqueKey":"incorporation.structure.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Legal structure, when known.","uniqueKey":"incorporation.structure.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.structure","typeLabel":"enum\u003cstring> | null"},"sos_status":{"oneOf":[{"type":"string","title":"SOSStatus","description":"The registry's standing for the entity, when known.","enum":["GOOD_STANDING","NOT_GOOD_STANDING","SS","FD"],"uniqueKey":"incorporation.sos_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The registry's standing for the entity, when known.","uniqueKey":"incorporation.sos_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.sos_status","typeLabel":"enum\u003cstring> | null"},"dissolution_date":{"oneOf":[{"type":"string","title":"Dissolution Date","description":"Date of dissolution, when the entity has one.","format":"date","uniqueKey":"incorporation.dissolution_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Dissolution Date","description":"Date of dissolution, when the entity has one.","uniqueKey":"incorporation.dissolution_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.dissolution_date","typeLabel":"string\u003cdate> | null"}},"required":["state","filing_number"],"title":"BusinessIncorporationResponse (v1)","type":"object","isRequired":true,"uniqueKey":"incorporation","typeLabel":"BusinessIncorporationResponse (v1) · object"},"credentials":{"description":"This organization's agent credentials for the business.","properties":{"issued_30d":{"description":"Agent credentials issued in the last 30 days.","title":"Issued 30D","type":"integer","isRequired":true,"uniqueKey":"credentials.issued_30d","typeLabel":"integer"},"active":{"description":"Agent credentials neither revoked nor expired.","title":"Active","type":"integer","isRequired":true,"uniqueKey":"credentials.active","typeLabel":"integer"},"revoked_30d":{"description":"Agent credentials revoked in the last 30 days.","title":"Revoked 30D","type":"integer","isRequired":true,"uniqueKey":"credentials.revoked_30d","typeLabel":"integer"}},"required":["issued_30d","active","revoked_30d"],"title":"CredentialSummaryResponse (v1)","type":"object","isRequired":true,"uniqueKey":"credentials","typeLabel":"CredentialSummaryResponse (v1) · object"},"not_verified_reason":{"oneOf":[{"type":"string","title":"BusinessNotVerifiedReason","description":"VERIFICATION_INCOMPLETE when the check never finished; null otherwise.","enum":["VERIFICATION_INCOMPLETE"],"uniqueKey":"not_verified_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"VERIFICATION_INCOMPLETE when the check never finished; null otherwise.","uniqueKey":"not_verified_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"not_verified_reason","typeLabel":"enum\u003cstring> | null"},"checks_unavailable_reason":{"oneOf":[{"type":"string","title":"BusinessChecksUnavailableReason","description":"EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (`kyb_outcome` still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.","enum":["EVIDENCE_UNAVAILABLE","NO_CONFIRMED_VERIFICATION"],"uniqueKey":"checks_unavailable_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (`kyb_outcome` still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.","uniqueKey":"checks_unavailable_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"checks_unavailable_reason","typeLabel":"enum\u003cstring> | null"},"last_verified_at":{"oneOf":[{"type":"string","title":"Last Verified At","description":"When this organization's latest confirmation was recorded.","format":"date-time","uniqueKey":"last_verified_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Verified At","description":"When this organization's latest confirmation was recorded.","uniqueKey":"last_verified_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_verified_at","typeLabel":"string\u003cdate-time> | null"},"available_disclosure_paths":{"description":"The subject-relative credential disclosure paths the business's records can populate, hash leaves included (e.g. `hashes.ein`). Paths only, never values. A requested path missing here is skipped at mint, not refused. The acting person's `actor.*` paths are on their person profile without the `actor.` prefix.","items":{"type":"string","uniqueKey":"available_disclosure_paths.items.[INDEX]","typeLabel":"string"},"title":"Available Disclosure Paths","type":"array","uniqueKey":"available_disclosure_paths","typeLabel":"string[]"},"people":{"description":"People this organization holds covered operator links for, each with their pairwise ref and link status.","items":{"description":"One person the calling organization holds an operator link for — the\nmirror of the person profile's business links.","properties":{"status":{"description":"Your organization's current status for the link.","enum":["VERIFIED","UNDER_REVIEW","REJECTED"],"title":"BusinessOperatorLinkStatus","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"created_at":{"description":"When the link was first recorded.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"individual_ref":{"description":"Pairwise reference to the linked individual.","title":"Individual Ref","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].individual_ref","typeLabel":"string"},"review_flagged_at":{"oneOf":[{"type":"string","title":"Review Flagged At","description":"When a later evaluation flagged this verified link for review; null when it never was.","format":"date-time","uniqueKey":"people.items.[INDEX].review_flagged_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Review Flagged At","description":"When a later evaluation flagged this verified link for review; null when it never was.","uniqueKey":"people.items.[INDEX].review_flagged_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].review_flagged_at","typeLabel":"string\u003cdate-time> | null"},"decided_at":{"oneOf":[{"type":"string","title":"Decided At","description":"When your organization last verified or rejected the link by hand; null while only the evidence has decided it.","format":"date-time","uniqueKey":"people.items.[INDEX].decided_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Decided At","description":"When your organization last verified or rejected the link by hand; null while only the evidence has decided it.","uniqueKey":"people.items.[INDEX].decided_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decided_at","typeLabel":"string\u003cdate-time> | null"},"decided_by":{"oneOf":[{"type":"object","title":"ActedBy (v1)","description":"Who made that decision, as stamped when they made it; null when no one has.","required":["kind","label"],"properties":{"kind":{"description":"`USER` for a console user, `API_KEY` for a key.","enum":["USER","API_KEY"],"title":"ActedByKind","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"label":{"description":"The user's first and last name or the API key's name, as they were when they acted; never rewritten by a later rename or deletion.","title":"Label","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0.label","typeLabel":"string"}},"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0","typeLabel":"ActedBy (v1) · object"},{"type":"null","description":"Who made that decision, as stamped when they made it; null when no one has.","uniqueKey":"people.items.[INDEX].decided_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decided_by","typeLabel":"ActedBy (v1) · object | null"},"decision_reason":{"oneOf":[{"type":"string","title":"Decision Reason","description":"The reason recorded with that decision, if any.","uniqueKey":"people.items.[INDEX].decision_reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Decision Reason","description":"The reason recorded with that decision, if any.","uniqueKey":"people.items.[INDEX].decision_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decision_reason","typeLabel":"string | null"},"source_verification_id":{"oneOf":[{"type":"string","title":"Source Verification Id","description":"The verification that established the link; null when that verification no longer exists. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","format":"uuid","uniqueKey":"people.items.[INDEX].source_verification_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Source Verification Id","description":"The verification that established the link; null when that verification no longer exists. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","uniqueKey":"people.items.[INDEX].source_verification_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].source_verification_id","typeLabel":"string\u003cuuid> | null"},"display_name":{"oneOf":[{"type":"string","title":"Display Name","description":"The individual's verified name from your organization's current verification; null when it has been superseded and not yet replaced.","uniqueKey":"people.items.[INDEX].display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Display Name","description":"The individual's verified name from your organization's current verification; null when it has been superseded and not yet replaced.","uniqueKey":"people.items.[INDEX].display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].display_name","typeLabel":"string | null"}},"required":["status","created_at","individual_ref"],"title":"BusinessOperatorLinkResponse (v1)","type":"object","uniqueKey":"people.items.[INDEX]","typeLabel":"BusinessOperatorLinkResponse (v1) · object"},"title":"People","type":"array","uniqueKey":"people","typeLabel":"BusinessOperatorLinkResponse (v1) · object[]"},"submissions":{"description":"This organization's approved sessions that covered the business, newest first.","items":{"description":"One verification attempt in a profile's submission history, direct or\nhosted, reduced to the row a history timeline renders.","properties":{"verification_id":{"description":"Id of the verification. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","format":"uuid","title":"Verification Id","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].verification_id","typeLabel":"string\u003cuuid>"},"state":{"description":"Lifecycle state of the verification workflow.","enum":["PENDING","EXECUTING","WAITING","COMPLETED","FAILED","EXPIRED"],"title":"VerificationState","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"created_at":{"description":"When the submission was accepted.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"verdict":{"oneOf":[{"type":"string","title":"OnboardingVerdict","description":"Resolved onboarding verdict; null until completion.","enum":["APPROVED","UNDER_REVIEW","REJECTED"],"uniqueKey":"submissions.items.[INDEX].verdict.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Resolved onboarding verdict; null until completion.","uniqueKey":"submissions.items.[INDEX].verdict.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].verdict","typeLabel":"enum\u003cstring> | null"},"reference_id":{"oneOf":[{"type":"string","title":"Reference Id","description":"Caller-supplied correlation id.","uniqueKey":"submissions.items.[INDEX].reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reference Id","description":"Caller-supplied correlation id.","uniqueKey":"submissions.items.[INDEX].reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].reference_id","typeLabel":"string | null"},"completed_at":{"oneOf":[{"type":"string","title":"Completed At","description":"When the workflow reached a terminal state.","format":"date-time","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Completed At","description":"When the workflow reached a terminal state.","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].completed_at","typeLabel":"string\u003cdate-time> | null"},"terminal_reason":{"oneOf":[{"type":"object","title":"IdentitySubmissionTerminalReasonResponse (v1)","description":"Typed state and detail when the workflow ended in FAILED; null otherwise.","required":["state"],"properties":{"state":{"description":"Terminal workflow state.","enum":["FAILED"],"title":"TerminalReasonState","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.state","typeLabel":"enum\u003cstring>"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Human-readable detail recorded by the workflow.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Human-readable detail recorded by the workflow.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message","typeLabel":"string | null"}},"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0","typeLabel":"IdentitySubmissionTerminalReasonResponse (v1) · object"},{"type":"null","description":"Typed state and detail when the workflow ended in FAILED; null otherwise.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].terminal_reason","typeLabel":"IdentitySubmissionTerminalReasonResponse (v1) · object | null"},"journey_name":{"oneOf":[{"type":"string","title":"Journey Name","description":"The name of this organization's journey the session ran; null for a session started through the API.","uniqueKey":"submissions.items.[INDEX].journey_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Journey Name","description":"The name of this organization's journey the session ran; null for a session started through the API.","uniqueKey":"submissions.items.[INDEX].journey_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].journey_name","typeLabel":"string | null"},"decided_by":{"oneOf":[{"type":"object","title":"ActedBy (v1)","description":"Who decided the session on review, as they were named when they decided; null when it was decided automatically.","required":["kind","label"],"properties":{"kind":{"description":"`USER` for a console user, `API_KEY` for a key.","enum":["USER","API_KEY"],"title":"ActedByKind","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"label":{"description":"The user's first and last name or the API key's name, as they were when they acted; never rewritten by a later rename or deletion.","title":"Label","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0.label","typeLabel":"string"}},"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0","typeLabel":"ActedBy (v1) · object"},{"type":"null","description":"Who decided the session on review, as they were named when they decided; null when it was decided automatically.","uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].decided_by","typeLabel":"ActedBy (v1) · object | null"}},"required":["verification_id","state","created_at"],"title":"IdentitySubmissionHistoryItemResponse (v1)","type":"object","uniqueKey":"submissions.items.[INDEX]","typeLabel":"IdentitySubmissionHistoryItemResponse (v1) · object"},"title":"Submissions","type":"array","uniqueKey":"submissions","typeLabel":"IdentitySubmissionHistoryItemResponse (v1) · object[]"}},"required":["business_ref","legal_name","kyb_outcome","checks","incorporation","credentials"],"title":"BusinessIdentityStatusResponse (v1)","type":"object","uniqueKey":"","typeLabel":"BusinessIdentityStatusResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"business_ref":"\u003cstring>","legal_name":"\u003cstring>","kyb_outcome":"VERIFIED","checks":[{"key":"REGISTRY_RECORD_FOUND","result":"PASSED"}],"incorporation":{"state":"AL","filing_number":"\u003cstring>","incorporation_date":"2023-12-25","structure":"SOLE_PROPRIETORSHIP","sos_status":"GOOD_STANDING","dissolution_date":"2023-12-25"},"credentials":{"issued_30d":123,"active":123,"revoked_30d":123},"not_verified_reason":"VERIFICATION_INCOMPLETE","checks_unavailable_reason":"EVIDENCE_UNAVAILABLE","last_verified_at":"2023-11-07T05:31:56Z","available_disclosure_paths":["\u003cstring>"],"people":[{"status":"VERIFIED","created_at":"2023-11-07T05:31:56Z","individual_ref":"\u003cstring>","review_flagged_at":"2023-11-07T05:31:56Z","decided_at":"2023-11-07T05:31:56Z","decided_by":{"kind":"USER","label":"\u003cstring>"},"decision_reason":"\u003cstring>","source_verification_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":"\u003cstring>"}],"submissions":[{"verification_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","state":"PENDING","created_at":"2023-11-07T05:31:56Z","verdict":"APPROVED","reference_id":"\u003cstring>","completed_at":"2023-11-07T05:31:56Z","terminal_reason":{"state":"FAILED","message":"\u003cstring>"},"journey_name":"\u003cstring>","decided_by":{"kind":"USER","label":"\u003cstring>"}}]}}},"exampleType":"generated"},"application/vnd.baselayer.v1+json":{"schema":{"description":"Body for ``GET /issuance/identities/businesses/{business_ref}``.\n\nStrictly scoped to the calling organization, like the person profile:\nthe outcome and checks read the session behind its latest confirmation,\nthe people are the operator links it covered, and the submission history\nis its own approved sessions. No global business id and no EIN are ever\nechoed.","properties":{"business_ref":{"description":"The queried pairwise business reference.","title":"Business Ref","type":"string","isRequired":true,"uniqueKey":"business_ref","typeLabel":"string"},"legal_name":{"description":"The business's registered legal name.","title":"Legal Name","type":"string","isRequired":true,"uniqueKey":"legal_name","typeLabel":"string"},"kyb_outcome":{"description":"What this organization's latest confirmation concluded.","enum":["VERIFIED","NOT_VERIFIED"],"title":"BusinessKybOutcome","type":"string","isRequired":true,"uniqueKey":"kyb_outcome","typeLabel":"enum\u003cstring>"},"checks":{"description":"Each check of the evaluation behind the latest confirmation, in card order; empty when `checks_unavailable_reason` is set.","items":{"description":"One line of the business verification card.","properties":{"key":{"description":"Which check.","enum":["REGISTRY_RECORD_FOUND","REGISTRATION_ACTIVE","TAX_ID_MATCHED","WATCHLIST_CLEAR"],"title":"BusinessKybCheckKey","type":"string","isRequired":true,"uniqueKey":"checks.items.[INDEX].key","typeLabel":"enum\u003cstring>"},"result":{"description":"PASSED or FAILED; NOT_RUN when the check produced no evidence either way, never a failure.","enum":["PASSED","FAILED","NOT_RUN"],"title":"BusinessKybCheckResult","type":"string","isRequired":true,"uniqueKey":"checks.items.[INDEX].result","typeLabel":"enum\u003cstring>"}},"required":["key","result"],"title":"BusinessKybCheckResponse (v1)","type":"object","uniqueKey":"checks.items.[INDEX]","typeLabel":"BusinessKybCheckResponse (v1) · object"},"title":"Checks","type":"array","isRequired":true,"uniqueKey":"checks","typeLabel":"BusinessKybCheckResponse (v1) · object[]"},"incorporation":{"description":"The registry facts of the incorporation.","properties":{"state":{"enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","PR","VI","AE","AA","AP","GU","AS"],"title":"StateAbbreviation","type":"string","description":"State of incorporation.","isRequired":true,"uniqueKey":"incorporation.state","typeLabel":"enum\u003cstring>"},"filing_number":{"description":"Registry filing number in that state.","title":"Filing Number","type":"string","isRequired":true,"uniqueKey":"incorporation.filing_number","typeLabel":"string"},"incorporation_date":{"oneOf":[{"type":"string","title":"Incorporation Date","description":"Date of incorporation, when the registry publishes it.","format":"date","uniqueKey":"incorporation.incorporation_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Incorporation Date","description":"Date of incorporation, when the registry publishes it.","uniqueKey":"incorporation.incorporation_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.incorporation_date","typeLabel":"string\u003cdate> | null"},"structure":{"oneOf":[{"type":"string","title":"BusinessStructure","description":"Legal structure, when known.","enum":["SOLE_PROPRIETORSHIP","GENERAL_PARTNERSHIP","LLC","LLP","LLLP","LP","C_CORPORATION","S_CORPORATION","B_CORPORATION","NONPROFIT","COOPERATIVE","TRUST","PROFESSIONAL_ASSOCIATION","PROFESSIONAL_CORPORATION","TRADE_NAME","BANK","CREDIT_UNION","INSURANCE","OTHER"],"uniqueKey":"incorporation.structure.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Legal structure, when known.","uniqueKey":"incorporation.structure.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.structure","typeLabel":"enum\u003cstring> | null"},"sos_status":{"oneOf":[{"type":"string","title":"SOSStatus","description":"The registry's standing for the entity, when known.","enum":["GOOD_STANDING","NOT_GOOD_STANDING","SS","FD"],"uniqueKey":"incorporation.sos_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The registry's standing for the entity, when known.","uniqueKey":"incorporation.sos_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.sos_status","typeLabel":"enum\u003cstring> | null"},"dissolution_date":{"oneOf":[{"type":"string","title":"Dissolution Date","description":"Date of dissolution, when the entity has one.","format":"date","uniqueKey":"incorporation.dissolution_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Dissolution Date","description":"Date of dissolution, when the entity has one.","uniqueKey":"incorporation.dissolution_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"incorporation.dissolution_date","typeLabel":"string\u003cdate> | null"}},"required":["state","filing_number"],"title":"BusinessIncorporationResponse (v1)","type":"object","isRequired":true,"uniqueKey":"incorporation","typeLabel":"BusinessIncorporationResponse (v1) · object"},"credentials":{"description":"This organization's agent credentials for the business.","properties":{"issued_30d":{"description":"Agent credentials issued in the last 30 days.","title":"Issued 30D","type":"integer","isRequired":true,"uniqueKey":"credentials.issued_30d","typeLabel":"integer"},"active":{"description":"Agent credentials neither revoked nor expired.","title":"Active","type":"integer","isRequired":true,"uniqueKey":"credentials.active","typeLabel":"integer"},"revoked_30d":{"description":"Agent credentials revoked in the last 30 days.","title":"Revoked 30D","type":"integer","isRequired":true,"uniqueKey":"credentials.revoked_30d","typeLabel":"integer"}},"required":["issued_30d","active","revoked_30d"],"title":"CredentialSummaryResponse (v1)","type":"object","isRequired":true,"uniqueKey":"credentials","typeLabel":"CredentialSummaryResponse (v1) · object"},"not_verified_reason":{"oneOf":[{"type":"string","title":"BusinessNotVerifiedReason","description":"VERIFICATION_INCOMPLETE when the check never finished; null otherwise.","enum":["VERIFICATION_INCOMPLETE"],"uniqueKey":"not_verified_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"VERIFICATION_INCOMPLETE when the check never finished; null otherwise.","uniqueKey":"not_verified_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"not_verified_reason","typeLabel":"enum\u003cstring> | null"},"checks_unavailable_reason":{"oneOf":[{"type":"string","title":"BusinessChecksUnavailableReason","description":"EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (`kyb_outcome` still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.","enum":["EVIDENCE_UNAVAILABLE","NO_CONFIRMED_VERIFICATION"],"uniqueKey":"checks_unavailable_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"EVIDENCE_UNAVAILABLE when the evaluation behind the latest confirmation can no longer be read (`kyb_outcome` still stands, as the confirmation recorded it); NO_CONFIRMED_VERIFICATION when this organization holds no confirmation of the business.","uniqueKey":"checks_unavailable_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"checks_unavailable_reason","typeLabel":"enum\u003cstring> | null"},"last_verified_at":{"oneOf":[{"type":"string","title":"Last Verified At","description":"When this organization's latest confirmation was recorded.","format":"date-time","uniqueKey":"last_verified_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Verified At","description":"When this organization's latest confirmation was recorded.","uniqueKey":"last_verified_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_verified_at","typeLabel":"string\u003cdate-time> | null"},"available_disclosure_paths":{"description":"The subject-relative credential disclosure paths the business's records can populate, hash leaves included (e.g. `hashes.ein`). Paths only, never values. A requested path missing here is skipped at mint, not refused. The acting person's `actor.*` paths are on their person profile without the `actor.` prefix.","items":{"type":"string","uniqueKey":"available_disclosure_paths.items.[INDEX]","typeLabel":"string"},"title":"Available Disclosure Paths","type":"array","uniqueKey":"available_disclosure_paths","typeLabel":"string[]"},"people":{"description":"People this organization holds covered operator links for, each with their pairwise ref and link status.","items":{"description":"One person the calling organization holds an operator link for — the\nmirror of the person profile's business links.","properties":{"status":{"description":"Your organization's current status for the link.","enum":["VERIFIED","UNDER_REVIEW","REJECTED"],"title":"BusinessOperatorLinkStatus","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"created_at":{"description":"When the link was first recorded.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"individual_ref":{"description":"Pairwise reference to the linked individual.","title":"Individual Ref","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].individual_ref","typeLabel":"string"},"review_flagged_at":{"oneOf":[{"type":"string","title":"Review Flagged At","description":"When a later evaluation flagged this verified link for review; null when it never was.","format":"date-time","uniqueKey":"people.items.[INDEX].review_flagged_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Review Flagged At","description":"When a later evaluation flagged this verified link for review; null when it never was.","uniqueKey":"people.items.[INDEX].review_flagged_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].review_flagged_at","typeLabel":"string\u003cdate-time> | null"},"decided_at":{"oneOf":[{"type":"string","title":"Decided At","description":"When your organization last verified or rejected the link by hand; null while only the evidence has decided it.","format":"date-time","uniqueKey":"people.items.[INDEX].decided_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Decided At","description":"When your organization last verified or rejected the link by hand; null while only the evidence has decided it.","uniqueKey":"people.items.[INDEX].decided_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decided_at","typeLabel":"string\u003cdate-time> | null"},"decided_by":{"oneOf":[{"type":"object","title":"ActedBy (v1)","description":"Who made that decision, as stamped when they made it; null when no one has.","required":["kind","label"],"properties":{"kind":{"description":"`USER` for a console user, `API_KEY` for a key.","enum":["USER","API_KEY"],"title":"ActedByKind","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"label":{"description":"The user's first and last name or the API key's name, as they were when they acted; never rewritten by a later rename or deletion.","title":"Label","type":"string","isRequired":true,"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0.label","typeLabel":"string"}},"uniqueKey":"people.items.[INDEX].decided_by.oneOf.0","typeLabel":"ActedBy (v1) · object"},{"type":"null","description":"Who made that decision, as stamped when they made it; null when no one has.","uniqueKey":"people.items.[INDEX].decided_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decided_by","typeLabel":"ActedBy (v1) · object | null"},"decision_reason":{"oneOf":[{"type":"string","title":"Decision Reason","description":"The reason recorded with that decision, if any.","uniqueKey":"people.items.[INDEX].decision_reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Decision Reason","description":"The reason recorded with that decision, if any.","uniqueKey":"people.items.[INDEX].decision_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].decision_reason","typeLabel":"string | null"},"source_verification_id":{"oneOf":[{"type":"string","title":"Source Verification Id","description":"The verification that established the link; null when that verification no longer exists. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","format":"uuid","uniqueKey":"people.items.[INDEX].source_verification_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Source Verification Id","description":"The verification that established the link; null when that verification no longer exists. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","uniqueKey":"people.items.[INDEX].source_verification_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].source_verification_id","typeLabel":"string\u003cuuid> | null"},"display_name":{"oneOf":[{"type":"string","title":"Display Name","description":"The individual's verified name from your organization's current verification; null when it has been superseded and not yet replaced.","uniqueKey":"people.items.[INDEX].display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Display Name","description":"The individual's verified name from your organization's current verification; null when it has been superseded and not yet replaced.","uniqueKey":"people.items.[INDEX].display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"people.items.[INDEX].display_name","typeLabel":"string | null"}},"required":["status","created_at","individual_ref"],"title":"BusinessOperatorLinkResponse (v1)","type":"object","uniqueKey":"people.items.[INDEX]","typeLabel":"BusinessOperatorLinkResponse (v1) · object"},"title":"People","type":"array","uniqueKey":"people","typeLabel":"BusinessOperatorLinkResponse (v1) · object[]"},"submissions":{"description":"This organization's approved sessions that covered the business, newest first.","items":{"description":"One verification attempt in a profile's submission history, direct or\nhosted, reduced to the row a history timeline renders.","properties":{"verification_id":{"description":"Id of the verification. A direct verification reads at `GET /issuance/identities/verifications/{verification_id}`; a hosted one is an onboarding session and reads at `GET /onboarding/sessions/{session_id}`.","format":"uuid","title":"Verification Id","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].verification_id","typeLabel":"string\u003cuuid>"},"state":{"description":"Lifecycle state of the verification workflow.","enum":["PENDING","EXECUTING","WAITING","COMPLETED","FAILED","EXPIRED"],"title":"VerificationState","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"created_at":{"description":"When the submission was accepted.","format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"verdict":{"oneOf":[{"type":"string","title":"OnboardingVerdict","description":"Resolved onboarding verdict; null until completion.","enum":["APPROVED","UNDER_REVIEW","REJECTED"],"uniqueKey":"submissions.items.[INDEX].verdict.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Resolved onboarding verdict; null until completion.","uniqueKey":"submissions.items.[INDEX].verdict.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].verdict","typeLabel":"enum\u003cstring> | null"},"reference_id":{"oneOf":[{"type":"string","title":"Reference Id","description":"Caller-supplied correlation id.","uniqueKey":"submissions.items.[INDEX].reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reference Id","description":"Caller-supplied correlation id.","uniqueKey":"submissions.items.[INDEX].reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].reference_id","typeLabel":"string | null"},"completed_at":{"oneOf":[{"type":"string","title":"Completed At","description":"When the workflow reached a terminal state.","format":"date-time","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Completed At","description":"When the workflow reached a terminal state.","uniqueKey":"submissions.items.[INDEX].completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].completed_at","typeLabel":"string\u003cdate-time> | null"},"terminal_reason":{"oneOf":[{"type":"object","title":"IdentitySubmissionTerminalReasonResponse (v1)","description":"Typed state and detail when the workflow ended in FAILED; null otherwise.","required":["state"],"properties":{"state":{"description":"Terminal workflow state.","enum":["FAILED"],"title":"TerminalReasonState","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.state","typeLabel":"enum\u003cstring>"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Human-readable detail recorded by the workflow.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Human-readable detail recorded by the workflow.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0.message","typeLabel":"string | null"}},"uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.0","typeLabel":"IdentitySubmissionTerminalReasonResponse (v1) · object"},{"type":"null","description":"Typed state and detail when the workflow ended in FAILED; null otherwise.","uniqueKey":"submissions.items.[INDEX].terminal_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].terminal_reason","typeLabel":"IdentitySubmissionTerminalReasonResponse (v1) · object | null"},"journey_name":{"oneOf":[{"type":"string","title":"Journey Name","description":"The name of this organization's journey the session ran; null for a session started through the API.","uniqueKey":"submissions.items.[INDEX].journey_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Journey Name","description":"The name of this organization's journey the session ran; null for a session started through the API.","uniqueKey":"submissions.items.[INDEX].journey_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].journey_name","typeLabel":"string | null"},"decided_by":{"oneOf":[{"type":"object","title":"ActedBy (v1)","description":"Who decided the session on review, as they were named when they decided; null when it was decided automatically.","required":["kind","label"],"properties":{"kind":{"description":"`USER` for a console user, `API_KEY` for a key.","enum":["USER","API_KEY"],"title":"ActedByKind","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"label":{"description":"The user's first and last name or the API key's name, as they were when they acted; never rewritten by a later rename or deletion.","title":"Label","type":"string","isRequired":true,"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0.label","typeLabel":"string"}},"uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.0","typeLabel":"ActedBy (v1) · object"},{"type":"null","description":"Who decided the session on review, as they were named when they decided; null when it was decided automatically.","uniqueKey":"submissions.items.[INDEX].decided_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].decided_by","typeLabel":"ActedBy (v1) · object | null"}},"required":["verification_id","state","created_at"],"title":"IdentitySubmissionHistoryItemResponse (v1)","type":"object","uniqueKey":"submissions.items.[INDEX]","typeLabel":"IdentitySubmissionHistoryItemResponse (v1) · object"},"title":"Submissions","type":"array","uniqueKey":"submissions","typeLabel":"IdentitySubmissionHistoryItemResponse (v1) · object[]"}},"required":["business_ref","legal_name","kyb_outcome","checks","incorporation","credentials"],"title":"BusinessIdentityStatusResponse (v1)","type":"object","uniqueKey":"","typeLabel":"BusinessIdentityStatusResponse (v1) · object"},"examples":{"Example":{"title":"Example","value":{"business_ref":"\u003cstring>","legal_name":"\u003cstring>","kyb_outcome":"VERIFIED","checks":[{"key":"REGISTRY_RECORD_FOUND","result":"PASSED"}],"incorporation":{"state":"AL","filing_number":"\u003cstring>","incorporation_date":"2023-12-25","structure":"SOLE_PROPRIETORSHIP","sos_status":"GOOD_STANDING","dissolution_date":"2023-12-25"},"credentials":{"issued_30d":123,"active":123,"revoked_30d":123},"not_verified_reason":"VERIFICATION_INCOMPLETE","checks_unavailable_reason":"EVIDENCE_UNAVAILABLE","last_verified_at":"2023-11-07T05:31:56Z","available_disclosure_paths":["\u003cstring>"],"people":[{"status":"VERIFIED","created_at":"2023-11-07T05:31:56Z","individual_ref":"\u003cstring>","review_flagged_at":"2023-11-07T05:31:56Z","decided_at":"2023-11-07T05:31:56Z","decided_by":{"kind":"USER","label":"\u003cstring>"},"decision_reason":"\u003cstring>","source_verification_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":"\u003cstring>"}],"submissions":[{"verification_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","state":"PENDING","created_at":"2023-11-07T05:31:56Z","verdict":"APPROVED","reference_id":"\u003cstring>","completed_at":"2023-11-07T05:31:56Z","terminal_reason":{"state":"FAILED","message":"\u003cstring>"},"journey_name":"\u003cstring>","decided_by":{"kind":"USER","label":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"9c5be1d8-fb24-4143-98e4-b31a73596621":{"description":"The business_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 human 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"},"c899b70a-dcca-4837-8d1a-d68033807e91":{"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 human 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":{"d060b278-41bb-4c67-b024-c642d6b7741e":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"788562d2-18e0-4de1-8ca6-c9b3fd720b2d":{"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 a verified business by pairwise reference - Baselayer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T05:45:39.820Z","originalFileLocation":"api-reference/identities/look-up-a-verified-business-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 what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. 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 a verified business by pairwise reference - Baselayer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. 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-a-verified-business-by-pairwise-reference\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://baselayer-81245324.mintlify.app/_mintlify/api/og/v2?division=Verified+Identities\u0026amp;title=Look+up+a+verified+business+by+pairwise+reference\u0026amp;description=Returns+what+the+latest+onboarding+session+that+covered+the+business+attested+to%2C+the+registry+incorporation+facts%2C+the+people+you+hold+covered+operator+links+f\u0026amp;theme=da3e09036423c5729d7edf96\u0026amp;signature=2058da41f793a739954c887c33a479613fc554431b8f6f9a3bff5fc3492d5cbc\">\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 a verified business by pairwise reference - Baselayer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. References issued to other organizations and unknown references are indistinguishable 404s.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://baselayer-81245324.mintlify.app/_mintlify/api/og/v2?division=Verified+Identities\u0026amp;title=Look+up+a+verified+business+by+pairwise+reference\u0026amp;description=Returns+what+the+latest+onboarding+session+that+covered+the+business+attested+to%2C+the+registry+incorporation+facts%2C+the+people+you+hold+covered+operator+links+f\u0026amp;theme=da3e09036423c5729d7edf96\u0026amp;signature=2058da41f793a739954c887c33a479613fc554431b8f6f9a3bff5fc3492d5cbc\">\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-a-verified-business-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-a-verified-business-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-a-verified-business-by-pairwise-reference#webpage\",\"url\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference\",\"name\":\"Look up a verified business by pairwise reference\",\"description\":\"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. References issued to other organizations and unknown references are indistinguishable 404s.\",\"dateModified\":\"2026-10-29T05:45:39.820Z\",\"isPartOf\":{\"@id\":\"https://docs.baselayer.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-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/list-the-individuals-your-organization-has-verified\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Look up a verified business by pairwise reference\",\"item\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference#apireference\",\"headline\":\"Look up a verified business by pairwise reference\",\"name\":\"Look up a verified business by pairwise reference\",\"description\":\"Returns what the latest onboarding session that covered the business attested to, the registry incorporation facts, the people you hold covered operator links for, outstanding counterparty credentials, and your submission history for a business_ref issued to your organization. References issued to other organizations and unknown references are indistinguishable 404s.\",\"url\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference\",\"mainEntityOfPage\":{\"@id\":\"https://docs.baselayer.com/api-reference/identities/look-up-a-verified-business-by-pairwise-reference#webpage\"},\"dateModified\":\"2026-10-29T05:45:39.820Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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 an L3 mint would disclose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/preview","href":"/api-reference/credentials/preview-what-an-l3-mint-would-disclose"},{"title":"List the presets an L3 mint can disclose by","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/credentials/presets","href":"/api-reference/credentials/list-the-presets-an-l3-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 an L3 test mint would disclose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/credentials/test/preview","href":"/api-reference/credentials/preview-what-an-l3-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":"List the individuals your organization has verified","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals","href":"/api-reference/identities/list-the-individuals-your-organization-has-verified"},{"title":"Look up a verified identity by pairwise reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issuance/identities/individuals/{individual_ref}","href":"/api-reference/identities/look-up-a-verified-identity-by-pairwise-reference"},{"title":"Re-verify an identity from its stored verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /issuance/identities/individuals/{individual_ref}/reverify","href":"/api-reference/identities/re-verify-an-identity-from-its-stored-verification"},{"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","description":"Lists the individual-operates-business links your organization's sessions recorded, oldest first by default, naming both ends by your own references. Filter by `status=UNDER_REVIEW` for the links waiting on your decision; `shortfalls` says what each one's newest evaluation fell short on.","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}/decide","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"}]}]},{"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/texas-comptroller-franchise-tax-standing"}]}]},"basePath":"","title":"Look up a verified business by pairwise reference - Baselayer","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}