GET /api/jurisdiction-lookup
Public · read-only

Put jurisdiction intelligence inside the checkout flow.

Gun-Go gives FFLs and POS teams a deterministic, source-linked on-ramp for building location-aware firearm workflows. Resolve a state, pilot slug, or coordinate pair; receive one predictable jurisdiction brief your product can render, log, or review.

Built for the handoff
Keep your POS or FFL workflow focused on the transaction. Let the lookup return the evidence trail alongside the rule brief.
One selector mode per request
Four stable rule slots in every result
Citations and review context included

01 / Request

Start with one clear input.

Choose exactly one selector mode. State accepts a two-letter code or supported state name. The slug selector is sent as jurisdiction in the query string.

Coordinates require both lat and lng, with latitude from -90 to 90 and longitude from -180 to 180.

Do not mix state or jurisdiction with coordinates. Postal-code lookup is not supported.

The current pilot resolver covers Colorado, Kansas, and Texas aliases and locations. Treat an unsupported selector as a lookup miss, not as a legal conclusion.

State alias
curl "/api/jurisdiction-lookup?state=TX"
Jurisdiction slug
curl "/api/jurisdiction-lookup?jurisdiction=texas"
Coordinate pair
curl "/api/jurisdiction-lookup?lat=31.9686&lng=-99.9018"

02 / Response

Four slots. No guessing.

The selected jurisdiction always returns the same four categories: carry, magazine, transport, and duty-to-inform. A slot can be present with rule: null when no current rule record is available.

Useful for integrators

  • • Store the rule id with the transaction or cart review.
  • • Render the label and summary in your own workflow.
  • • Keep sourceUrl available for a human verification step.
Response · Texas
{
  "id": "texas",
  "name": "Texas",
  "abbreviation": "TX",
  "rules": [
    {
      "category": "carry",
      "rule": {
        "id": "catalog-texas-carry",
        "category": "carry",
        "label": "Concealed carry",
        "summary": "Texas generally permits a person who may lawfully possess a firearm to carry a handgun without a license, subject to location-specific restrictions and the limits in Chapter 46. License holders remain subject to additional notice and location rules.",
        "effectiveFrom": "2026-08-30T00:00:00.000Z",
        "updatedAt": "2026-08-30T00:00:00.000Z",
        "reviewStatus": "reviewed",
        "sourceLabel": "Texas Penal Code § 46.02 — Unlawful Carrying Weapons",
        "sourceUrl": "https://statutes.capitol.texas.gov/Docs/PE/htm/PE.46.htm#46.02",
        "revisions": [
          {
            "changedAt": "2026-08-30T00:00:00.000Z",
            "changeSummary": "Reviewed the current official Chapter 46 carry provisions."
          }
        ],
        "history": [
          {
            "timestamp": "2026-08-30T00:00:00.000Z",
            "kind": "reviewed",
            "summary": "Current review status: Reviewed."
          },
          {
            "timestamp": "2026-08-30T00:00:00.000Z",
            "kind": "revised",
            "summary": "Reviewed the current official Chapter 46 carry provisions."
          }
        ]
      }
    },
    {
      "category": "magazine",
      "rule": null
    },
    {
      "category": "transport",
      "rule": {
        "id": "catalog-texas-transport",
        "category": "transport",
        "label": "Transport in a private vehicle",
        "summary": "Texas Penal Code § 46.02 addresses carrying a handgun inside of or directly en route to a motor vehicle or watercraft owned by or under a person’s control, while prohibited-person and location restrictions remain applicable.",
        "effectiveFrom": "2026-08-30T00:00:00.000Z",
        "updatedAt": "2026-08-30T00:00:00.000Z",
        "reviewStatus": "reviewed",
        "sourceLabel": "Texas Penal Code Chapter 46 — Weapons",
        "sourceUrl": "https://statutes.capitol.texas.gov/Docs/PE/htm/PE.46.htm#46.02",
        "revisions": [],
        "history": [
          {
            "timestamp": "2026-08-30T00:00:00.000Z",
            "kind": "reviewed",
            "summary": "Current review status: Reviewed."
          }
        ]
      }
    },
    {
      "category": "duty-to-inform",
      "rule": null
    }
  ]
}

03 / Evidence

The brief comes with its paper trail.

A populated rule includes the citation pair, effective and update timestamps, plus change and review context so your team can decide when to surface a re-check. The reviewStatus value describes the returned review state; effectiveFrom and updatedAt anchor it in time.

Citation pair
sourceLabel names the authority; sourceUrl points your reviewer to the cited source.
Revision context
revisions[] lists changedAt and changeSummary for recorded rule changes.
Review history
history[] exposes timestamp, kind, and summary for review and revision events.

Informational, not legal advice.

Timestamps and citations describe the returned dataset; they are not a guarantee of legal advice, completeness, or freshness beyond those timestamps. Verify the current official source and consult qualified counsel for a decision that matters.

Read the evidence standard