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

# Get KYB Document

`GET /api/document-service/v1/documents/{documentId}`

Get details about a specific KYB document including file information. Users can only access documents they created.

## Path parameters

- `documentId` string, uuid, required

## Response `200`

200

- GetDocumentResponse — Response containing document information
  - `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
  - `enterpriseId` string, nullable, required — Enterprise associated with the document when created, or null for legacy documents
  - `forUserId` string, nullable, required — BitGo public user ID the document was created for, or null when not attributed
  - `metadata` object — Optional metadata for the document
  - `files` DocumentFileInfo[], required — List of files associated with the document
    - `id` string, required — Unique identifier for the file
    - `view` 'front' | 'back' | 'full' — View or side of the document file
    - `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.
    - `fileName` string — Original filename of the uploaded file
    - `fileType` string — MIME type of the file
    - `fileSize` number — Size of the file in bytes
    - `uploadUrl` string, uri — Presigned URL for file upload
    - `downloadUrl` string, uri — Presigned URL for file download
    - `uploadUrlExpiresAt` string, date-time — When the upload URL expires
    - `rejectionReason` string — Human-readable reason when status is rejected (e.g. illegible scan, wrong document type)
    - `createdAt` string, date-time, required — When the file was created
    - `updatedAt` string, date-time, required — When the file was last updated
  - `createdAt` string, date-time, required — When the document was created
  - `updatedAt` string, date-time, required — When the document was last updated

## 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)