> ## Documentation Index > Fetch the complete documentation index at: https://vaquill.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get statute section metadata > Get detailed metadata for a specific statute section by its ID. **Cost**: 2 credits ($0.02). Not-found (404) and failed lookups are not charged. The `actId` comes from `/statutes/search` results or Ask API sources (e.g., `USC_T42_C21_S1983`). It is structured but not meant to be hand-built; always take it from a prior response. Returns citation, title hierarchy, breadcrumb, and links to every available format (HTML, PDF, XML, plain text, DOCX) where the source provides them. Use `/statutes/section/{actId}/body` for the full text. ## OpenAPI ````yaml https://api.vaquill.ai/external/openapi.json get /api/v1/statutes/section/{act_id} openapi: 3.1.0 info: title: Vaquill Developer API description: >- Public API for legal statutes and legislation. **Authentication**: Pass your API key via the `Authorization: Bearer vq_key_...` header. **Credits**: Each call costs API credits. See `GET /api/v1/api-credits/pricing` for the full pricing matrix. ## Jurisdictions | Jurisdiction | Coverage | `countryCode` | |---|---|---| | **United States** | USC, CFR, nearly all 50 state statutory codes (plus DC and Puerto Rico), state constitutions, and court rules. | `US` | See the full [Coverage page](https://www.vaquill.ai/docs/coverage) for the jurisdiction-by-jurisdiction breakdown, or call `/statutes/states` for live counts. ## Endpoints - **US Statutes**: Search and retrieve USC, CFR, state statutes, constitutions, court rules, executive orders, and regulations with full text - **Pricing**: Credit costs per endpoint (no auth required) ## Rate limits Limits are enforced per API key and scale with your plan. A `429` response includes a `Retry-After` header. | Plan | Per minute | Per hour | Per day | |---|---|---|---| | API ($199/mo, 1x) | 30 | 500 | 2,000 | | API Business ($1,000/mo, 5x) | 150 | 2,500 | 10,000 | For full documentation, visit the [API Reference](https://www.vaquill.ai/docs/api-reference/). version: 1.0.0 contact: name: Vaquill API Support url: https://www.vaquill.ai email: support@vaquill.ai license: name: Proprietary url: https://www.vaquill.ai/terms termsOfService: https://www.vaquill.ai/terms servers: - url: https://api.vaquill.ai description: Production security: - ApiKeyAuth: [] tags: - name: US Statutes description: >- Search and retrieve US statutes. Covers the United States Code (USC), Code of Federal Regulations (CFR), all 50 state statutes, constitutions, court rules, executive orders, Federal Register agency rules, agency guidance, and state regulations. Scope a search with the `corpusType` filter. - **Search**: Search across all USC, CFR, state, and regulatory sections - **Section**: Get metadata, citation, hierarchy, and source links for a specific section - **Body**: Get the full text of a section - name: Pricing description: >- Credit pricing and conversion rates. No authentication required. 1 credit = $0.01 USD. externalDocs: description: Full API Reference url: https://www.vaquill.ai/docs/api-reference/ paths: /api/v1/statutes/section/{act_id}: get: tags: - US Statutes summary: Get statute section metadata description: >- Get detailed metadata for a specific statute section by its ID. **Cost**: 2 credits ($0.02). Not-found (404) and failed lookups are not charged. The `actId` comes from `/statutes/search` results or Ask API sources (e.g., `USC_T42_C21_S1983`). It is structured but not meant to be hand-built; always take it from a prior response. Returns citation, title hierarchy, breadcrumb, and links to every available format (HTML, PDF, XML, plain text, DOCX) where the source provides them. Use `/statutes/section/{actId}/body` for the full text. operationId: get_section_api_v1_statutes_section__act_id__get parameters: - name: act_id in: path required: true schema: type: string minLength: 3 maxLength: 200 description: Section identifier (e.g., 'USC_T42_C21_S1983'). examples: - USC_T42_C21_S1983 title: Act Id description: Section identifier (e.g., 'USC_T42_C21_S1983'). responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StatuteSectionResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: StatuteSectionResponse: properties: section: $ref: '#/components/schemas/StatuteResult' processingTimeMs: type: number title: Processingtimems default: 0 creditsConsumed: type: number title: Creditsconsumed default: 0 type: object required: - section title: StatuteSectionResponse description: Detailed section metadata (no full text, use /body for that). HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError StatuteResult: properties: actId: type: string title: Actid description: >- Unique section identifier (e.g., 'USC_T42_C21_S1983', 'CFR_T17_P240_S240_10b5_1'). citation: anyOf: - type: string - type: 'null' title: Citation description: >- Full citation (e.g., '42 U.S.C. § 1983 (2024)', '17 C.F.R. § 240.10b5-1 (2026)'). citationShort: anyOf: - type: string - type: 'null' title: Citationshort description: Short citation (e.g., '42 U.S.C. § 1983', '17 C.F.R. § 240.10b5-1'). title: anyOf: - type: string - type: 'null' title: Title description: Section title. corpusType: anyOf: - type: string - type: 'null' title: Corpustype description: >- One of `USC`, `CFR`, `STATE`, `CONSTITUTION`, `FEDERAL_RULES`, `STATE_CONSTITUTION`, `STATE_RULES`, or `EXECUTIVE_ACTION`. state: anyOf: - type: string - type: 'null' title: State description: >- 2-letter lowercase state code (e.g. `ca`, `tx`) when the row belongs to a state corpus. `federal` for federal rows. year: anyOf: - type: integer - type: 'null' title: Year description: Year of the statute version. relevanceScore: type: number title: Relevancescore description: >- Relevance score, normalized to roughly 0-1. Higher means a better match for ranking within one response. It is a relative ranking signal, not a calibrated confidence or probability, so do not compare scores across different queries or treat a fixed value as a quality threshold. default: 0 excerpt: type: string title: Excerpt description: Text excerpt (up to 500 characters). default: '' titleNumber: anyOf: - type: string - type: 'null' title: Titlenumber description: USC/CFR/state title number (e.g. '26', '13A'). titleName: anyOf: - type: string - type: 'null' title: Titlename description: Title name (e.g., 'The Public Health and Welfare'). chapter: anyOf: - type: string - type: 'null' title: Chapter description: Chapter number or identifier. chapterName: anyOf: - type: string - type: 'null' title: Chaptername description: Chapter name. sectionNumber: anyOf: - type: string - type: 'null' title: Sectionnumber description: Section number (e.g., '1983', '240.10b5-1'). displayPath: anyOf: - type: string - type: 'null' title: Displaypath description: Full hierarchical path (Title > Chapter > Section). breadcrumb: anyOf: - items: additionalProperties: type: string type: object type: array - type: 'null' title: Breadcrumb description: Structured breadcrumb trail for navigation. htmlUrl: anyOf: - type: string - type: 'null' title: Htmlurl description: HTML version of the statute section. pdfUrl: anyOf: - type: string - type: 'null' title: Pdfurl description: PDF version of the statute section. xmlUrl: anyOf: - type: string - type: 'null' title: Xmlurl description: XML version of the statute section. textUrl: anyOf: - type: string - type: 'null' title: Texturl description: >- Plain-text version. Populated for state corpora (MS, NJ, NY, NV, etc.). docxUrl: anyOf: - type: string - type: 'null' title: Docxurl description: Microsoft Word (DOCX) version, when available. stateHtmlUrl: anyOf: - type: string - type: 'null' title: Statehtmlurl description: >- Official HTML hosted by the state legislature (publisher's URL). Populated for state corpora only. govInfoHtmlUrl: anyOf: - type: string - type: 'null' title: Govinfohtmlurl description: Official govinfo.gov HTML version. govInfoPdfUrl: anyOf: - type: string - type: 'null' title: Govinfopdfurl description: Official govinfo.gov PDF version. externalUrl: anyOf: - type: string - type: 'null' title: Externalurl description: URL on the official source website (eCFR or uscode.house.gov). type: object required: - actId title: StatuteResult description: A single statute section from search results. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: vq_key_* description: >- API key issued from the Vaquill developer dashboard. Pass as `Authorization: Bearer vq_key_...` ````