Skip to main content
GET
Terms this act defines

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 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body.

Required string length: 16 - 255
Pattern: ^[\x21-\x7e]+$
Example:

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

Path Parameters

act_id
string
required

Act identifier, as returned by /acts/search, /acts/list or /acts/resolve, e.g. IND_central_20062 (the Bharatiya Nyaya Sanhita, 2023). Surrounding whitespace, quotes, backticks, invisible characters, a trailing period and double percent-encoding are removed when the id as sent matches nothing; the response then carries resolvedFrom.

An act NAME or citation (Indian Penal Code, IPC, The Companies Act, 2013) is not resolved here. It returns 404 with reason: "act_name_or_citation" and suggestedRequest, the call that finds the id. A misspelt id returns 404 with the real ids in didYouMean.

Required string length: 1 - 200
Pattern: ^[^/\\\x00-\x1f]+$
Example:

"IND_central_2114"

Query Parameters

page
integer
default:1

1-based page number.

Required range: x >= 1
Example:

1

pageSize
integer | null

Rows per page (1-100). Defaults to 25.

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

25

limit
integer | null
deprecated

DEPRECATED alias for pageSize, kept working for clients written against the original shape. Send one or the other, not both.

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

25

Response

Successful Response

actId
string
required
total
integer
required

Distinct terms this act defines, across all pages. Not rows on this page: that is returned.

returned
integer
required

Rows in terms on THIS page.

page
integer
required

1-based page this response answers.

pageSize
integer
required

Rows per page requested.

hasMore
boolean
required

True when a further page of terms exists.

totalDefinitionSections
integer
required

Definition clauses found, before the cap on rows. Larger than len(definitionSections) only in the pathological case.

meta
Meta · object
required
citation
string | null
terms
DefinedTerm · object[]
definitionSections
ReferencedSection · object[]

Provisions identified as definition clauses. Returned separately so a defining provision is reachable even when no terms were extracted from it. NOT paged: this list is short, and page moves terms only, so it is repeated in full on every page.

note
string | null
resolvedFrom
IdentifierResolution · object | null

How your act_id or section number was matched, when it did not match exactly as sent. Null when it did.