GET /jurisdictions — List all jurisdiction rules

This endpoint returns the full set of jurisdiction rules in the Centsless database, including enacted, pending, and proposed legislation. Use it to build state-selection UIs that reflect current rounding law, audit your coverage before expanding to a new region, or sync jurisdiction data into your own system.

Endpoint

GET https://api.centsless.org/api/v1/jurisdictions

Authentication

All requests require an x-api-key header.

Code example

curl https://api.centsless.org/api/v1/jurisdictions \
  -H "x-api-key: YOUR_API_KEY"

Example response

[
  {
    "lookup_key": "AZ",
    "jurisdiction_id": "US-AZ",
    "jurisdiction_level": "state",
    "rounding_mode": "swedish_rounding",
    "enforcement": "mandatory",
    "status": "enacted",
    "legislation": "AZ HB 2938",
    "effective_date": "2025-01-01",
    "notes": "Swedish rounding required statewide.",
    "source_url": "https://leginfo.example.gov/az/hb2938"
  },
  {
    "lookup_key": "IN",
    "jurisdiction_id": "US-IN",
    "jurisdiction_level": "state",
    "rounding_mode": "symmetrical_rounding",
    "enforcement": "permissive",
    "status": "enacted",
    "legislation": "IN SB 243",
    "effective_date": "2025-07-01",
    "notes": "Three-tier operator choice; permissive for retail.",
    "source_url": "https://leginfo.example.gov/in/sb243"
  }
]

Response fields

Each object in the returned array represents one jurisdiction rule.

string

The key used to resolve this rule. Matches the state code, or a hyphen-delimited state-county or state-county-city string. Example: AZ

string

Jurisdiction identifier. Example: US-AZ

string

Where in the hierarchy this rule applies. One of: federal, state, county, city

string

The rounding algorithm that applies. One of: swedish_rounding, mandatory_round_down, mandatory_round_up, symmetrical_rounding, nearest_nickel, nearest_cent, nearest_dime, none

string

How strictly the rule applies. One of: mandatory, permissive, voluntary, none

string

Legislative status of the rule. One of: enacted, pending, proposed, failed, no_legislation

string

The bill or regulation that defines this rule. Example: AZ HB 2938

string

The date the rule took effect, in ISO 8601 date format.

string

Additional context about the rule’s scope or application.

string

URL to the authoritative legislative source.

Overview

Transactions

Jurisdiction

Tipping

Compliance & Audit

GET /jurisdictions — List all jurisdiction rules

Endpoint

Authentication

Code example

Example response

Response fields

​Endpoint

​Authentication

​Code example

​Example response

​Response fields

Endpoint

Authentication

Code example

Example response

Response fields