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

# List of documents

`GET /documents`

This endpoint returns list of documents

## Query parameters

- `filter[agencyId]` string
- `filter[commentEndDate]` string, date
- `filter[docketId]` string
- `filter[documentType]` 'Notice' | 'Rule' | 'Proposed Rule' | 'Supporting & Related Material' | 'Other' — type of document
- `filter[frDocNum]` string
- `filter[searchTerm]` string
- `filter[postedDate]` string, date
- `filter[subtype]` string
- `filter[withinCommentPeriod]` boolean
- `sort` string
- `page[number]` integer
- `size` integer

## Response `200`

A JSON\:API document with the a list of documents

## Other responses

- `400` — Validation error
- `403` — API key is missing or invalid

## Changes

> 8 revisions in range; 1 not diffed.

- **2020-07-28** (v4) `f9573c473257` — 1 breaking
  - the `data/items/links/items/self` response's property format changed from `uri` to `uri-reference` for status `200`

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

---

[API](https://skmtc.dev/gsa/apis/regulations-gov-api.md) · [All operations](https://skmtc.dev/gsa/apis/regulations-gov-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gsa/regulations-gov-api/revisions/0c7282b2ab56/schema)