---
name: orthogonal-govinfo-api
description: "Call GovInfo API through Orthogonal's pay-per-use Run API: The US Government Publishing Office's GovInfo API: search and retrieve official federal publications (Federal Register, CFR, US Code, bills, Congressional Record, court opinions and more) with package and granule summaries, content links (PDF, XML, HTML), collection updates, publish-date listings and related documents. Source: U.S. Government Publishing Office (GovInfo). Most content is public domain, but some documents include third-party copyrighted material; check rights before reuse."
---

# GovInfo API — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

The US Government Publishing Office's GovInfo API: search and retrieve official federal publications (Federal Register, CFR, US Code, bills, Congressional Record, court opinions and more) with package and granule summaries, content links (PDF, XML, HTML), collection updates, publish-date listings and related documents. Source: U.S. Government Publishing Office (GovInfo). Most content is public domain, but some documents include third-party copyrighted material; check rights before reuse.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Publication search

Full-text search across GovInfo publications (Federal Register, CFR, US Code, bills, Congressional Record and more) using GovInfo query syntax, with paging by offsetMark.

`POST /search`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/dce411fa-5f4e-4d9e-9587-51e5f0e4255a

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No |  |
| `pageSize` | integer | No |  |
| `offsetMark` | string | No |  |
| `sorts` | object | No |  |
| `historical` | boolean | No |  |
| `resultLevel` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/search","body":{"query":"<string>","pageSize":"<integer>","offsetMark":"<string>","sorts":"<object>","historical":"<boolean>","resultLevel":"<string>"}}'
```

### Related documents

Get a list of relationships for a given accessId: the collections holding documents related to a package or granule (bill versions, bill history, laws, reports, Federal Register documents by RIN).

`GET /related/{accessId}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/7de5627d-11bb-4cf3-a513-33461813b27e

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `accessId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {accessId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/related/{accessId}","method":"GET"}'
```

### Related documents by collection

Get a list of relationships for a given accessId within one collection: the related packages or granules in that collection.

`GET /related/{accessId}/{collection}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/2a91aa5f-48a4-4fed-adf5-e8dace8315b3

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `accessId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `collection` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `granuleClass` | string | No |  |
| `subGranuleClass` | string | No |  |

```bash
# Replace {accessId}, {collection} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/related/{accessId}/{collection}","method":"GET","query":{"granuleClass":"<string>","subGranuleClass":"<string>"}}'
```

### Packages published since

Retrieve list of packages based on dateIssued value: packages whose publication date is on or after the start date, filtered by collection.

`GET /published/{dateIssuedStartDate}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/e8bff3a8-64ab-45bb-bf39-51ce9f6e034b

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dateIssuedStartDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `offsetMark` | string | No | Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response. |
| `offset` | integer | No | This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a> |
| `pageSize` | integer | Yes | The number of records to return for a given request. Max value is 1000 |
| `collection` | string | Yes | comma-separated list of collections that you are requesting, e.g. https://api.govinfo.gov/published/2019-01-01/2019-12-31?offset=0&pageSize=100&collection=BILLS,BILLSTATUS&api_key=DEMO_KEY - see /collections for a list of collections by code and human-readable name. |
| `congress` | string | No | congress number (e.g. 116) |
| `docClass` | string | No | Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, docClass in BILLS corresponds with Bill Type --e.g. s, hr, hres, sconres. CREC (the Congressional Record) has docClass by CREC section: HOUSE, SENATE, DIGEST, and EXTENSIONS |
| `billVersion` | string | No | Filter the results by overarching collection-specific categories. |
| `modifiedSince` | string | No | equivalent to the lastModifiedStartDate parameter in the collections service which is based on lastModified- allows you to request only packages that have been modified since a given date/time - useful for tracking updates. Requires ISO 8601 format -- e.g. 2020-02-28T00:00:00Z |
| `courtCode` | string | No |  |
| `courtType` | string | No |  |
| `state` | string | No |  |
| `topic` | string | No |  |
| `isGLP` | boolean | No |  |
| `natureSuitCode` | string | No |  |
| `natureSuit` | string | No |  |

```bash
# Replace {dateIssuedStartDate} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/published/{dateIssuedStartDate}","method":"GET","query":{"offsetMark":"<string>","offset":"<integer>","pageSize":"<integer>","collection":"<string>","congress":"<string>","docClass":"<string>","billVersion":"<string>","modifiedSince":"<string>","courtCode":"<string>","courtType":"<string>","state":"<string>","topic":"<string>","isGLP":"<boolean>","natureSuitCode":"<string>","natureSuit":"<string>"}}'
```

### Packages published in range

Retrieve list of packages based on dateIssued value range: packages published between two dates, filtered by collection.

`GET /published/{dateIssuedStartDate}/{dateIssuedEndDate}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/d5ef15d4-cb48-4bcf-9cbd-8a10048ec696

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dateIssuedStartDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `dateIssuedEndDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `offsetMark` | string | No | Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response. |
| `offset` | integer | No | This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a> |
| `pageSize` | integer | Yes | The number of records to return for a given request. Max value is 1000 |
| `collection` | string | Yes | comma-separated list of collections that you are requesting, e.g. https://api.govinfo.gov/published/2019-01-01/2019-12-31?offset=0&pageSize=100&collection=BILLS,BILLSTATUS&api_key=DEMO_KEY - see /collections for a list of collections by code and human-readable name. |
| `congress` | string | No | congress number (e.g. 116) |
| `docClass` | string | No | Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, docClass in BILLS corresponds with Bill Type --e.g. s, hr, hres, sconres. CREC (the Congressional Record) has docClass by CREC section: HOUSE, SENATE, DIGEST, and EXTENSIONS |
| `billVersion` | string | No | Filter the results by overarching collection-specific categories. |
| `modifiedSince` | string | No | equivalent to the lastModifiedStartDate parameter in the collections service which is based on lastModified- allows you to request only packages that have been modified since a given date/time - useful for tracking updates. Requires ISO 8601 format -- e.g. 2020-02-28T00:00:00Z |
| `courtCode` | string | No |  |
| `courtType` | string | No |  |
| `state` | string | No |  |
| `topic` | string | No |  |
| `natureSuitCode` | string | No |  |
| `natureSuit` | string | No |  |
| `isGLP` | boolean | No |  |

```bash
# Replace {dateIssuedStartDate}, {dateIssuedEndDate} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/published/{dateIssuedStartDate}/{dateIssuedEndDate}","method":"GET","query":{"offsetMark":"<string>","offset":"<integer>","pageSize":"<integer>","collection":"<string>","congress":"<string>","docClass":"<string>","billVersion":"<string>","modifiedSince":"<string>","courtCode":"<string>","courtType":"<string>","state":"<string>","topic":"<string>","natureSuitCode":"<string>","natureSuit":"<string>","isGLP":"<boolean>"}}'
```

### Package summary

Return json summary for specified package: its metadata and links to its content formats (PDF, XML, HTML, MODS, PREMIS, ZIP).

`GET /packages/{packageId}/summary`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/bdb34cd1-73d6-460f-bf98-2c4a92bd6c85

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `packageId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {packageId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/packages/{packageId}/summary","method":"GET"}'
```

### Package granules

Get a list of granules associated with a package (such as the individual documents in a daily Federal Register issue).

`GET /packages/{packageId}/granules`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/5d6f4586-3b54-4cb9-82fd-5f52291d3531

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `packageId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `offsetMark` | string | No | Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response. |
| `offset` | integer | No | This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a> |
| `pageSize` | integer | Yes | The number of records to return for a given request. Max value is 1000 |
| `md5` | string | No | md5 hash value of the html content file - can be used to identify changes in individual granules for the HOB and CRI collections. |
| `granuleClass` | string | No | Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, For example, granuleClass in CREC corresponds with Congressional Record Section ---e.g. . DAILYDIGEST, EXTENSIONS, SENATE, HOUSE |

```bash
# Replace {packageId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/packages/{packageId}/granules","method":"GET","query":{"offsetMark":"<string>","offset":"<integer>","pageSize":"<integer>","md5":"<string>","granuleClass":"<string>"}}'
```

### Granule summary

Return json summary for specified granule: its metadata and links to its content formats.

`GET /packages/{packageId}/granules/{granuleId}/summary`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/7f1063d5-656e-49fd-8206-b6b90230aa91

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `packageId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `granuleId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {packageId}, {granuleId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/packages/{packageId}/granules/{granuleId}/summary","method":"GET"}'
```

### Collection list

Request list of collections. Response includes collectionCode, collectionName, package and granule counts.

`GET /collections`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/08175240-3dda-44a8-8228-c534032980a3

**Docs:** https://api.govinfo.gov/docs/

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/collections","method":"GET"}'
```

### Collection updates since

Retrieve new or updated packages for a collection given a start date and time (GovInfo system update time).

`GET /collections/{collection}/{lastModifiedStartDate}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/560b51dd-b756-4374-82b6-db5ca02068e7

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `collection` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `lastModifiedStartDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `offsetMark` | string | No | Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response. |
| `offset` | integer | No | This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a> |
| `pageSize` | integer | Yes | The number of records to return for a given request. Max value is 1000 |
| `congress` | integer | No | Filters results by Congress, where applicable. For example 113 or 114. |
| `docClass` | string | No | Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, docClass in BILLS corresponds with Bill Type --e.g. s, hr, hres, sconres. |
| `billVersion` | string | No | Filter the results by overarching collection-specific categories. |
| `courtCode` | string | No |  |
| `courtType` | string | No |  |
| `state` | string | No |  |
| `topic` | string | No |  |
| `isGLP` | boolean | No |  |
| `natureSuitCode` | string | No |  |
| `natureSuit` | string | No |  |

```bash
# Replace {collection}, {lastModifiedStartDate} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/collections/{collection}/{lastModifiedStartDate}","method":"GET","query":{"offsetMark":"<string>","offset":"<integer>","pageSize":"<integer>","congress":"<integer>","docClass":"<string>","billVersion":"<string>","courtCode":"<string>","courtType":"<string>","state":"<string>","topic":"<string>","isGLP":"<boolean>","natureSuitCode":"<string>","natureSuit":"<string>"}}'
```

### Collection updates in range

Retrieve new or updated packages for a collection within a date range (GovInfo system update time).

`GET /collections/{collection}/{lastModifiedStartDate}/{lastModifiedEndDate}`

**Estimated cost:** $0.003

**Page:** https://www.orthogonal.com/api/govinfo-api/1fa4b03d-1d1a-418c-a03b-93fbd359ae2d

**Docs:** https://api.govinfo.gov/docs/

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `collection` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `lastModifiedStartDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `lastModifiedEndDate` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `offsetMark` | string | No | Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response. |
| `offset` | integer | No | This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a> |
| `pageSize` | integer | Yes | The number of records to return for a given request. Max value is 1000 |
| `docClass` | string | No | Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, docClass in BILLS corresponds with Bill Type --e.g. s, hr, hres, sconres. |
| `congress` | integer | No | Filters results by Congress, where applicable. For example 113 or 114. |
| `billVersion` | string | No | Filter the results by overarching collection-specific categories. |
| `courtCode` | string | No |  |
| `courtType` | string | No |  |
| `state` | string | No |  |
| `topic` | string | No |  |
| `isGLP` | boolean | No |  |
| `natureSuitCode` | string | No |  |
| `natureSuit` | string | No |  |

```bash
# Replace {collection}, {lastModifiedStartDate}, {lastModifiedEndDate} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"govinfo-api","path":"/collections/{collection}/{lastModifiedStartDate}/{lastModifiedEndDate}","method":"GET","query":{"offsetMark":"<string>","offset":"<integer>","pageSize":"<integer>","docClass":"<string>","congress":"<integer>","billVersion":"<string>","courtCode":"<string>","courtType":"<string>","state":"<string>","topic":"<string>","isGLP":"<boolean>","natureSuitCode":"<string>","natureSuit":"<string>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/govinfo-api
