---
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.
    - `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.
    - `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' | 'taxDocument' | 'proofOfIndustry', 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**, **taxDocument**, **proofOfOwnership**, or **proofOfIndustry**. * For **individual**, the `type` values can be **identityCard**, **driversLicense**, **proofOfNationalIdNumber**, **proofOfResidency**, or **proofOfIndustry**. * 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/legalentityservice.md) · [All operations](https://skmtc.net/adyen/apis/legalentityservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/legalentityservice/versions/d0097ab4e2e8/schema)