---
title: "GET /documents"
method: GET
path: "/documents"
tags: ["documents"]
---

# GET /documents

`GET /documents`

Returns documents

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Success

- DocumentList
  - `total_count` integer, required
  - `items` Document[], required
    - `id` string, required — ID of the document
    - `source_id` string — ID of the document's source
    - `name` string, required
    - `url` string, required — OpenTrials API URL of the document
    - `trials` TrialSummary[]
      - `id` string — ID of the trial
      - `url` string — OpenTrials API URL for this trial
    - `file` FileSummary
      - `id` string — ID of the file
      - `sha1` string
      - `source_url` string — URL of origin for this file

## Other responses

- `default` — Error

## Changes

- **2016-10-27** `3bcf7353beec` — 1 info
  - endpoint added
- **2016-05-31** `7a0eb1704719` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/opentrials/apis/opentrials-api/changes/documents/get.md)

---

[API](https://skmtc.dev/opentrials/apis/opentrials-api.md) · [All operations](https://skmtc.dev/opentrials/apis/opentrials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opentrials/opentrials-api/revisions/3bcf7353beec/schema)