> ## Documentation Index > Fetch the complete documentation index at: https://doc.youverify.co/llms.txt > Use this file to discover all available pages before exploring further. # Verify Entity (KYB) > Performs a Know Your Business (KYB) check on a business entity using its incorporation number and country to validate registration details. ## OpenAPI ````yaml /api-reference/specs/cowork.json post /v2/api/entities/{entityId}/company openapi: 3.0.3 info: title: Youverify Cowork API version: 2.0.0 description: >- Entity, Activity, Signal and Case Management endpoints — the core Cowork platform object model. Assembled from doc.youverify.co/api-reference-sdk, endpoints kept in the exact order they appear in the GitBook navigation. Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid verification calls; 404 on lookup-by-ID calls) are sourced verbatim from Youverify's own "Youverify OS Error Codes" and "Response Codes" pages (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and attached via components.responses, since those pages document them account-wide rather than per endpoint. Any error example that a specific endpoint's own page actually showed is kept exactly as documented there instead of being replaced by these. contact: name: Youverify Support email: support@youverify.co servers: - url: https://api.youverify.co description: Production (live, billed) - url: https://api.sandbox.youverify.co description: Sandbox (test data, not billed) security: - ApiKeyAuth: [] tags: - name: Entity Management description: >- Create, retrieve and verify entities (individuals or businesses) — the core object every check attaches to. - name: Activity Management description: Inspect the verification activities run against your account. - name: Signal Management description: Retrieve monitoring signals and their events, by entity or business. - name: Case Management description: Create and manage compliance cases, including AI-generated case summaries. paths: /v2/api/entities/{entityId}/company: post: tags: - Entity Management summary: Verify Entity (KYB) description: >- Performs a Know Your Business (KYB) check on a business entity using its incorporation number and country to validate registration details. operationId: verifyEntityKyb parameters: - name: token in: header required: true schema: type: string description: API secret token - name: entityId in: path required: true schema: type: string description: Id of the entity being checked. requestBody: required: true content: application/json: schema: type: object properties: entityType: type: string description: Type of entity being checked or verified. enum: - business isSubjectConsent: type: boolean description: Consent of the individual or entity being verified. enum: - true checkType: type: string description: Type of business check enum: - basic - standard - premium incorporationNumber: type: string description: Business registration number incorporationCountry: type: string description: >- Country code of business incorporation (ISO 3166-1 alpha-2). Size: 2 characters required: - entityType - isSubjectConsent example: entityType: business isSubjectConsent: true incorporationNumber: RC123456 incorporationCountry: NG checkType: basic responses: '200': description: Success (existing business, or not found) content: application/json: example: success: true status_code: 200 message: Business check successful! data: id: ent_69dab0119abad240d91071a4 entity: entityId: ent_69dab0119abad240d91071a4 isNew: false businessCheck: id: 69dab502682626b4e9e6d77c status: found businessId: 69b3c7f1556f687f7fb8a5bd parentId: null isConsent: true type: basic_company_check searchTerm: RC00000000 name: John Doe Inc registrationNumber: RC00000000 companyStatus: ACTIVE requestedAt: '2026-04-11T20:54:27.818Z' country: Nigeria createdAt: '2022-11-03T14:16:54.235Z' lastModifiedAt: '2022-11-03T14:16:54.235Z' typeOfEntity: PRIVATE COMPANY LIMITED BY SHARES registrationDate: '2017-06-09' natureOfBusiness: null amlReport: null adverseMediaReport: null requestedBy: firstName: Jamal lastName: Akinyelu middleName: '' id: 69b3c7f6556f687f7fb8a5c7 links: [] '201': description: Success (new business, entity created) content: application/json: example: success: true status_code: 201 message: Business check successful! data: id: 69dab502682626b4e9e6d77c entity: entityId: ent_69dab0119abad240d91071a4 isNew: true message: Entity created successfully. businessCheck: id: 69dab502682626b4e9e6d77c status: found businessId: 69b3c7f1556f687f7fb8a5bd parentId: null isConsent: true type: basic_company_check searchTerm: RC00000000 name: John Doe Inc registrationNumber: RC00000000 companyStatus: ACTIVE requestedAt: '2026-04-11T20:54:27.818Z' country: Nigeria createdAt: '2022-11-03T14:16:54.235Z' lastModifiedAt: '2022-11-03T14:16:54.235Z' typeOfEntity: PRIVATE COMPANY LIMITED BY SHARES registrationDate: '2017-06-09' natureOfBusiness: null amlReport: null adverseMediaReport: null requestedBy: firstName: Jamal lastName: Akinyelu middleName: '' id: 69b3c7f6556f687f7fb8a5c7 '401': $ref: '#/components/responses/Error401Unauthorized' '402': $ref: '#/components/responses/Error402PaymentRequired' '404': description: Not Found content: application/json: example: success: false statusCode: 404 message: You have attempted to get a resource that does not exist. name: ResourceNotFoundError data: {} '429': $ref: '#/components/responses/Error429TooManyRequests' '500': $ref: '#/components/responses/Error500ServerError' components: responses: Error401Unauthorized: description: Unauthorized — the token header is missing or invalid. content: application/json: example: success: false statusCode: 401 message: Permission denied name: UnauthorizedError data: {} Error402PaymentRequired: description: Payment Required — your account balance is too low to run this check. content: application/json: example: success: false statusCode: 402 message: Insufficient fund name: PaymentRequiredError data: {} Error429TooManyRequests: description: Too Many Requests — you have exceeded the rate limit; wait and retry. content: application/json: example: success: false statusCode: 429 message: Too many requests name: RateLimitError data: {} Error500ServerError: description: >- Internal Server Error — a rare, unexpected failure on Youverify's side. Contact support@youverify.co if it persists. content: application/json: example: success: false statusCode: 500 message: Internal Server Error name: Error data: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: token description: Your Youverify API secret key. Never expose client-side. ````