---
title: "Returns a specific document"
method: GET
path: "/documents/{documentsId}"
tags: ["Documents"]
---

# Returns a specific document

`GET /documents/{documentsId}`

## Path parameters

- `documentsId` integer, required

## Response `200`

Document

- object
  - `data` Document — Available relations: upload, projects, assignments, changelog
    - `id` integer
    - `upload_id` integer — File
    - `title` string — The title of the document
    - `type` 'GLOBAL' | 'ASSIGNMENT' — The type of the document
    - `info` string — Additional information about the document
    - `first_line` string — First line
    - `icon` string — Icon
    - `color` string — Color
    - `contrast_color` 'dark' | 'white' — Contrast color
    - `picture_is_avatar` boolean — Picture is avatar
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

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