OpenZac

Jurisdictions

Use this resource to find specific jurisdictions and their IDs so that you can filter in other parts of the API.

The jurisdiction model

The jurisdiction model represents a taxing entity in the OpenZac database. It can be a city, county, special district, or some other kind of local taxing authority.

Properties

  • Name
    id
    Type
    integer
    Description

    The unique ID for this jurisdiction in the OpenZac database

  • Name
    slug
    Type
    string
    Description

    A sluggified version of the name. Not currently used but reserved for possible future use

  • Name
    state
    Type
    string
    Description

    The two-digit state code in which this jurisdiction resides (tx, ca)

  • Name
    type
    Type
    string
    Description

    The type of jurisdiction. Options: city, county, transit, spd

  • Name
    sales_tax_rate
    Type
    decimal
    Description

    The rate at which sales are taxed for this jurisdiction (this is not necessarily an overlapping rate)

  • Name
    sales_tax_id
    Type
    string
    Description

    This represents the unique tax authority ID for this jurisdiction, often set at the state level

GET /api/jurisdictions

List all jurisdictions

This endpoint allows you to retrieve a paginated list of all jurisdictions in the database. By default, a maximum of 25 allocations are shown per page.

Optional parameters

  • Name
    q
    Type
    string
    Description

    A search query for filtering jurisdictions by name (prefix matching)

  • Name
    state
    Type
    string
    Description

    A two-digit state code for filtering jurisdictions (tx, ca)

  • Name
    type
    Type
    string
    Description

    A jurisdiction type for filtering. Options: city, county, transit, spd

  • Name
    sales_tax_id
    Type
    string
    Description

    Filter by the state-assigned sales tax identifier

  • Name
    limit
    Type
    integer
    Description

    Limit the number of results returned. Default: 25

Request

GET
/api/jurisdictions 
curl -G https://open.zactax.com/api/jurisdictions \
    -H "Authorization: Bearer {token}" \
    -d q=Hudson \
    -d state=tx \
    -d limit=5
GET
/api/jurisdictions 
const response = await fetch('https://open.zactax.com/api/jurisdictions?q=Hudson&state=tx&limit=5', {
    headers: {
        'Authorization': 'Bearer {token}'
    }
});
const data = await response.json();

Response

{
    "data": [
        {
            "id": 624,
            "name": "Hudson Oaks, Texas",
            "slug": "hudson-oaks-texas",
            "state": "tx",
            "type": "city",
            "sales_tax_rate": 0.02,
            "sales_tax_id": "2184071"
        },
        {
            "id": 623,
            "name": "Hudson, Texas",
            "slug": "hudson-texas",
            "state": "tx",
            "type": "city",
            "sales_tax_rate": 0.015,
            "sales_tax_id": "2003052"
        }
    ],
    "links": {
        "first": "...",
        "last": "...",
        "prev": null,
        "next": "..."
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 25,
        "to": 2,
        "total": 2
    }
}