Legalize · Schema

PaginatedLaws

Unified response for law listing and search. When searching (query is not None), both ``total`` and ``count`` are populated with the same value for backward compatibility. When listing, ``query`` and ``count`` are None.

OpenLegislationOpen SourceDataTransparencyLegal Tech

Properties

Name Type Description
country string
total integer
page integer
per_page integer
jurisdiction object
query object
count object
sort object
from_date object
to_date object
results array
View JSON Schema on GitHub

JSON Schema

legalize-dev-paginated-laws-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/legalize-dev/json-schema/legalize-dev-paginated-laws-schema.json",
  "title": "PaginatedLaws",
  "description": "Unified response for law listing and search.\n\nWhen searching (query is not None), both ``total`` and ``count``\nare populated with the same value for backward compatibility.\nWhen listing, ``query`` and ``count`` are None.",
  "x-generated": "2026-11-15",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/legalize-dev-openapi.yml#/components/schemas/PaginatedLaws",
  "properties": {
    "country": {
      "type": "string",
      "title": "Country"
    },
    "total": {
      "type": "integer",
      "title": "Total"
    },
    "page": {
      "type": "integer",
      "title": "Page"
    },
    "per_page": {
      "type": "integer",
      "title": "Per Page"
    },
    "jurisdiction": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Jurisdiction"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Query"
    },
    "count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Count"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sort"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "To Date"
    },
    "results": {
      "items": {
        "$ref": "#/$defs/LawSearchResult"
      },
      "type": "array",
      "title": "Results"
    }
  },
  "type": "object",
  "required": [
    "country",
    "total",
    "page",
    "per_page",
    "results"
  ],
  "$defs": {
    "LawSearchResult": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "short_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Short Title"
        },
        "country": {
          "type": "string",
          "title": "Country"
        },
        "law_type": {
          "type": "string",
          "title": "Law Type"
        },
        "publication_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Publication Date"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Status"
        },
        "jurisdiction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Jurisdiction"
        },
        "article_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Article Count"
        },
        "text_state": {
          "type": "string",
          "title": "Text State",
          "default": "point_in_time"
        },
        "reform_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reform Count"
        },
        "text_superseded": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Text Superseded"
        },
        "title_snippet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Title Snippet"
        },
        "match_basis": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "identifier",
                "text"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Match Basis"
        },
        "content_availability": {
          "type": "string",
          "const": "unchecked",
          "title": "Content Availability",
          "default": "unchecked"
        },
        "articles_indexed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Articles Indexed",
          "description": "Metadata counts do not establish an index in the currently served body.",
          "readOnly": true
        }
      },
      "type": "object",
      "required": [
        "id",
        "title",
        "country",
        "law_type",
        "articles_indexed"
      ],
      "title": "LawSearchResult",
      "description": "Law result with search snippet."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/legalize-dev-paginated-laws"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.