---
title: "List jurisdictions"
method: GET
path: "/api/v1/jurisdictions"
tags: ["Jurisdictions"]
---

# List jurisdictions

`GET /api/v1/jurisdictions`

## Request

- Base URL: `https://ailawframework.com`
- URL: `https://ailawframework.com/api/v1/jurisdictions`
- Auth: HTTP bearer

Countries, the Commonwealth, states and territories, and the financial-centre and international rows.

## Query parameters

- `page` integer
- `per_page` integer
- `country` string
- `kind` 'country' | 'commonwealth' | 'state' | 'territory' | 'supranational' | 'financial_centre' | 'meta'

## Response `200`

A page of jurisdictions.

- object
  - `data` Jurisdiction[], required
    - `id` string
    - `slug` string
    - `name` string
    - `kind` 'country' | 'commonwealth' | 'state' | 'territory' | 'supranational' | 'financial_centre' | 'meta'
    - `country` string, nullable: Country id.
    - `parent_id` string, nullable: Parent jurisdiction id.
    - `child_ids` string[]: Child ids.
    - `url` string, uri
    - `coverage` string[]: Coverage.
    - `introduction` string[]: Introduction.
    - `overview` object: The overview of an area or jurisdiction.
      - `summary` string
      - `principles` object[]
        - `title` string
        - `text` string
      - `checklist` string[]: Checklist.
      - `restrictions` string[]: Restrictions.
      - `jurisdiction_note` string
      - `basis` string
      - `sources` object[]
        - `title` string
        - `url` string, uri
        - `checked` string, nullable: Date the source was last read.
      - `related_area_ids` string[]: Related area ids.
      - `related_jurisdiction_ids` string[]: Related jurisdiction ids.
    - `guidance` object[]
      - `type` string, nullable: Block type.
      - `id` string
      - `heading` string, nullable: Heading, worded as the page words it.
      - `text` string
      - `items` string[]: List items.
      - `headers` string[]: Table column headings.
      - `rows` array[]
        - string[]: One table row.
      - `table_id` string
      - `tag` string
    - `version_count` integer
    - `level_counts` object: Number of tasks at each level.
      - `green` integer
      - `yellow` integer
      - `red` integer
    - `ai_rules` AiRule[]
      - `id` string
      - `jurisdiction_id` string
      - `title` string
      - `issuer` string
      - `kind` string
      - `url` string, uri
      - `summary` string
      - `effective_date` string, nullable: Effective date.
      - `secondary_source` boolean
      - `source_reliance` 'primary' | 'secondary': Secondary when the instrument was recorded from a secondary source.
      - `verify_note` string, nullable: What to verify.
      - `anchor` string
    - `coverage_notes` object[]
      - `id` string
      - `jurisdiction_id` string
      - `body` string
      - `note` string
      - `url` string, nullable: Source.
      - `checked` string, nullable: Date checked.
    - `updated_at` string, nullable: ISO 8601.
  - `links` Links, required: Page links, as a Laravel LengthAwarePaginator renders them. Follow next until it is null.
    - `first` string, uri
    - `last` string, uri
    - `prev` string, uri, nullable
    - `next` string, uri, nullable
  - `meta` ListMeta, required: Paging details and the notice.
    - `current_page` integer
    - `from` integer, nullable
    - `last_page` integer
    - `path` string, uri
    - `per_page` integer
    - `to` integer, nullable
    - `total` integer
    - `notice` string: The planning-guidance disclaimer. Show it wherever you show the guidance.

## Other responses

- `304`: The If-None-Match you sent matches: nothing has changed.
- `401`: No key, or not a configured key.
- `422`: A parameter has a bad value.
- `503`: The database could not be read. Retry. Nothing partial is ever returned.

---

[API](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api.md) · [All operations](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api/revisions/34dac450f68c?raw)