---
title: "Get a document by ID"
method: GET
path: "/documents/{documentId}"
tags: ["Documents"]
---

# Get a document by ID

`GET /documents/{documentId}`

Retrieve details and metadata of a specific document by ID.

## Path parameters

- `documentId` string, required

## Response `200`

Successful operation

- Document
  - `id` string, required — Unique identifier for this document
  - `documentHolder` string, required — ID of the entity that owns this document. Can be a Customer ID or a BeneficialOwner ID.
  - `documentType` 'PASSPORT' | 'DRIVERS_LICENSE' | 'NATIONAL_ID' | 'PROOF_OF_ADDRESS' | 'BANK_STATEMENT' | 'TAX_RETURN' | 'CERTIFICATE_OF_INCORPORATION' | 'ARTICLES_OF_INCORPORATION' | 'ARTICLES_OF_ASSOCIATION' | 'STATE_REGISTRY_EXCERPT' | 'GOOD_STANDING_CERTIFICATE' | 'INFORMATION_STATEMENT' | 'INCUMBENCY_CERTIFICATE' | 'BUSINESS_LICENSE' | 'SHAREHOLDER_REGISTER' | 'POWER_OF_ATTORNEY' | 'UTILITY_BILL' | 'ELECTRICITY_BILL' | 'RENT_OR_LEASE_AGREEMENT' | 'DIRECTOR_REGISTRY' | 'TRUST_AGREEMENT' | 'STATE_COMPANY_REGISTRY' | 'PARTNERSHIP_CONTROL_AGREEMENT' | 'PARTNERSHIP_AGREEMENT' | 'SELFIE' | 'OTHER', required — Type of identity or business verification document. Document types are grouped by verification category: **Identity** — PASSPORT, DRIVERS_LICENSE, NATIONAL_ID **Business — Legal presence** — CERTIFICATE_OF_INCORPORATION, ARTICLES_OF_INCORPORATION, ARTICLES_OF_ASSOCIATION, STATE_REGISTRY_EXCERPT **Business — Control structure** — DIRECTOR_REGISTRY, TRUST_AGREEMENT, STATE_COMPANY_REGISTRY, PARTNERSHIP_CONTROL_AGREEMENT **Business — Ownership structure** — SHAREHOLDER_REGISTER, TRUST_AGREEMENT, PARTNERSHIP_AGREEMENT **Proof of address** — UTILITY_BILL, RENT_OR_LEASE_AGREEMENT, ELECTRICITY_BILL, BANK_STATEMENT, TAX_RETURN
  - `side` 'FRONT' | 'BACK' — Which side of the document this upload represents. Relevant for two-sided documents like driver's licenses or national IDs.
  - `country` string, required — Country that issued the document (ISO 3166-1 alpha-2)
  - `documentNumber` string — Document identification number (e.g., passport number)
  - `issuingAuthority` string — Name of the government agency or organization that issued the document
  - `fileName` string, required — Original file name of the uploaded document
  - `createdAt` string, date-time, required — When this document was uploaded
  - `updatedAt` string, date-time — When this document was last updated

## Other responses

- `401` — Unauthorized
- `404` — Document not found
- `500` — Internal service error

---

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