Skip to main content
GET
Get a regulatory document

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Path Parameters

documentId
string<uuid>
required

Document id from listRegulatoryDocuments.

Response

The stored document.

id
string<uuid>
required

Document identity. A duplicate cleanup can delete an ID; find the document again.

state
string
required

Two-letter jurisdiction code, or ALL for national NAIC material.

kind
enum<string>
required

Document kind. New values can be added; tolerate values you do not recognize.

Available options:
bulletin,
circular_letter,
data_call,
examination_standards,
filing_requirement,
form_checklist,
guideline,
informational_memo,
legislative_bill,
mcas_scorecard,
meeting_materials,
model_law,
model_law_adoption,
news_release,
order,
reference_document,
regulation,
statute,
survey
identifier
string | null
required

The publisher's identifier, such as 28 TAC § 5.7013. Null when the source gave none. Not unique within a state.

title
string
required

The source title. Statute titles are path slugs today.

status
enum<string> | null
required

Lifecycle status, one flat set across kinds. Bills use introduced, passed_chamber, enacted, vetoed, withdrawn and failed; other kinds use final, informational, emergency, proposed, withdrawn and superseded. New values can be added; tolerate values you do not recognize. Null means the source gave none.

Available options:
final,
informational,
emergency,
proposed,
withdrawn,
superseded,
introduced,
passed_chamber,
enacted,
vetoed,
failed,
null
publishedDate
string<date> | null
required

The publisher's date, as stored. It can be null or wrong. A year-only date is stored as 1 January.

firstSeenAt
string<date-time>
required

When the corpus first stored this document, UTC. Backfills and changed source URLs can make an old document look new.

toiCodes
string[] | null
required

TOI values, including H, L, T and ALL. Null means never classified; [] means classified and none apply.

impactTags
string[] | null
required

Impact tags, normally values of V2RegulatoryImpactTag; a few stored tags fall outside that set. Same null and [] rule as toiCodes.

summary
string | null
required

A research aid, not the source. Null for most documents.

effectiveDate
string<date> | null
required

The effective date, when the source gives one.

Laws the document cites, as written. Null means never extracted. A cited law can be missing from references.

sourceUrl
string
required

The publisher's page for this document.

fileId
string<uuid> | null
required

The stored source file, when we hold one. Download it with GET /files/{fileId}/download. Recent documents often have none.