/citation/{citation}API keyThe passage itself
Quote, locator, section reference, hashes, retrieval time, effective date and provenance.
Operation ID get_citation_citation__citation__get
Parameters
path
- citationrequiredstring
- A
cit_id.
query
- context_lineinteger
- No description.
- format"json" | "markdown" | "html"
- No description.
Responses
- 200
- Single_Citation_
- Successful Response
- 401
- empty
- No usable credential.
- 402
- ErrorResponse
quota_exhausted: out of credit. Credit is prepaid and the balance cannot go below zero, so add credit rather than retrying.- 403
- ErrorResponse
entitlement_missing: the plan does not cover this operation.- 404
- ErrorResponse
- No such id. The only meaning of 404.
- 422
- ErrorResponse
- The request cannot be answered as asked. The code says why.
- 429
- ErrorResponse
rate_limited, withRetry-After.- 501
- ErrorResponse
not_available: this operation does not answer yet.
Example request
curl -X GET 'http://localhost:8000/citation/citation_123' \
-H 'X-API-Key: $PLACESTACK_API_KEY'Example response
{
"request": {
"path": "<Path>",
"param": {},
"dry_run": false
},
"meta": {
"contract_date": "2026-09-13",
"vocabulary_version": "<Vocabulary Version>",
"request_id": "req_01h455vb4pex5vsknk084sn02q",
"api_version": "v1",
"answer_id": "ans_01h455vb4pex5vsknk084sn02q",
"answer_through": 1,
"unit": {
"key": "string"
},
"cost": "<Cost>"
},
"item": {
"id": "cit_01h455vb4pex5vsknk084sn02q",
"jurisdiction": "jur_01h455vb4pex5vsknk084sn02q",
"document": "doc_01h455vb4pex5vsknk084sn02q",
"version": "ver_01h455vb4pex5vsknk084sn02q",
"locator": "<PdfPassage>",
"quote": "<Quote>",
"quote_sha256": "<Quote Sha256>",
"retrieved_at": "2026-09-13T12:00:00Z",
"provenance": "<Provenance>",
"href": "<Href>",
"section_ref": "<SectionRef>",
"context": "<Context>",
"adopted_on": "2026-09-13",
"effective_from": "2026-09-13",
"effective_through": "2026-09-13"
},
"as_of": {
"resolved": "<Interval>",
"timezone": "<Timezone>",
"basis": "requested",
"known_as_of": "2026-09-13T12:00:00Z",
"known_as_of_basis": "requested",
"requested": "string",
"earliest_retained": {
"key": "2026-09-13"
},
"constant": true,
"segment_count": 1
},
"notice": [
{
"code": "as_of_interval_spans_change",
"severity": "info",
"detail": "<Detail>",
"count": 1,
"subject": [
"string"
]
}
],
"coverage": {
"jurisdiction": "jur_01h455vb4pex5vsknk084sn02q",
"layer": {
"key": "<CoverageLayer>"
},
"href": "<Href>"
}
}