list_documents
Read-onlyIdempotent
List documents in a jurisdiction with structured filters and pagination. Use this tool when: - The user wants to find legal content for a specific jurisdiction and optional filters - The user asks about available content for a portal name, title, section_title, url, status, repealed, publication_date and crawling_date - The user wants to filter content for type of authority, issuing authority, source identifier, source secondary identifier, tag
Parameters:
- iso (required): Jurisdiction ISO code (e.g. "US").
- portal (optional): Portal name.
- limit (optional): Number of results to return.
- offset (optional): Number of results to skip.
- document_id (optional): Document ID.
- title (optional): Title.
- section_title (optional): Section title.
- url (optional): URL.
- last_updated (optional): Last updated date.
Returns:
- Contents list with title, section_title, publication_date, effective_date, expiration_date, date_of_enactment, date_of_last_amendment, date_of_repealed, date_of_decision, status, version, source_identifier, source_secondary_identifier, issuing_authority, type_of_authority, language, legal_link, repealed, metadata, summary, tags, source_keywords, crawling_date, portal, portal_name, last_updated
- Only returns content that has crawled dataInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iso | Yes | Filter by Jurisdiction ISO code (e.g. 'US') | |
| tag | No | Filter by tag | |
| url | No | Filter by URL | |
| lang | No | Filter by language | |
| limit | No | Number of results to return | |
| title | No | Filter by title | |
| offset | No | Number of results to skip | |
| portal | No | Filter by portal name | |
| status | No | Filter by status | |
| version | No | Filter by version | |
| repealed | No | Filter by repealed status | |
| document_id | No | Filter by document ID | |
| last_updated | No | Filter by last updated date | |
| crawling_date | No | Filter by crawling date | |
| section_title | No | Filter by section title | |
| effective_date | No | Filter by effective date | |
| file_data_only | No | Return file data only | |
| last_amendment | No | Filter by last amendment date | |
| expiration_date | No | Filter by expiration date | |
| date_of_decision | No | Filter by date of decision | |
| publication_date | No | Filter by publication date | |
| date_of_enactment | No | Filter by date of enactment | |
| issuing_authority | No | Filter by issuing authority | |
| source_identifier | No | Filter by source identifier | |
| type_of_authority | No | Filter by type of authority | |
| source_secondary_identifier | No | Filter by secondary source identifier |