US Rulemaking

One Regulations.gov docket

Changed on

A rulemaking or non-rulemaking docket from Regulations.gov: agency, type, title, abstract, the RIN when the agency entered one, when it was last modified, how many documents we hold and of which types, and the comment count when we measured it (null means not measured, never zero). Current state only. Unknown docket: 404, refunded.

get/api/v1/us/rulemaking/dockets/{docket_id}

Request

Path parameters

docket_idstring required

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

Example:EPA-HQ-OAR-2021-0208

Headers

Idempotency-Keystring nullable

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.

Example:3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f

Response

Successful Response

processingTimeMsnumber

Server-side time in milliseconds, not billed on.

creditsConsumedinteger

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

docketIdstring required

Regulations.gov docket id.

agencyIdstring required

Regulations.gov agency id.

docketTypestring nullable

Rulemaking or Nonrulemaking.

titlestring nullable
rinstring nullable

Regulation Identifier Number, normalised. Regulations.gov's value when it has one, otherwise the single RIN our cross-link spine holds as verified for this docket (see rinSource). Null when neither exists, or when the spine names several RINs (no pick is made).

rinSource'regulations_gov' | 'spine' nullable

Where rin came from: regulations_gov (the publisher) or spine (our verified cross-link). Null when rin is null.

spineRinstring nullable

Set only when the spine holds a verified RIN that DIFFERS from the publisher's rin. rin stays the publisher's value.

lastModifiedAtstring date-time nullable

Regulations.gov lastModifiedDate.

commentCountinteger nullable

Comments received. Null means NOT MEASURED, never zero. See commentCountAsOf.

commentCountAsOfstring date-time nullable

When we measured commentCount.

sourceUrlstring required

The docket page on regulations.gov.

asOfstring date-time nullable

When we last saw this docket at the publisher.

abstractstring nullable
modifyDatestring date-time nullable
documentCountinteger

Documents of this docket that we hold.

documentTypeCountsobject

Example response

{
  "docketId": "EPA-HQ-OAR-2021-0208",
  "agencyId": "EPA",
  "rin": "2060-AV16",
  "rinSource": "spine",
  "spineRin": "2120-AA64"
}

Changes

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status