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

# Get a document

`GET /documents/{id}`

Returns a document.

Requests to this endpoint are subject to rate limits:

- Live environments: 700 requests per 5 seconds.

- Test environments: 200 requests per 5 seconds.

- Failed requests are subject to a limit of 5 failures per 10 seconds.

## Path parameters

- `id` string, required

## Query parameters

- `skipContent` boolean

## Response `200`

OK - the request has succeeded.

- Document
  - `attachment` Attachment
    - `content` string, byte, required — The document in Base64-encoded string format.
    - `contentType` string — The file format. Possible values: **application/pdf**, **image/jpg**, **image/jpeg**, **image/png**.
    - `filename` string — The name of the file including the file extension.
    - `pageName` string — The name of the file including the file extension.
    - `pageType` string — Specifies which side of the ID card is uploaded. * If the `type` is **driversLicense** or **identityCard**, you must set this to **front** or **back** and include both sides in the same API request. * For any other types, when this is omitted, we infer the page number based on the order of attachments.
  - `attachments` Attachment[] — Array that contains the document. The array supports multiple attachments for uploading different sides or pages of a document.
    - `content` string, byte, required — The document in Base64-encoded string format.
    - `contentType` string — The file format. Possible values: **application/pdf**, **image/jpg**, **image/jpeg**, **image/png**.
    - `filename` string — The name of the file including the file extension.
    - `pageName` string — The name of the file including the file extension.
    - `pageType` string — Specifies which side of the ID card is uploaded. * If the `type` is **driversLicense** or **identityCard**, you must set this to **front** or **back** and include both sides in the same API request. * For any other types, when this is omitted, we infer the page number based on the order of attachments.
  - `creationDate` string, date-time — The creation date of the document.
  - `description` string, required — Your description for the document.
  - `expiryDate` string — The expiry date of the document, in YYYY-MM-DD format.
  - `fileName` string — The filename of the document.
  - `id` string — The unique identifier of the document.
  - `issuerCountry` string — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**.
  - `issuerState` string — The state or province where the document was issued (AU only).
  - `modificationDate` string, date-time — The modification date of the document.
  - `number` string — The number in the document.
  - `owner` OwnerEntity
    - `id` string, required — Unique identifier of the resource that owns the document. For `type` **legalEntity**, this value is the unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id). For `type` **bankAccount**, this value is the unique identifier of the [transfer instrument](https://docs.adyen.com/api-explorer/legalentity/latest/post/transferInstruments#responses-200-id).
    - `type` string, required — Type of resource that owns the document. Possible values: **legalEntity**, **bankAccount**.
  - `type` 'bankStatement' | 'driversLicense' | 'identityCard' | 'nationalIdNumber' | 'passport' | 'proofOfAddress' | 'proofOfNationalIdNumber' | 'proofOfResidency' | 'registrationDocument' | 'vatDocument' | 'proofOfOrganizationTaxInfo' | 'proofOfIndividualTaxId' | 'proofOfOwnership' | 'proofOfSignatory' | 'liveSelfie' | 'proofOfIndustry' | 'constitutionalDocument' | 'proofOfFundingOrWealthSource' | 'proofOfRelationship', required — Type of document, used when providing an ID number or uploading a document. The possible values depend on the legal entity type. * For **organization**, the `type` values can be **proofOfAddress**, **registrationDocument**, **vatDocument**, **proofOfOrganizationTaxInfo**, **proofOfOwnership**, **proofOfIndustry**, **proofOfSignatory**, or **proofOfFundingOrWealthSource**. * For **individual**, the `type` values can be **identityCard**, **driversLicense**, **passport**, **liveSelfie**, **proofOfNationalIdNumber**, **proofOfResidency**, **proofOfIndustry**, **proofOfIndividualTaxId**, **proofOfFundingOrWealthSource** or **proofOfRelationship**. * For **soleProprietorship**, the `type` values can be **constitutionalDocument**, **proofOfAddress**, or **proofOfIndustry**. * For **trust**, the `type` value is **constitutionalDocument**. * For **unincorporatedPartnership**, the `type` value is **constitutionalDocument**. * Use **bankStatement** to upload documents for a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/legal-entity-management-api.md) · [All operations](https://skmtc.net/adyen/apis/legal-entity-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/legal-entity-management-api/versions/2ae704e1705b/schema)