Project-scoped API key for server-to-server authentication.
Obtain keys from the Zenoo dashboard under Project Settings > API Keys.
Staging and production environments use separate keys.
Unique key for idempotent request handling. If a request with the same key
was already processed within the last 24 hours, the original response is returned.
A person or company entity under compliance investigation. Entities are the
subjects of verification checks and may generate alerts when screening matches
are found. An entity can belong to multiple cases with different roles.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Zenoo Developer Docs","colors":{"primary":"#6450FA","light":"#7B6AFB","dark":"#5040C8"},"logo":{"light":"https://mintcdn.com/zenoo/aPkOkrWFCjQlbbjO/logo/light.svg?fit=max\u0026auto=format\u0026n=aPkOkrWFCjQlbbjO\u0026q=85\u0026s=69bb3621a059829957546a0adfa17e56","dark":"https://mintcdn.com/zenoo/aPkOkrWFCjQlbbjO/logo/dark.svg?fit=max\u0026auto=format\u0026n=aPkOkrWFCjQlbbjO\u0026q=85\u0026s=0b6936a612c3cf41213ec8ceef343b44","href":"https://zenoo.com"},"favicon":"https://mintcdn.com/zenoo/KxJT8X9N8qZ6jIrQ/favicon.png?fit=max\u0026auto=format\u0026n=KxJT8X9N8qZ6jIrQ\u0026q=85\u0026s=91e7f169e13f014b4a51930b5c97d77f","background":{"decoration":"gradient","color":{"light":"#FAFAFA","dark":"#0F0F1A"}},"navbar":{"links":[{"href":"mailto:support@zenoo.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.zenoo.com"}},"footer":{"socials":{"website":"https://zenoo.com","linkedin":"https://linkedin.com/company/zenoo"}},"fonts":{"heading":{"family":"Inter","weight":700},"body":{"family":"Inter","weight":400}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog/2026-10"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zenoo","hasAudioNarration":false,"actualSubdomain":"zenoo","customDomains":["docs.zenoo.com"],"gitSource":{"type":"github","owner":"zenoolabs","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae32bf34c2492fe62cb4b8a","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":55},{"language":"default","tag":"Resources","count":51},{"language":"default","tag":"Developer Docs","count":45},{"language":"default","tag":"Changelog","count":42},{"language":"default","tag":"Product Guides","count":19},{"language":"default","tag":"Data Model","count":18},{"language":"default","tag":"Cases","count":18},{"language":"default","tag":"Alerts","count":11},{"language":"default","tag":"Compliance Hub","count":10},{"language":"default","tag":"Platform Concepts","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[class*=\"Card\"]{transition:transform 0.2s ease, box-shadow 0.2s ease}[class*=\"Card\"]:hover{transform:translateY(-2px);box-shadow:0 4px 12px rgba(100, 80, 250, 0.08)}pre{border-radius:8px!important}table tbody tr:nth-child(even){background-color:rgba(100, 80, 250, 0.02)}[class*=\"callout\"],[class*=\"Callout\"]{border-left:3px solid #6450FA}.step .rounded-full{background-color:#6450FA!important;color:white!important;font-weight:700!important}.step .rounded-full svg{color:white!important}:is(.dark) .step .rounded-full{background-color:#6450FA!important;color:white!important}ol:not(.steps){list-style:none!important;counter-reset:branded-counter!important}ol:not(.steps)>li{counter-increment:branded-counter!important;position:relative!important;padding-left:2.75em!important}ol:not(.steps)>li::before{content:counter(branded-counter)!important;position:absolute!important;left:0!important;top:0.15em;width:1.6em;height:1.6em;background-color:#6450FA!important;color:white!important;font-weight:700!important;font-size:0.8em;border-radius:50%;display:flex;align-items:center;justify-content:center;line-height:1}"}],"page":{"pagePath":"api-reference/entities/create-person-or-company-entity","slug":"/api-reference/entities/create-person-or-company-entity","pageMetadata":{"title":"Create person or company entity","description":"Create a new entity for compliance investigation. The entity type determines\nwhich fields are required and which checks can be executed.\n\n**Person entities** require `first_name`, `last_name`, and at least one of\n`date_of_birth` or `nationality` for effective screening.\n\n**Company entities** require `company_name` and `country`. Include\n`registration_number` for registry lookups.\n","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/entities","href":"/api-reference/entities/create-person-or-company-entity","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a new entity for compliance investigation. The entity type determines\\nwhich fields are required and which checks can be executed.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Person entities\"\n }), \" require \", _jsx(_components.code, {\n children: \"first_name\"\n }), \", \", _jsx(_components.code, {\n children: \"last_name\"\n }), \", and at least one of\\n\", _jsx(_components.code, {\n children: \"date_of_birth\"\n }), \" or \", _jsx(_components.code, {\n children: \"nationality\"\n }), \" for effective screening.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Company entities\"\n }), \" require \", _jsx(_components.code, {\n children: \"company_name\"\n }), \" and \", _jsx(_components.code, {\n children: \"country\"\n }), \". Include\\n\", _jsx(_components.code, {\n children: \"registration_number\"\n }), \" for registry lookups.\"]\n })]\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":"Create person or company entity","description":"Create a new entity for compliance investigation. The entity type determines\nwhich fields are required and which checks can be executed.\n\n**Person entities** require `first_name`, `last_name`, and at least one of\n`date_of_birth` or `nationality` for effective screening.\n\n**Company entities** require `company_name` and `country`. Include\n`registration_number` for registry lookups.\n","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/entities","href":"/api-reference/entities/create-person-or-company-entity","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Entities"],"operationId":"createEntity","summary":"Create person or company entity","description":"Create a new entity for compliance investigation. The entity type determines\nwhich fields are required and which checks can be executed.\n\n**Person entities** require `first_name`, `last_name`, and at least one of\n`date_of_birth` or `nationality` for effective screening.\n\n**Company entities** require `company_name` and `country`. Include\n`registration_number` for registry lookups.\n","parameters":["92264391-4069-4d8d-8dac-87bb3130b3e7"],"requestBody":"7049aab4-c113-4fb2-a10a-ffab04484288","responses":{"201":"94a2f5e7-d645-4c22-93fb-4d4177b38870","400":"a1730751-11ca-44ef-9061-9aaed765672e","401":"170b9723-3398-4f90-9e28-1ecac1e8519a","422":"09932fff-2a61-4452-b3f3-2e07eb612e5a","429":"8eca42ac-85bb-4282-8f5a-e33ae72add47","500":"389e207c-d073-4b4b-87ae-5818cadc5c4a"},"method":"post","type":"path","servers":["987b715d-d6bb-4450-9859-26c48488df55","7fc40a7e-1910-4a49-b6cb-e18409f12dcb","2bdc34a2-f91b-4356-bcf4-ebf8acef88f3"],"security":["aec158b7-575f-4664-8129-8ea63a7593cd"],"path":"/v1/entities","baseUrlOptions":["https://instance.prod.onboardapp.io","https://instance.staging.onboardapp.io","https://api.zenoo.com"],"title":"Create person or company entity","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"92264391-4069-4d8d-8dac-87bb3130b3e7":{"name":"Idempotency-Key","in":"header","description":"Unique key for idempotent request handling. If a request with the same key\nwas already processed within the last 24 hours, the original response is returned.\n","schema":{"type":"string","format":"uuid","description":"Unique key for idempotent request handling. If a request with the same key\nwas already processed within the last 24 hours, the original response is returned.\n","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request body for creating a new entity.","properties":{"type":{"type":"string","enum":["Person","Company"],"description":"Entity type.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"first_name":{"type":"string","description":"Person first name (required for Person type).","uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Person last name (required for Person type).","uniqueKey":"last_name","typeLabel":"string"},"date_of_birth":{"type":"string","format":"date","description":"Person date of birth (YYYY-MM-DD).","uniqueKey":"date_of_birth","typeLabel":"string\u003cdate>"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 nationality code.","uniqueKey":"nationality","typeLabel":"string"},"company_name":{"type":"string","description":"Company legal name (required for Company type).","uniqueKey":"company_name","typeLabel":"string"},"registration_number":{"type":"string","description":"Company registration number.","uniqueKey":"registration_number","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","uniqueKey":"country","typeLabel":"string"},"address":{"type":"object","description":"Structured address.","properties":{"line1":{"type":"string","description":"Street address line 1.","uniqueKey":"address.line1","typeLabel":"string"},"line2":{"type":"string","description":"Street address line 2.","uniqueKey":"address.line2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"address.city","typeLabel":"string"},"state":{"type":"string","description":"State, province, or region.","uniqueKey":"address.state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"address.postal_code","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","uniqueKey":"address.country","typeLabel":"string"}},"uniqueKey":"address","typeLabel":"object"},"external_reference":{"type":"string","description":"Your internal reference ID. Used for idempotency.","maxLength":255,"uniqueKey":"external_reference","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"description":"Arbitrary key-value metadata.","uniqueKey":"metadata","typeLabel":"object"}},"required":["type"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"first_name":"\u003cstring>","last_name":"\u003cstring>","date_of_birth":"2023-12-25","nationality":"\u003cstring>","company_name":"\u003cstring>","registration_number":"\u003cstring>","country":"\u003cstring>","address":{"line1":"\u003cstring>","line2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","country":"\u003cstring>"},"external_reference":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"94a2f5e7-d645-4c22-93fb-4d4177b38870":{"description":"Entity created.","content":{"application/json":{"schema":{"type":"object","description":"Standard response wrapper for all API endpoints. Contains the resource\ndata and pagination metadata.\n","properties":{"data":{"type":"object","description":"A person or company entity under compliance investigation. Entities are the\nsubjects of verification checks and may generate alerts when screening matches\nare found. An entity can belong to multiple cases with different roles.\n","properties":{"token":{"type":"string","description":"Unique entity identifier with `ent_` prefix.","example":"ent_8f3k2m1n","uniqueKey":"data.token","typeLabel":"string"},"type":{"type":"string","enum":["Person","Company"],"description":"Entity type — determines which fields are applicable.","uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"first_name":{"type":"string","description":"Person first name. Present only for Person entities.","example":"John","uniqueKey":"data.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Person last name. Present only for Person entities.","example":"Smith","uniqueKey":"data.last_name","typeLabel":"string"},"full_name":{"type":"string","description":"Computed full name. For persons: `first_name + last_name`.\nFor companies: same as `company_name`.\n","example":"John Smith","uniqueKey":"data.full_name","typeLabel":"string"},"company_name":{"type":"string","description":"Company legal name. Present only for Company entities.","uniqueKey":"data.company_name","typeLabel":"string"},"date_of_birth":{"type":"string","format":"date","description":"Person date of birth (YYYY-MM-DD). Present only for Person entities.","uniqueKey":"data.date_of_birth","typeLabel":"string\u003cdate>"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 nationality code. Present only for Person entities.","example":"GB","uniqueKey":"data.nationality","typeLabel":"string"},"registration_number":{"type":"string","description":"Company registration number. Present only for Company entities.","uniqueKey":"data.registration_number","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code for the entity's primary jurisdiction.","example":"GB","uniqueKey":"data.country","typeLabel":"string"},"role":{"type":"string","enum":["Primary","UBO","Director","Shareholder"],"description":"Entity's role within its case context.\n- `Primary` — The main subject of the investigation\n- `UBO` — Ultimate Beneficial Owner (>=25% ownership)\n- `Director` — Company director or officer\n- `Shareholder` — Shareholder below UBO threshold\n","uniqueKey":"data.role","typeLabel":"enum\u003cstring>"},"verification_status":{"type":"string","enum":["Not Started","In Progress","Verified","Expired","Failed"],"description":"Current verification status of the entity.\n- `Not Started` — No checks have been initiated\n- `In Progress` — Checks are currently running\n- `Verified` — All required checks passed\n- `Expired` — Verification has expired and needs renewal\n- `Failed` — One or more checks failed\n","uniqueKey":"data.verification_status","typeLabel":"enum\u003cstring>"},"address":{"type":"object","description":"Structured address.","properties":{"line1":{"type":"string","description":"Street address line 1.","uniqueKey":"data.address.line1","typeLabel":"string"},"line2":{"type":"string","description":"Street address line 2.","uniqueKey":"data.address.line2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"data.address.city","typeLabel":"string"},"state":{"type":"string","description":"State, province, or region.","uniqueKey":"data.address.state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"data.address.postal_code","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","uniqueKey":"data.address.country","typeLabel":"string"}},"uniqueKey":"data.address","typeLabel":"object"},"checks_summary":{"type":"object","description":"Summary counts of associated checks.","properties":{"total":{"type":"integer","uniqueKey":"data.checks_summary.total","typeLabel":"integer"},"complete":{"type":"integer","uniqueKey":"data.checks_summary.complete","typeLabel":"integer"},"pending":{"type":"integer","uniqueKey":"data.checks_summary.pending","typeLabel":"integer"},"failed":{"type":"integer","uniqueKey":"data.checks_summary.failed","typeLabel":"integer"}},"uniqueKey":"data.checks_summary","typeLabel":"object"},"alerts_summary":{"type":"object","description":"Summary counts of associated alerts.","properties":{"total":{"type":"integer","uniqueKey":"data.alerts_summary.total","typeLabel":"integer"},"open":{"type":"integer","uniqueKey":"data.alerts_summary.open","typeLabel":"integer"},"resolved":{"type":"integer","uniqueKey":"data.alerts_summary.resolved","typeLabel":"integer"}},"uniqueKey":"data.alerts_summary","typeLabel":"object"},"external_reference":{"type":"string","description":"Your internal reference ID for this entity.","uniqueKey":"data.external_reference","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"When the entity was created (ISO 8601).","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the entity was last updated (ISO 8601).","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique request identifier for debugging and support.","example":"req_9k4m2n1p3q","uniqueKey":"meta.request_id","typeLabel":"string"},"page":{"type":"object","description":"Pagination metadata (present on list endpoints).","properties":{"cursor":{"oneOf":[{"type":"string","description":"Cursor for fetching the next page. Null if no more pages.","uniqueKey":"meta.page.cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Cursor for fetching the next page. Null if no more pages.","uniqueKey":"meta.page.cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.page.cursor","typeLabel":"string | null"},"has_more":{"type":"boolean","description":"Whether more results are available.","uniqueKey":"meta.page.has_more","typeLabel":"boolean"}},"uniqueKey":"meta.page","typeLabel":"object"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"token":"ent_8f3k2m1n","type":"Person","first_name":"John","last_name":"Smith","full_name":"John Smith","company_name":"\u003cstring>","date_of_birth":"2023-12-25","nationality":"GB","registration_number":"\u003cstring>","country":"GB","role":"Primary","verification_status":"Not Started","address":{"line1":"\u003cstring>","line2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","country":"\u003cstring>"},"checks_summary":{"total":123,"complete":123,"pending":123,"failed":123},"alerts_summary":{"total":123,"open":123,"resolved":123},"external_reference":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"},"meta":{"request_id":"req_9k4m2n1p3q","page":{"cursor":"\u003cstring>","has_more":true}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a1730751-11ca-44ef-9061-9aaed765672e":{"description":"Invalid request — check the error details for field-level validation errors.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response. All errors include a machine-readable `code`,\nhuman-readable `message`, and a `request_id` for support troubleshooting.\n","properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic error handling.\n\n| Code | HTTP | Description | Retry? |\n|------|------|-------------|--------|\n| `VALIDATION_ERROR` | 400 | Malformed request body or parameters | No |\n| `INVALID_JSON` | 400 | Request body is not valid JSON | No |\n| `UNAUTHORIZED` | 401 | Invalid or missing API key | No |\n| `FORBIDDEN` | 403 | Insufficient permissions | No |\n| `NOT_FOUND` | 404 | Resource does not exist | No |\n| `TOKEN_EXPIRED` | 404 | Pull or start token has expired | No |\n| `RATE_LIMITED` | 429 | Rate limit exceeded | Yes (after reset) |\n| `INTERNAL_ERROR` | 500 | Unexpected server error | Yes (with backoff) |\n| `PROVIDER_ERROR` | 502 | External provider failure | Yes (with backoff) |\n| `SERVICE_UNAVAILABLE` | 503 | Service temporarily unavailable | Yes (with backoff) |\n","enum":["VALIDATION_ERROR","INVALID_JSON","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","TOKEN_EXPIRED","RATE_LIMITED","INTERNAL_ERROR","PROVIDER_ERROR","SERVICE_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier. Include this when contacting Zenoo support\nfor faster issue resolution.\n","example":"req_9k4m2n1p3q","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","description":"Field-level validation errors (present for `validation_error`).","items":{"type":"object","properties":{"field":{"type":"string","description":"JSON path to the invalid field.","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Description of the validation failure.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Field-level error code (e.g., `required`, `invalid_format`).","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","request_id":"req_9k4m2n1p3q","details":[{"field":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"170b9723-3398-4f90-9e28-1ecac1e8519a":{"description":"Missing or invalid authentication credentials.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response. All errors include a machine-readable `code`,\nhuman-readable `message`, and a `request_id` for support troubleshooting.\n","properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic error handling.\n\n| Code | HTTP | Description | Retry? |\n|------|------|-------------|--------|\n| `VALIDATION_ERROR` | 400 | Malformed request body or parameters | No |\n| `INVALID_JSON` | 400 | Request body is not valid JSON | No |\n| `UNAUTHORIZED` | 401 | Invalid or missing API key | No |\n| `FORBIDDEN` | 403 | Insufficient permissions | No |\n| `NOT_FOUND` | 404 | Resource does not exist | No |\n| `TOKEN_EXPIRED` | 404 | Pull or start token has expired | No |\n| `RATE_LIMITED` | 429 | Rate limit exceeded | Yes (after reset) |\n| `INTERNAL_ERROR` | 500 | Unexpected server error | Yes (with backoff) |\n| `PROVIDER_ERROR` | 502 | External provider failure | Yes (with backoff) |\n| `SERVICE_UNAVAILABLE` | 503 | Service temporarily unavailable | Yes (with backoff) |\n","enum":["VALIDATION_ERROR","INVALID_JSON","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","TOKEN_EXPIRED","RATE_LIMITED","INTERNAL_ERROR","PROVIDER_ERROR","SERVICE_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier. Include this when contacting Zenoo support\nfor faster issue resolution.\n","example":"req_9k4m2n1p3q","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","description":"Field-level validation errors (present for `validation_error`).","items":{"type":"object","properties":{"field":{"type":"string","description":"JSON path to the invalid field.","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Description of the validation failure.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Field-level error code (e.g., `required`, `invalid_format`).","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","request_id":"req_9k4m2n1p3q","details":[{"field":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"09932fff-2a61-4452-b3f3-2e07eb612e5a":{"description":"Request is well-formed but cannot be processed due to business logic constraints.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response. All errors include a machine-readable `code`,\nhuman-readable `message`, and a `request_id` for support troubleshooting.\n","properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic error handling.\n\n| Code | HTTP | Description | Retry? |\n|------|------|-------------|--------|\n| `VALIDATION_ERROR` | 400 | Malformed request body or parameters | No |\n| `INVALID_JSON` | 400 | Request body is not valid JSON | No |\n| `UNAUTHORIZED` | 401 | Invalid or missing API key | No |\n| `FORBIDDEN` | 403 | Insufficient permissions | No |\n| `NOT_FOUND` | 404 | Resource does not exist | No |\n| `TOKEN_EXPIRED` | 404 | Pull or start token has expired | No |\n| `RATE_LIMITED` | 429 | Rate limit exceeded | Yes (after reset) |\n| `INTERNAL_ERROR` | 500 | Unexpected server error | Yes (with backoff) |\n| `PROVIDER_ERROR` | 502 | External provider failure | Yes (with backoff) |\n| `SERVICE_UNAVAILABLE` | 503 | Service temporarily unavailable | Yes (with backoff) |\n","enum":["VALIDATION_ERROR","INVALID_JSON","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","TOKEN_EXPIRED","RATE_LIMITED","INTERNAL_ERROR","PROVIDER_ERROR","SERVICE_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier. Include this when contacting Zenoo support\nfor faster issue resolution.\n","example":"req_9k4m2n1p3q","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","description":"Field-level validation errors (present for `validation_error`).","items":{"type":"object","properties":{"field":{"type":"string","description":"JSON path to the invalid field.","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Description of the validation failure.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Field-level error code (e.g., `required`, `invalid_format`).","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","request_id":"req_9k4m2n1p3q","details":[{"field":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"8eca42ac-85bb-4282-8f5a-e33ae72add47":{"description":"Rate limit exceeded. Retry after the time indicated in the `X-RateLimit-Reset` header.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response. All errors include a machine-readable `code`,\nhuman-readable `message`, and a `request_id` for support troubleshooting.\n","properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic error handling.\n\n| Code | HTTP | Description | Retry? |\n|------|------|-------------|--------|\n| `VALIDATION_ERROR` | 400 | Malformed request body or parameters | No |\n| `INVALID_JSON` | 400 | Request body is not valid JSON | No |\n| `UNAUTHORIZED` | 401 | Invalid or missing API key | No |\n| `FORBIDDEN` | 403 | Insufficient permissions | No |\n| `NOT_FOUND` | 404 | Resource does not exist | No |\n| `TOKEN_EXPIRED` | 404 | Pull or start token has expired | No |\n| `RATE_LIMITED` | 429 | Rate limit exceeded | Yes (after reset) |\n| `INTERNAL_ERROR` | 500 | Unexpected server error | Yes (with backoff) |\n| `PROVIDER_ERROR` | 502 | External provider failure | Yes (with backoff) |\n| `SERVICE_UNAVAILABLE` | 503 | Service temporarily unavailable | Yes (with backoff) |\n","enum":["VALIDATION_ERROR","INVALID_JSON","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","TOKEN_EXPIRED","RATE_LIMITED","INTERNAL_ERROR","PROVIDER_ERROR","SERVICE_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier. Include this when contacting Zenoo support\nfor faster issue resolution.\n","example":"req_9k4m2n1p3q","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","description":"Field-level validation errors (present for `validation_error`).","items":{"type":"object","properties":{"field":{"type":"string","description":"JSON path to the invalid field.","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Description of the validation failure.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Field-level error code (e.g., `required`, `invalid_format`).","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","request_id":"req_9k4m2n1p3q","details":[{"field":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"X-RateLimit-Limit":{"description":"Maximum requests allowed per minute for your plan.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current rate limit window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the rate limit window resets.","schema":{"type":"integer"}}},"exampleType":"generated"},"389e207c-d073-4b4b-87ae-5818cadc5c4a":{"description":"Unexpected server error. Include the `request_id` from the error response when contacting support.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response. All errors include a machine-readable `code`,\nhuman-readable `message`, and a `request_id` for support troubleshooting.\n","properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic error handling.\n\n| Code | HTTP | Description | Retry? |\n|------|------|-------------|--------|\n| `VALIDATION_ERROR` | 400 | Malformed request body or parameters | No |\n| `INVALID_JSON` | 400 | Request body is not valid JSON | No |\n| `UNAUTHORIZED` | 401 | Invalid or missing API key | No |\n| `FORBIDDEN` | 403 | Insufficient permissions | No |\n| `NOT_FOUND` | 404 | Resource does not exist | No |\n| `TOKEN_EXPIRED` | 404 | Pull or start token has expired | No |\n| `RATE_LIMITED` | 429 | Rate limit exceeded | Yes (after reset) |\n| `INTERNAL_ERROR` | 500 | Unexpected server error | Yes (with backoff) |\n| `PROVIDER_ERROR` | 502 | External provider failure | Yes (with backoff) |\n| `SERVICE_UNAVAILABLE` | 503 | Service temporarily unavailable | Yes (with backoff) |\n","enum":["VALIDATION_ERROR","INVALID_JSON","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","TOKEN_EXPIRED","RATE_LIMITED","INTERNAL_ERROR","PROVIDER_ERROR","SERVICE_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Unique request identifier. Include this when contacting Zenoo support\nfor faster issue resolution.\n","example":"req_9k4m2n1p3q","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","description":"Field-level validation errors (present for `validation_error`).","items":{"type":"object","properties":{"field":{"type":"string","description":"JSON path to the invalid field.","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Description of the validation failure.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","description":"Field-level error code (e.g., `required`, `invalid_format`).","uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"\u003cstring>","request_id":"req_9k4m2n1p3q","details":[{"field":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"aec158b7-575f-4664-8129-8ea63a7593cd":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Project-scoped API key for server-to-server authentication.\nObtain keys from the Zenoo dashboard under Project Settings > API Keys.\nStaging and production environments use separate keys.\n","scopes":[]}}},"servers":{"987b715d-d6bb-4450-9859-26c48488df55":{"url":"https://instance.prod.onboardapp.io","description":"Production (replace \"instance\" with your subdomain)"},"7fc40a7e-1910-4a49-b6cb-e18409f12dcb":{"url":"https://instance.staging.onboardapp.io","description":"Staging (replace \"instance\" with your subdomain)"},"2bdc34a2-f91b-4356-bcf4-ebf8acef88f3":{"url":"https://api.zenoo.com","description":"Case Management API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Project-scoped API key for server-to-server authentication.\nObtain keys from the Zenoo dashboard under Project Settings > API Keys.\nStaging and production environments use separate keys.\n","scopes":[]},"schema":{"title":"X-API-KEY","type":"string","description":"Project-scoped API key for server-to-server authentication.\nObtain keys from the Zenoo dashboard under Project Settings > API Keys.\nStaging and production environments use separate keys.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"zenoo-api-openapi.yaml"},"subdomain":"zenoo","siteName":"Zenoo Developer Docs","title":"Create person or company entity - Zenoo Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-16T13:04:11.542Z","originalFileLocation":"api-reference/entities/create-person-or-company-entity.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=\"Create a new entity for compliance investigation. The entity type determines which fields are required and which checks can be executed. Person entities require first_name, last_name, and at least one of date_of_birth or nationality for effective screening. Company entities require company_name and country. Include registration_number for registry lookups.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zenoo Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_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/zenoo/1KDs33eK7HxYitS9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create person or company entity - Zenoo Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new entity for compliance investigation. The entity type determines which fields are required and which checks can be executed. Person entities require first_name, last_name, and at least one of date_of_birth or nationality for effective screening. Company entities require company_name and country. Include registration_number for registry lookups.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zenoo Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zenoo.mintlify.site/_mintlify/api/og/v2?division=Entities\u0026amp;title=Create+person+or+company+entity\u0026amp;description=Create+a+new+entity+for+compliance+investigation.+The+entity+type+determines%0Awhich+fields+are+required+and+which+checks+can+be+executed.%0A%0A**Person+entities**+re\u0026amp;theme=4f3339ab8cf08c5d623f6c58\u0026amp;signature=99a41f1a9ef206407c471c45a8354d578065c656e2a74ac33135b4e97d711066\">\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=\"Create person or company entity - Zenoo Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new entity for compliance investigation. The entity type determines which fields are required and which checks can be executed. Person entities require first_name, last_name, and at least one of date_of_birth or nationality for effective screening. Company entities require company_name and country. Include registration_number for registry lookups.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zenoo.mintlify.site/_mintlify/api/og/v2?division=Entities\u0026amp;title=Create+person+or+company+entity\u0026amp;description=Create+a+new+entity+for+compliance+investigation.+The+entity+type+determines%0Awhich+fields+are+required+and+which+checks+can+be+executed.%0A%0A**Person+entities**+re\u0026amp;theme=4f3339ab8cf08c5d623f6c58\u0026amp;signature=99a41f1a9ef206407c471c45a8354d578065c656e2a74ac33135b4e97d711066\">\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/zenoo/1KDs33eK7HxYitS9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zenoo Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6450FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/entities/create-person-or-company-entity.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zenoo.com/#organization\",\"name\":\"Zenoo Developer Docs\",\"url\":\"https://docs.zenoo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zenoo/aPkOkrWFCjQlbbjO/logo/light.svg?fit=max\u0026auto=format\u0026n=aPkOkrWFCjQlbbjO\u0026q=85\u0026s=69bb3621a059829957546a0adfa17e56\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zenoo.com#website\",\"name\":\"Zenoo Developer Docs\",\"url\":\"https://docs.zenoo.com\",\"publisher\":{\"@id\":\"https://docs.zenoo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity#webpage\",\"url\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity\",\"name\":\"Create person or company entity\",\"description\":\"Create a new entity for compliance investigation. The entity type determines which fields are required and which checks can be executed. Person entities require first_name, last_name, and at least one of date_of_birth or nationality for effective screening. Company entities require company_name and country. Include registration_number for registry lookups.\",\"dateModified\":\"2026-02-16T13:04:11.542Z\",\"isPartOf\":{\"@id\":\"https://docs.zenoo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Zenoo Developer Docs\",\"item\":\"https://docs.zenoo.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create person or company entity\",\"item\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity#apireference\",\"headline\":\"Create person or company entity\",\"name\":\"Create person or company entity\",\"description\":\"Create a new entity for compliance investigation. The entity type determines which fields are required and which checks can be executed. Person entities require first_name, last_name, and at least one of date_of_birth or nationality for effective screening. Company entities require company_name and country. Include registration_number for registry lookups.\",\"url\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zenoo.com/api-reference/entities/create-person-or-company-entity#webpage\"},\"dateModified\":\"2026-02-16T13:04:11.542Z\",\"publisher\":{\"@id\":\"https://docs.zenoo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zenoo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zenoo Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zenoo Developer Docs","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog/2026-10"}]},"tabs":[{"tab":"Product Guides","pages":[{"title":"Product Guides","href":""}]},{"tab":"Developer Docs","pages":[{"title":"Developer Docs","href":"/getting-started/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Flow API","pages":[{"title":"Execute Company Verification (sync)","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /api/gateway/execute/{project_hash}/api","href":"/api-reference/flow-api/execute-company-verification-sync"},{"title":"Initiate Company Verification (async)","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /api/gateway/execute/{project_hash}/init","href":"/api-reference/flow-api/initiate-company-verification-async"},{"title":"Execute Person Verification (sync)","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /api/gateway/execute/{project_hash}/kyc/api","href":"/api-reference/flow-api/execute-person-verification-sync"},{"title":"Initiate Person Verification journey (async)","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /api/gateway/execute/{project_hash}/kyc/init","href":"/api-reference/flow-api/initiate-person-verification-journey-async"},{"title":"Screen entity for PEP/sanctions/adverse media","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /api/gateway/execute/{project_hash}/screening/api","href":"/api-reference/flow-api/screen-entity-for-pepsanctionsadverse-media"},{"title":"Retrieve async verification results","description":"Retrieve results for an asynchronous verification using the `pull` token\nobtained from any `/init` endpoint or from a 202 response on a sync endpoint.\n\n## Polling Strategy\n\n```\nFirst 2 minutes → poll every 10 seconds\nAfter 2 minutes → poll every 30 seconds\nMaximum → 10 minutes total\n```\n\nA `204 No Content` response means the verification is still processing.\nContinue polling according to the schedule above.\n\n> **Prefer webhooks over polling.** Configure a webhook in Zenoo Studio to\n> receive results automatically when processing completes.\n","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /api/gateway/sharable-payload/{pull_token}","href":"/api-reference/flow-api/retrieve-async-verification-results"}]},{"group":"Entities","pages":[{"title":"Create person or company entity","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/entities","href":"/api-reference/entities/create-person-or-company-entity"},{"title":"List entities with filters","description":"Retrieve entities with optional filtering by type, verification status,\nor case association. Results are sorted by creation date (newest first).\n","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/entities","href":"/api-reference/entities/list-entities-with-filters"},{"title":"Get entity details","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/entities/{entity_token}","href":"/api-reference/entities/get-entity-details"},{"title":"Update entity","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml patch /v1/entities/{entity_token}","href":"/api-reference/entities/update-entity"},{"title":"List entity checks","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/entities/{entity_token}/checks","href":"/api-reference/entities/list-entity-checks"},{"title":"List entity alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/entities/{entity_token}/alerts","href":"/api-reference/entities/list-entity-alerts"}]},{"group":"Cases","pages":[{"title":"Create case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases","href":"/api-reference/cases/create-case"},{"title":"List cases","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases","href":"/api-reference/cases/list-cases"},{"title":"Get case details","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}","href":"/api-reference/cases/get-case-details"},{"title":"Update case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml patch /v1/cases/{case_token}","href":"/api-reference/cases/update-case"},{"title":"Close case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/close","href":"/api-reference/cases/close-case"},{"title":"Escalate case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/escalate","href":"/api-reference/cases/escalate-case"},{"title":"List case entities","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/entities","href":"/api-reference/cases/list-case-entities"},{"title":"Add entity to case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/entities","href":"/api-reference/cases/add-entity-to-case"},{"title":"List case alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/alerts","href":"/api-reference/cases/list-case-alerts"},{"title":"List case checks","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/checks","href":"/api-reference/cases/list-case-checks"},{"title":"Get risk assessment","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/risk-assessment","href":"/api-reference/cases/get-risk-assessment"},{"title":"Create/recalculate risk assessment","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/risk-assessments","href":"/api-reference/cases/createrecalculate-risk-assessment"},{"title":"Get case audit trail","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/timeline","href":"/api-reference/cases/get-case-audit-trail"},{"title":"List case comments","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/comments","href":"/api-reference/cases/list-case-comments"},{"title":"Add comment to case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/comments","href":"/api-reference/cases/add-comment-to-case"},{"title":"List case reviewers","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/reviewers","href":"/api-reference/cases/list-case-reviewers"},{"title":"Add reviewer to case","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/cases/{case_token}/reviewers","href":"/api-reference/cases/add-reviewer-to-case"},{"title":"Generate compliance report","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/cases/{case_token}/compliance-report","href":"/api-reference/cases/generate-compliance-report"}]},{"group":"Alerts","pages":[{"title":"List alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/alerts","href":"/api-reference/alerts/list-alerts"},{"title":"Get alert details","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/alerts/{alert_token}","href":"/api-reference/alerts/get-alert-details"},{"title":"Resolve alert","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/{alert_token}/resolve","href":"/api-reference/alerts/resolve-alert"},{"title":"Escalate alert","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/{alert_token}/escalate","href":"/api-reference/alerts/escalate-alert"},{"title":"Acknowledge alert","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/{alert_token}/acknowledge","href":"/api-reference/alerts/acknowledge-alert"},{"title":"Assign alert","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/{alert_token}/assign","href":"/api-reference/alerts/assign-alert"},{"title":"Trigger AI research","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/{alert_token}/ai-research","href":"/api-reference/alerts/trigger-ai-research"},{"title":"Get AI research results","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/alerts/{alert_token}/ai-research","href":"/api-reference/alerts/get-ai-research-results"},{"title":"Bulk resolve alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/bulk/resolve","href":"/api-reference/alerts/bulk-resolve-alerts"},{"title":"Bulk acknowledge alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/bulk/acknowledge","href":"/api-reference/alerts/bulk-acknowledge-alerts"},{"title":"Bulk assign alerts","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/alerts/bulk/assign","href":"/api-reference/alerts/bulk-assign-alerts"}]},{"group":"Checks","pages":[{"title":"Get check details","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/checks/{check_token}","href":"/api-reference/checks/get-check-details"},{"title":"Execute check","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/checks/{check_token}/run","href":"/api-reference/checks/execute-check"},{"title":"Waive check","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/checks/{check_token}/waive","href":"/api-reference/checks/waive-check"}]},{"group":"Risk Assessments","pages":[{"title":"Get risk assessment","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/risk-assessments/{assessment_token}","href":"/api-reference/risk-assessments/get-risk-assessment"},{"title":"Approve risk assessment","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/risk-assessments/{assessment_token}/approve","href":"/api-reference/risk-assessments/approve-risk-assessment"},{"title":"Override risk tier","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/risk-assessments/{assessment_token}/override","href":"/api-reference/risk-assessments/override-risk-tier"}]},{"group":"Audit \u0026 Analytics","pages":[{"title":"List audit logs","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/audit-logs","href":"/api-reference/audit-trail/list-audit-logs"},{"title":"Summary metrics","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/analytics/summary","href":"/api-reference/analytics/summary-metrics"},{"title":"Alert statistics","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/analytics/alerts","href":"/api-reference/analytics/alert-statistics"},{"title":"Case statistics","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/analytics/cases","href":"/api-reference/analytics/case-statistics"}]},{"group":"Webhooks","pages":[{"title":"Register webhook","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml post /v1/webhooks","href":"/api-reference/webhooks/register-webhook"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml get /v1/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Remove webhook","deprecated":null,"version":null,"openapi":"/zenoo-api-openapi.yaml delete /v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/remove-webhook"}]}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/reference/error-codes"}]}]},"basePath":"","title":"Create person or company entity - Zenoo Developer Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}