Documents of one docket, oldest first

curl --request GET \
  --url https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "docketId": "<string>",
  "documents": [
    {
      "documentId": "EPA-HQ-OAR-2021-0208-0001",
      "sourceUrl": "<string>",
      "docketId": "<string>",
      "agencyId": "<string>",
      "documentType": "<string>",
      "subtype": "<string>",
      "title": "<string>",
      "frDocNum": "<string>",
      "frDocNumNorm": "<string>",
      "postedAt": "2023-11-07T05:31:56Z",
      "commentStartAt": "2023-11-07T05:31:56Z",
      "commentEndAt": "2023-11-07T05:31:56Z",
      "openForComment": true,
      "withinCommentPeriod": true,
      "allowLateComments": true,
      "withdrawn": true,
      "lastModifiedAt": "2023-11-07T05:31:56Z",
      "cfrPart": "<string>",
      "frPages": "<string>",
      "commentCount": 123,
      "commentCountAsOf": "2023-11-07T05:31:56Z",
      "asOf": "2023-11-07T05:31:56Z"
    }
  ],
  "processingTimeMs": 0,
  "creditsConsumed": 0,
  "nextCursor": "<string>",
  "note": "<string>"
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

GET

api

rulemaking

dockets

{docket_id}

documents

Documents of one docket, oldest first

curl --request GET \
  --url https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vaquill.ai/api/v1/us/rulemaking/dockets/{docket_id}/documents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "docketId": "<string>",
  "documents": [
    {
      "documentId": "EPA-HQ-OAR-2021-0208-0001",
      "sourceUrl": "<string>",
      "docketId": "<string>",
      "agencyId": "<string>",
      "documentType": "<string>",
      "subtype": "<string>",
      "title": "<string>",
      "frDocNum": "<string>",
      "frDocNumNorm": "<string>",
      "postedAt": "2023-11-07T05:31:56Z",
      "commentStartAt": "2023-11-07T05:31:56Z",
      "commentEndAt": "2023-11-07T05:31:56Z",
      "openForComment": true,
      "withinCommentPeriod": true,
      "allowLateComments": true,
      "withdrawn": true,
      "lastModifiedAt": "2023-11-07T05:31:56Z",
      "cfrPart": "<string>",
      "frPages": "<string>",
      "commentCount": 123,
      "commentCountAsOf": "2023-11-07T05:31:56Z",
      "asOf": "2023-11-07T05:31:56Z"
    }
  ],
  "processingTimeMs": 0,
  "creditsConsumed": 0,
  "nextCursor": "<string>",
  "note": "<string>"
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

{
  "detail": "Insufficient API credits.",
  "errors": [
    {
      "loc": [
        "body",
        "query"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "code": "insufficient_credits",
  "type": "https://www.vaquill.ai/docs/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "requestId": "8d32789e-7b27-44f7-9523-424596e7a929",
  "retryable": false,
  "retryAfterSeconds": 30,
  "actId": "UNKNOWN_99999",
  "reason": "not_in_registry",
  "didYouMean": [
    "<string>"
  ],
  "sessionLawId": "Pub. L. 117-58",
  "defaultSessionLawId": "us1_ca_2019_ch_123",
  "candidateCount": 3,
  "truncated": false,
  "jurisdictions": [
    "<string>"
  ],
  "sessionCoverage": {},
  "creditsRequired": 5,
  "creditsAvailable": 2,
  "topUpHint": "Add credits in the developer dashboard, then retry the same request."
}

Authorizations

Authorization

string

header

required

API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_... (preferred).

Headers

Idempotency-Key

string | null

Optional. 16 to 255 visible ASCII characters (a UUIDv4 works). Repeating the same request with the same key replays the original 2xx response for 24 hours without charging again. The same key on a different request is rejected. With the account's cacheQueryDerivedData retention setting off, no body is stored and a retry answers 409 idempotency_replay_unavailable, still without a second charge.

Required string length: 16 - 255

Pattern: ^[\x21-\x7e]+$

Example:

"3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f"

Path Parameters

docket_id

string

required

Regulations.gov docket id, for example EPA-HQ-OAR-2021-0208. Case is kept as printed.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9][A-Za-z0-9_.-]*$

Example:

"EPA-HQ-OAR-2021-0208"

Query Parameters

documentType

string | null

Only documents of this Regulations.gov document type. Case is ignored.

Maximum string length: 64

Example:

"Proposed Rule"

openForComment

boolean | null

true keeps only documents whose comment period is open.

Example:

true

postedFrom

string<date-time> | null

Only documents posted at or after this ISO-8601 instant.

Example:

"2026-01-01T00:00:00Z"

postedTo

string<date-time> | null

Only documents posted before this ISO-8601 instant (exclusive). The window is half-open, postedFrom <= posted < postedTo, so equal bounds select nothing and are refused with a 422: postedTo must be after postedFrom.

Example:

"2026-07-01T00:00:00Z"

limit

integer

default:50

Page size, 1 to 100.

Required range: 1 <= x <= 100

cursor

string | null

nextCursor of the previous page; same filters.

Maximum string length: 400

Response

Successful Response

Response for GET /us/rulemaking/dockets/{docketId}/documents, oldest first.

docketId

string

required

documents

RulemakingDocument · object[]

required

Show child attributes

processingTimeMs

number

default:0

Server-side time in milliseconds, not billed on.

creditsConsumed

number

default:0

Credits charged for this call. 0 when not charged or refunded.

nextCursor

string | null

note

string | null

Set when the page is empty: says why and which filters applied. An empty page is refunded (creditsConsumed 0).

US Statutes

Pricing

Board Watches

Credits

Agent Onboarding

US Session Laws

US Rulemaking

Documents of one docket, oldest first

Authorizations

Headers

Path Parameters

Query Parameters

Response