---
title: "Verify KYB Document Status"
method: POST
path: "/api/document-service/v1/documents/{documentId}/verify"
tags: ["Know Your Business (KYB)"]
---

# Verify KYB Document Status

`POST /api/document-service/v1/documents/{documentId}/verify`

Verify the upload status of all files in a document by checking with the storage provider. Updates file and document statuses based on actual verification results.

## Path parameters

- `documentId` string, uuid, required

## Request body

- VerifyDocumentRequest — Request body for document verification

## Response `200`

200

- VerifyDocumentResponse — Response after verifying document upload status
  - `documentId` string, required — Unique identifier for the document
  - `documentType` 'governmentId' | 'commercialRegister' | 'articlesOfAssociation' | 'certificateOfIncorporation' | 'certificateOfGoodStanding' | 'certificateOfTrust' | 'certificateOfIncumbency' | 'certificateOfIncumbencyOrShareRegister' | 'proofOfPrincipalPlaceOfBusiness' | 'activeTradeLicense' | 'resolutionToOpenBitgoUaeAccount' | 'resolutionToOpenBitgoSingaporeAccount' | 'proofOfAuthorizedSignatories' | 'memorandumOfAssociation' | 'memorandumAndArticlesOfAssociation' | 'bylawsOrOperatingAgreement' | 'operatingAgreement' | 'w8' | 'w9' | 'evidenceOfLegalStatus' | 'evidenceOfActiveStatus' | 'proofOfJfsaLicense' | 'proofOfGamingLicense' | 'organizationDocument' | 'partnershipAgreement' | 'articlesOfOrganization' | 'businessLicenseOrRegistration' | 'evidenceOfGovernmentOrStateOwnership' | 'secFilingsAsEvidenceOfPublicTradingStatus' | 'foundingTreatyOrEquivalent' | 'proofOfAddress' | 'sourceOfWealth' | 'singaporeSupportingDocument' | 'caseRequiredDocuments' | 'correspondentAccountCertification' | 'authorizedSignerForm', required — Type of document being uploaded
  - `documentTypeLabel` string, required — Human-readable label for the document type
  - `subType` 'cct' | 'cid' | 'dl' | 'foid' | 'hic' | 'id' | 'ipp' | 'keyp' | 'ltpass' | 'munid' | 'myn' | 'nbi' | 'nric' | 'ofw' | 'rp' | 'pan' | 'pid' | 'pp' | 'ppc' | 'pr' | 'sss' | 'td' | 'tribalid' | 'umid' | 'vid' | 'visa' | 'wp' | 'computerizedPayslips' | 'incomeTaxAssessment' | 'employmentLetterContract' | 'bankStatement' | 'dptHoldingStatement' | 'investmentHoldingsStatement' | 'titleDeeds' | 'propertyTaxCpfStatement' | 'other' — Subtype of document (relevant for `governmentId` and `singaporeSupportingDocument` document types)
  - `status` 'awaitingUpload' | 'uploaded' | 'accepted' | 'rejected', required — Current status of the document
  - `files` VerifyDocumentFile[], required — List of files with verification status
    - `fileId` string, required — Unique identifier for the file
    - `fileView` 'front' | 'back' | 'full', required — View or side of the document file
    - `required` boolean, required — Whether this file is required for the document
    - `status` 'awaitingUpload' | 'uploaded' | 'accepted' | 'rejected' | 'requiresManualReview', required — Current status of the file upload. `requiresManualReview` is a terminal state set after 2 failed AI screening attempts; the file is locked and Trust ops resolves it manually.
    - `downloadUrl` string, uri — Presigned URL for file download

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `500` — 500

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)