Skip to main content
GET
Browse and discover acts

Authorizations

Authorization
string
header
required

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

Query Parameters

category
enum<string>

Jurisdictional class of the instrument. repealed and spent are accepted for backward compatibility and resolve against the act's status instead. Values: central, state, regulatory, repealed, spent.

Available options:
central,
state,
regulatory,
repealed,
spent
Example:

"central"

state
enum<string>

Jurisdiction slug. central is a value here, for Union legislation. Live counts per jurisdiction are on GET /acts/coverage.

Available options:
andaman-and-nicobar-islands,
andaman-nicobar,
andhra-pradesh,
arunachal-pradesh,
assam,
bihar,
central,
chandigarh,
chhattisgarh,
dadra-and-nagar-haveli-and-daman-and-diu,
dadra-nagar-haveli,
delhi,
goa,
gujarat,
haryana,
himachal-pradesh,
jammu-and-kashmir,
jammu-kashmir,
jharkhand,
karnataka,
kerala,
ladakh,
lakshadweep,
madhya-pradesh,
maharashtra,
manipur,
meghalaya,
mizoram,
nagaland,
odisha,
puducherry,
punjab,
rajasthan,
sikkim,
tamil-nadu,
telangana,
tripura,
uttar-pradesh,
uttarakhand,
west-bengal
Example:

"maharashtra"

department
string | null

Issuing body. Deliberately NOT an enumerated list: this field holds 943 distinct values and mixes clean regulator slugs (sebi, rbi, moefcc) with free-text state department names (Law Department). Read GET /acts/filters for the values with the most data behind them.

Example:

"sebi"

yearFrom
integer | null

Earliest year of enactment to include, inclusive. Matched against the publisher's own year field, which is occasionally corrupt, so there is no lower bound and a value below 1800 is a legitimate way to find those rows.

Required range: x <= 2100
Example:

2015

yearTo
integer | null

Latest year of enactment to include, inclusive.

Required range: x <= 2100
Example:

2024

status
enum<string>

The publisher's lifecycle status for the act. Their claim, not our verdict: see GET /acts/{actId}/status. Values: in_force, repealed, superseded, spent.

Available options:
in_force,
repealed,
superseded,
spent
Example:

"repealed"

search
string | null

Keep only acts whose title contains this substring, matched case-insensitively. A title filter, not a search over the text: use POST /acts/search for that.

Required string length: 2 - 200
Example:

"income tax"

sort
enum<string>
default:year_desc

Sort order. popular is DEPRECATED and behaves as year_desc: it ordered by a read counter held only in the retired store. Values: year_desc, year_asc, title_asc, title_desc, popular.

Available options:
year_desc,
year_asc,
title_asc,
title_desc,
popular
Example:

"title_asc"

page
integer
default:1

1-based page number.

Required range: x >= 1
Example:

1

pageSize
integer
default:50

Results per page (1-100).

Required range: 1 <= x <= 100
Example:

50

Response

Successful Response

results
ActListItem · object[]
required
total
integer
required
page
integer
required
pageSize
integer
required
hasMore
boolean
required
meta
ActMeta · object

What this call cost and how long it took.

🔴 Added 2026-09-06. Five of the six original routes returned NO statement of what they billed: /text (3 credits), /amendments (5), /list (1), /filters (0) and /corresponding-provisions (1). The house rule on the US surface is that creditsConsumed is the CONTRACT and the list price is not, and it matters most exactly where refunds happen -- /text refunds on a missing act, /corresponding-provisions refunds when a mapping does not exist yet. Without this field a caller cannot tell a refunded call from a charged one, and has to reconcile against the ledger to find out.

note
string | null

Always set on this endpoint, naming the source that answered. On the normal path it carries the act index's BUILD DATE, because the listing is a snapshot and an act ingested after that date reaches search before it reaches here. If the index is unavailable the note is prefixed DEGRADED: and states the shortfall. A gap a caller can see is not the same as one they cannot.

Last modified on September 11, 2026