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
    name
    Type
    string
    Description

    The jurisdiction's name.

  • 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.

  • Name
    type
    Type
    string
    Description

    The type of jurisdiction this is. Could be city, county, transit, or special_district.

  • Name
    sales_tax_rate
    Type
    decimal
    Description

    The rate at which sales are taxed for this juridiction (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 /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 attributes

  • Name
    q
    Type
    string
    Description

    A search query for filtering jurisdictions.

  • Name
    state
    Type
    string
    Description

    A two-digit state code for filtering jurisdictions

  • Name
    type
    Type
    string
    Description

    A jurisdiction type for filtering jurisdictions. Options include city, county, transit, special_district.

  • Name
    near
    Type
    LatLng
    Description

    A comma-separated lat/lng coordinate pair to use as a search criteria. Must be paired with `radius`.

  • Name
    radius
    Type
    integer
    Description

    A radius (in meters) to search around the corresponding lat/lng pair provided in the `near` option. Must be paired with `near`.

  • Name
    limit
    Type
    integer
    Description

    Limit the number of allocations returned. Max of 1,000.

  • Name
    sort
    Type
    string
    Description

    Sort the responses on a given value. Options include: revenue_period, net_payment, prior_collections, current_collections, future_collections, audit_collections, single_local_rate_collections. Prefix the key with a `-` to specify descending order.

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

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": {
        ...
    },
    "meta": {
        ...
    }
}