---
search:
  tags:
    - Documents
    - GET
seo:
  description: >-
    Reads one document of a Brand. The answer has the document… Reference for
    the GET /context/brands/{slug}/documents/{documentId} endpoint in the
    AdCrunch API.
sidebar:
  label: Get a document
  badge: GET
title: Get a document
type: openapi-operation
---
Reads one document of a Brand. The answer has the document data and the URL to read the file from. The bytes never come back in the body: fetch `url` for them. A reservation whose bytes never arrived answers `404`, because there is no file behind it.

`GET /context/brands/{slug}/documents/{documentId}`

**Responses**

- `200` — The Document. \`url\` is public: anybody holding it can read the file.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`brand:read\`. \`error\` is \`forbidden\`.
- `404` — No such Document on this Brand, or it has not been finalized. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "createdAt": 1790000000000,
  "filename": "acme-brand-guidelines.pdf",
  "id": "doc_5e2b41",
  "mimeType": "application/pdf",
  "name": "acme-brand-guidelines.pdf",
  "sizeBytes": 1482064,
  "targetId": "brd_6a9c33",
  "targetType": "brand",
  "url": "https://documents.adcrunch.dev/org_3a7f10/doc_5e2b41"
}
```
