Skip to main content
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.
​
lookup_key
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
​
jurisdiction_id
string
Jurisdiction identifier. Example: US-AZ
​
jurisdiction_level
string
Where in the hierarchy this rule applies. One of: federal, state, county, city
​
rounding_mode
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
​
enforcement
string
How strictly the rule applies. One of: mandatory, permissive, voluntary, none
​
status
string
Legislative status of the rule. One of: enacted, pending, proposed, failed, no_legislation
​
legislation
string
The bill or regulation that defines this rule. Example: AZ HB 2938
​
effective_date
string
The date the rule took effect, in ISO 8601 date format.
​
notes
string
Additional context about the rule’s scope or application.
​
source_url
string
URL to the authoritative legislative source.