curl -X POST https://win.oneshotagent.com/v1/tools/find/record-dockets \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-dockets", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}),
});
const result = await agent.tool('find/record-dockets', {
query: 'unmanned aircraft',
agency: 'FAA',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_dockets_find",
"result": {
"total": 91,
"dockets": [
{
"docket_id": "FAA-2023-1271",
"agency": "FAA",
"type": "Nonrulemaking",
"title": "List of Approved Unmanned Aircraft Systems under Section 44807",
"last_modified_at": "2026-10-02T15:06:24Z",
"url": "https://www.regulations.gov/docket/FAA-2023-1271"
},
{
"docket_id": "FAA-2026-4558",
"agency": "FAA",
"type": "Rulemaking",
"title": "Designation – Restrict the Operation of Unmanned Aircraft in Close Proximity to a Fixed Site Facility",
"last_modified_at": "2026-09-03T12:41:32Z",
"url": "https://www.regulations.gov/docket/FAA-2026-4558"
}
]
},
"evidence": {
"source": "US General Services Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Government & legal
Regulatory Dockets
Find the US federal agency dockets, rulemaking and nonrulemaking, that match search words.
POST
/
v1
/
tools
/
find
/
record-dockets
curl -X POST https://win.oneshotagent.com/v1/tools/find/record-dockets \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-dockets", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}),
});
const result = await agent.tool('find/record-dockets', {
query: 'unmanned aircraft',
agency: 'FAA',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_dockets_find",
"result": {
"total": 91,
"dockets": [
{
"docket_id": "FAA-2023-1271",
"agency": "FAA",
"type": "Nonrulemaking",
"title": "List of Approved Unmanned Aircraft Systems under Section 44807",
"last_modified_at": "2026-10-02T15:06:24Z",
"url": "https://www.regulations.gov/docket/FAA-2023-1271"
},
{
"docket_id": "FAA-2026-4558",
"agency": "FAA",
"type": "Rulemaking",
"title": "Designation – Restrict the Operation of Unmanned Aircraft in Close Proximity to a Fixed Site Facility",
"last_modified_at": "2026-09-03T12:41:32Z",
"url": "https://www.regulations.gov/docket/FAA-2026-4558"
}
]
},
"evidence": {
"source": "US General Services Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Searches the dockets of US federal agencies on the federal regulations portal, newest change first: docket id, agency, type (rulemaking or nonrulemaking), title, the date of its last change and a link. A docket is the file a rule or notice and its public comments sit in; this returns the dockets, not the documents or comments inside them.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Search words, for example unmanned aircraft. 2 to 200 characters.
string
Only dockets of this agency, as its acronym, for example FAA or EPA. 2 to 10 characters. Use the agency acronym, letters and digits only.
string
Only dockets of this kind. One of
rulemaking, nonrulemaking.integer
The most dockets to return. From 1 to 25. Defaults to
10.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
record_dockets_findobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US General Services Administration.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
number
How many dockets matched, including any beyond
limit.object[]
The matching dockets, newest change first.
string | null
The docket id, for example FAA-2019-1100.
null when the source gives no value.string | null
The acronym of the agency that keeps the docket.
null when the source gives no value.string | null
Rulemaking or Nonrulemaking.
null when the source gives no value.string | null
The docket title.
null when the source gives no value.string | null
When the docket last changed, ISO 8601.
null when the source gives no value.string | null
The docket on the federal regulations portal.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/find/record-dockets \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/find/record-dockets", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"query": "unmanned aircraft",
"agency": "FAA",
"limit": 2
}),
});
const result = await agent.tool('find/record-dockets', {
query: 'unmanned aircraft',
agency: 'FAA',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "record_dockets_find",
"result": {
"total": 91,
"dockets": [
{
"docket_id": "FAA-2023-1271",
"agency": "FAA",
"type": "Nonrulemaking",
"title": "List of Approved Unmanned Aircraft Systems under Section 44807",
"last_modified_at": "2026-10-02T15:06:24Z",
"url": "https://www.regulations.gov/docket/FAA-2023-1271"
},
{
"docket_id": "FAA-2026-4558",
"agency": "FAA",
"type": "Rulemaking",
"title": "Designation – Restrict the Operation of Unmanned Aircraft in Close Proximity to a Fixed Site Facility",
"last_modified_at": "2026-09-03T12:41:32Z",
"url": "https://www.regulations.gov/docket/FAA-2026-4558"
}
]
},
"evidence": {
"source": "US General Services Administration",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Optionally narrow by
agency(its acronym, for example FAA or EPA) and bydocket_type(rulemaking or nonrulemaking). - Use it to find where an agency keeps the record of a rule and its public comments; use the Federal Register documents tool for the published rules and notices themselves.
totalis how many dockets matched, including any beyondlimit, and is 0 when none did.- Each docket links to its page on the portal, which lists its documents and comments.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}