Skip to main content
POST

Authorizations

x-api-key
string
header
required

Role-scoped API key (admin, partner, merchant, auditor, readonly).

Body

application/json

A row of the jurisdictions table. Admin upsert accepts any subset beyond the required fields.

lookup_key
string
required

State code, STATE:COUNTY[:CITY], TRIBAL:NAME, or US-FEDERAL.

Example:

"NC"

jurisdiction_id
string
required
Example:

"US-NC"

jurisdiction_level
enum<string>
required
Available options:
federal,
state,
county,
city,
tribal
rounding_mode
enum<string>
required
Available options:
symmetrical_rounding,
mandatory_round_down,
mandatory_round_up,
operator_choice,
swedish_rounding,
nearest_nickel,
nearest_cent,
nearest_dime,
none
enforcement
enum<string>
required
Available options:
mandatory,
voluntary,
operator_choice,
safe_harbor,
none
status
enum<string>
required

Only enacted and ordinance govern; default_practice is the federal fallback.

Available options:
enacted,
ordinance,
default_practice,
guidance,
introduced,
passed_one_chamber,
passed_both_chambers,
awaiting_sig,
pending,
drafting,
failed,
none,
repealed,
proposed,
lead
obligation
enum<string> | null
Available options:
obligates,
permits
legislation
string | null
session_law
string | null
citation
string | null
enacted_date
string<date> | null
effective_date
string<date> | null
sunset_date
string<date> | null
time_zone
string | null
Example:

"America/New_York"

scope
string | null
tender
string | null
directions
string[] | null
tax_on_pre_rounded
boolean | null
small_total_rule
object | null
refund_policy
enum<string>
Available options:
same_rule,
exact
notice_required
boolean
accepted_transaction_types
string[] | null
tiers
object[] | null
activation_conditions
object[] | null
geoid
string | null

Census GEOID for county, city and tribal rules.

engine_supported
boolean

False for a research record that is reported but never applied.

instrument
string | null
evidence_tier
string | null
source_url
string | null
verification
enum<string> | null
Available options:
primary_source,
tracker,
admin_api
dataset_version
string | null
notes
string | null

Response

Saved.