get_sections_batch
Batch-fetch metadata for up to 50 legal sections per call, preserving order and reporting missing IDs, to enrich search results with fewer round trips.
Instructions
Metadata for up to 50 sections in one call.
Cost: 2 credits per section returned. Identifiers with no match are refunded, so a batch of 50 ids that resolves 47 costs 94 credits, not 100. Batching is a round-trip and latency win, not a discount.
Exists because enriching a search page previously meant one HTTP call per
result: a 50-result page was 50 round trips. The response preserves the order of
actIds and reports misses separately in notFound, so results can be zipped
back onto the ids that produced them.
Use /us/statutes/section/{actId}/body for full text; this endpoint returns
metadata and source links only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actIds | Yes | Section identifiers from a prior `/us/statutes/search` response. Up to 50 per call. Duplicates are collapsed, and order is preserved in the response. Each id encodes the citation's hierarchy: `USC_T42_C21_S1983` is Title 42, Chapter 21, Section 1983. The chapter is not derivable from a citation, so take ids from search results rather than assembling them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||