> ## Documentation Index > Fetch the complete documentation index at: https://docs.fastcac.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a verification > A verification you made in this mode, again. Free. ## OpenAPI ````yaml /openapi.json get /businesses/verifications/{verification_id} openapi: 3.1.0 info: title: FastCAC API description: Register Nigerian businesses with CAC from your own product. version: '2026-11-01' servers: - url: https://api.fastcac.com/v1 security: - apiKey: [] tags: - name: Account description: Check your key and see your organization. - name: Names description: >- Check a business name against CAC's rules and registry, and the categories it takes, before registering it. - name: Registrations description: Register a Business Name with CAC, from draft to certificate. - name: Lookup description: >- Search CAC's register for free, and look up a business's full record with its officers. - name: Verification description: >- Check that a business your applicant names is real, active and run by the people they say. - name: Monitoring description: >- Watch businesses on CAC's register and get an event when one goes inactive or changes name. - name: Identities description: >- Look up a proprietor's NIN with NIMC, to prefill a registration and use their photo. - name: Balance description: >- Your prepaid wallet: what's available, its transactions and your funding account. - name: Test helpers description: >- Test keys only: move a registration on without waiting, or simulate a deposit. - name: Webhooks description: Endpoints that receive events, and the events sent to them. - name: Webhook events description: What FastCAC POSTs to your webhook endpoints. paths: /businesses/verifications/{verification_id}: get: tags: - Verification summary: Get a verification description: A verification you made in this mode, again. Free. operationId: get_verification_businesses_verifications__verification_id__get parameters: - name: verification_id in: path required: true schema: type: string title: Verification Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/V1BusinessVerification' examples: Example: value: object: business_verification id: bver_6BMrXa53Vaxt8BIPwKeQv5 number: '7654321' type: RC result: match checks: number_found: true name: result: exact score: 1 registered_name: ADA FOODS LIMITED active: true status: ACTIVE officers: - name: Ada Obi matched: true role: director amount_charged: '200.00' transaction_id: wtx_6nChZbZ2SuiFgTDt5VSNlI created_at: '2026-10-28T15:16:04Z' '400': description: The request is invalid; `param` names the field. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: The API key is missing, malformed, revoked or expired. content: application/json: schema: $ref: '#/components/schemas/Error' examples: Example: value: error: type: authentication_error code: api_key_missing message: 'Send your API key as `Authorization: Bearer `.' param: null request_id: req_8r9FEwNmLuxQORZX5Qhvkd0q '403': description: >- The key can't do this (for example, a test helper called with a live key). content: application/json: schema: $ref: '#/components/schemas/Error' examples: Example: value: error: type: permission_error code: live_mode_unavailable message: >- Live registrations are paused right now. Use a test key (fc_test_…) meanwhile. param: null request_id: req_Td9lI1vsT5ARzv0XD7RGS1tD '404': description: No such object for this key's organization and mode. content: application/json: schema: $ref: '#/components/schemas/Error' examples: Example: value: error: type: not_found_error code: resource_missing message: 'No such registration: reg_0000000000000000000000.' param: id request_id: req_PLJYvLLT2WjhIywrPjlhgIGv '409': description: >- The object's state doesn't allow this, or the Idempotency-Key was reused. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Too many requests; wait for `Retry-After` seconds. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: V1BusinessVerification: properties: object: type: string const: business_verification title: Object default: business_verification id: type: string title: Id description: bver_… number: type: string title: Number type: anyOf: - type: string enum: - BN - RC - IT - LP - LLP - type: 'null' title: Type description: The register the number is in; null when CAC doesn't have it. result: type: string enum: - match - partial - no_match - not_found title: Result description: >- match: the name is exact, the business is active and every officer you sent matched. partial: the name is close, the business isn't active, or an officer didn't match. no_match: the name is a different business's. not_found: CAC has no business with that number. checks: $ref: '#/components/schemas/V1VerificationChecks' amount_charged: type: string title: Amount Charged description: >- What the verification cost, in naira, as a decimal string: "0.00" when it didn't check officers. transaction_id: anyOf: - type: string - type: 'null' title: Transaction Id description: The wtx_… business_verification_charge; null when it was free. created_at: anyOf: - type: string - type: 'null' title: Created At type: object required: - id - number - type - result - checks - amount_charged - transaction_id - created_at title: V1BusinessVerification Error: properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error title: V1Error type: object V1VerificationChecks: properties: number_found: type: boolean title: Number Found description: CAC has a business with that number. name: anyOf: - $ref: '#/components/schemas/V1NameCheck' - type: 'null' description: Null when the number wasn't found. active: anyOf: - type: boolean - type: 'null' title: Active description: CAC lists it as ACTIVE. Null when the number wasn't found. status: anyOf: - type: string - type: 'null' title: Status description: 'As CAC lists it: ACTIVE, INACTIVE, STRUCK OFF and so on.' officers: anyOf: - items: $ref: '#/components/schemas/V1OfficerCheck' type: array - type: 'null' title: Officers description: >- One per name you sent; null when you sent none or the number wasn't found. type: object required: - number_found - name - active - status - officers title: V1VerificationChecks ErrorDetail: properties: type: type: string enum: - invalid_request_error - authentication_error - payment_error - permission_error - not_found_error - idempotency_error - rate_limit_error - api_error title: Type code: type: string title: Code description: Stable and machine-readable, e.g. registration_incomplete. message: type: string title: Message description: For a developer to read; may change. param: anyOf: - type: string - type: 'null' title: Param description: The parameter at fault, as a path like proprietors[0].nin. request_id: anyOf: - type: string - type: 'null' title: Request Id description: Also in the FastCAC-Request-Id header. Quote it to support. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Only on some errors. A 402 insufficient_balance carries amount_due, balance, currency and funding_account (number, bank, name; null until it's active). type: object required: - type - code - message - param - request_id title: ErrorDetail V1NameCheck: properties: result: type: string enum: - exact - close - no_match title: Result description: >- exact: the same name once case, punctuation and LTD/LIMITED-style spellings are ignored. close: a small difference, such as a typo or a missing word. no_match: a different name. score: type: number title: Score description: Similarity from 0 to 1. registered_name: type: string title: Registered Name description: The name on CAC's register. type: object required: - result - score - registered_name title: V1NameCheck V1OfficerCheck: properties: name: type: string title: Name description: The name you sent. matched: type: boolean title: Matched description: >- True when CAC lists a proprietor, director, secretary or person with significant control by that name (word order and case ignored). role: anyOf: - type: string enum: - proprietor - director - secretary - psc - type: 'null' title: Role description: The matched officer's role, when matched. type: object required: - name - matched - role title: V1OfficerCheck securitySchemes: apiKey: type: http scheme: bearer description: 'Your secret API key: fc_test_… in test mode, fc_live_… in live mode.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.