---
title: "List KYB Documents"
method: GET
path: "/api/document-service/v1/documents"
tags: ["Know Your Business (KYB)"]
---

# List KYB Documents

`GET /api/document-service/v1/documents`

List documents belonging to the authenticated user with optional filtering and pagination.

## Query parameters

- `ids` string
- `type` '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' — Type of document being uploaded
- `status` 'awaitingUpload' | 'uploaded' | 'accepted' | 'rejected' — Current status of the document
- `enterpriseId` string
- `forUserId` string — BitGo public user ID the document is created for; exactly 32 alphanumeric characters
- `limit` integer
- `offset` integer, nullable

## Response `200`

200

- GetDocumentsResponse — Paginated list of document summaries
  - `documents` DocumentSummary[], required — List of document summaries
    - `id` string, uuid, required — Document identifier
    - `type` '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
    - `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', required — 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
    - `createdAt` string, date-time, required — ISO timestamp when the document was created
    - `files` DocumentFileSummary[], required — Files associated with the document
      - `id` string, uuid, required — File identifier
      - `view` 'front' | 'back' | 'full', required — 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.
  - `total` integer, required — Total number of matched documents
  - `limit` integer, required — Applied page size
  - `offset` integer, required — Applied page offset

## Other responses

- `400` — 400
- `401` — 401
- `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)