Skip to main content
GET
What points at this act

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_state_17068"

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 citing PROVISIONS across all pages, not rows on this page (that is returned) and not matching passages. One provision can be stored as many passages, so this is always the smaller of the two.

totalIsExact
boolean
required

False when the corpus scan behind total hit its ceiling, which makes total a floor rather than a count. The ceiling sits above the largest citing set in the corpus, so this is true today.

returned
integer
required

Rows in citers 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 citing provisions exists.

truncated
boolean
required

DEPRECATED, kept so an existing client does not break. True when hasMore is true or totalIsExact is false. Read those two instead: this one field cannot tell 'there is a page 2' apart from 'we stopped counting'.

matchBasis
string
required

publisher_title: edges are matched on the act's title as the publisher wrote it, so treat the result as a floor.

meta
Meta · object
required
title
string | null
citation
string | null
citers
CitedByRow · object[]
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.