Skip to main content
GET
Unified Agenda history of one RIN

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

rin
string
required

Regulation Identifier Number NNNN-XXNN; lower case is accepted.

Maximum string length: 32
Pattern: ^[0-9]{4}[- ][A-Za-z]{2}[0-9]{2}$
Example:

"2060-AV16"

Query Parameters

from
string | null

Oldest Unified Agenda edition to include, as an edition id YYYYMM, for example 202010. Must not be later than to.

Pattern: ^[0-9]{6}$
to
string | null

Newest Unified Agenda edition to include, as an edition id YYYYMM, for example 202510. Must not be earlier than from.

Pattern: ^[0-9]{6}$
limit
integer
default:25

Editions per page, 1 to 100. Default 25.

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/rins/{rin}/agenda, newest edition first.

rin
string
required
editions
AgendaEdition · object[]
required
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 from/to matched no edition of a RIN the agenda does carry: names the editions that carried it. Such a page is not charged.