For Agents
Read country and region-level firearm-policy and armed-violence statistics from GunPolicy.org for research, comparison, and reporting.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GunPolicy.org API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with GunPolicy.org API.
List all regions covered by GunPolicy.org including countries and sub-regional aggregates
Retrieve region-level metadata for a single region by ID
Pull indicator data for a specific measure across the dataset
GET STARTED
Use for: List all countries covered by GunPolicy.org, Get civilian firearm holdings for a specific country, Compare gun-related deaths across multiple countries, Retrieve metadata for one region by ID
Not supported: Does not handle real-time crime feeds, news content, or firearm-purchase processing — use for comparative firearm-policy and armed-violence research data only.
Jentic publishes the only available OpenAPI specification for GunPolicy.org API, keeping it validated and agent-ready. The GunPolicy.org API exposes comparative firearm-policy and armed-violence data compiled by the University of Sydney across countries and sub-regions. Six open endpoints cover region listings and details, measure-level data lookups, multi-region comparisons, a glossary of policy terms, and the catalogue of available measures. The API is unauthenticated and intended for research, journalism, and policy analysis.
Compare a measure side-by-side across multiple region IDs in one call
Read the glossary of policy and statistical terms used by indicators
Enumerate the full list of available measures in the dataset
Patterns agents use GunPolicy.org API for, with concrete tasks.
★ Cross-country firearm-policy comparison
Compile a comparison of firearm-related indicators across a chosen set of countries — for example civilian firearm holdings, firearm homicides, or licensing requirements. The compare endpoint accepts a list of region IDs and a single measure, returning aligned values suitable for tables and charts. This replaces manual data assembly from the GunPolicy site for journalism and policy briefs.
Call GET /compare/{region_ids}/{measure} with region IDs for the United States, Canada, and Australia and the civilian-firearm-holdings measure, then format the values as a table.
Country profile builder
Generate a country firearm profile by pulling region metadata and a curated set of measures for a single country ID. This is the basis for static country pages on a research site or briefing notes for advocacy organisations, refreshed when GunPolicy publishes new data.
Fetch GET /region/{region_id} for Canada and then GET /data/{measure} for three measures (firearm homicides, civilian holdings, suicide rate) and assemble a profile object.
Measure discovery for analysts
Before running comparisons, analysts need the canonical list of supported measures and the glossary terms attached to them. The /measures and /glossary endpoints power a discovery UI in a research notebook so analysts can pick valid measure identifiers without consulting the website.
Call GET /measures and GET /glossary, then surface a search-as-you-type measure picker for an analyst to pick a measure ID.
AI agent research assistant via Jentic
An AI assistant answers a researcher's natural-language question about civilian firearm holdings in a region by selecting the right measure, calling the GunPolicy.org API, and citing the source. Through Jentic the agent calls the right endpoint without scraping the site.
Search Jentic for 'compare civilian firearm holdings across countries', load /compare/{region_ids}/{measure}, and return values for three regions.
6 endpoints — jentic publishes the only available openapi specification for gunpolicy.
METHOD
PATH
DESCRIPTION
/region
List regions
/region/{region_id}
Get region details
/data/{measure}
Get data for a measure
/compare/{region_ids}/{measure}
Compare regions by measure
/measures
List available measures
/glossary
List glossary terms
/region
List regions
/region/{region_id}
Get region details
/data/{measure}
Get data for a measure
/compare/{region_ids}/{measure}
Compare regions by measure
/measures
List available measures
Three things that make agents converge on Jentic-routed access.
Credential isolation
GunPolicy.org is a public unauthenticated API, so no credential is stored. Jentic still routes requests through its execution layer for consistent error handling and rate-limit backoff.
Intent-based discovery
Agents search Jentic by intent (e.g., 'compare gun policy data across countries') and Jentic returns the matching compare or data operation with its input schema.
Time to first call
Direct integration: a few hours to map the small endpoint surface and discover valid measures. Through Jentic: 10-15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using GunPolicy.org API through Jentic.
Why is there no official OpenAPI spec for GunPolicy.org API?
GunPolicy.org does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call GunPolicy.org API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the GunPolicy.org API use?
The GunPolicy.org API does not require authentication. Endpoints accept anonymous GET requests. When called through Jentic, no credential is stored or injected for this API.
Can I compare a measure across multiple countries with the GunPolicy.org API?
Yes. GET /compare/{region_ids}/{measure} accepts a list of region IDs and a single measure name and returns aligned values per region. This is the canonical way to build cross-country comparison tables.
How do I find what measures are available in the GunPolicy.org API?
Call GET /measures for the supported measure identifiers and GET /glossary for definitions of the terms. Use the measure IDs from /measures as input to /data/{measure} and /compare.
What are the rate limits for the GunPolicy.org API?
GunPolicy.org does not document strict rate limits but the dataset is intended for research-scale use. Cache responses where possible — the underlying data updates infrequently — and back off on any 429 responses.
How do I compare gun policy data across countries with the GunPolicy.org API through Jentic?
Search Jentic for 'compare gun policy data across countries', load the GET /compare/{region_ids}/{measure} operation, then execute it with the chosen region IDs and measure. Install with pip install jentic.
/glossary
List glossary terms