Open data
The pistol optic compatibility dataset
Machine-readable, source-cited compatibility data across pistols, optics, and footprint standards. Built for developers, retailers, and researchers who need structured firearms data they can trust.
Every compatibility claim is independently sourced and individually citable.
What is in the dataset
Each record links a pistol to an optic with fit type (direct or adapter), the footprint standard involved, and at least one source URL.
Manufacturer, model, optic-ready status, accepted footprint standards, and full compatibility lists.
Manufacturer, model, footprint, emitter type, reticle, weight, battery type, and the pistols each optic fits.
Standardized footprint names, families, mounting types, and the optics that use each standard, plus 31 plate systems and the footprints their plates present.
JSON endpoints
The full dataset is published as static, read-only JSON files under /data/v1/. No key is needed and any
origin may fetch them. Every file carries version, schema_version and license.
Retail offers and UPCs are left out: the files hold fit and spec facts only.
| URL | What it holds |
|---|---|
| /data/v1/index.json | Version, license, counts, and every pistol, optic and footprint with its JSON and HTML URL. |
| /data/v1/fits.json | Every recorded pistol and optic pair in one file: fit type, plate chain, footprint, sources. |
| /data/v1/pistols/sig-sauer/p320-m17.json | One pistol: accepted footprints, direct and adapter fit optics, cited specs. |
| /data/v1/optics/aimpoint/acro-c-2.json | One optic or optic family: footprint, specs, and every pistol it fits. |
| /data/v1/footprints/rmr.json | One footprint standard or factory plate system, with its optics and pistols. |
| /data/v1/openapi.json | OpenAPI 3.1 description of these files. |
Record URLs follow the page URLs: /pistols/sig-sauer/p320-m17/ is /data/v1/pistols/sig-sauer/p320-m17.json.
Some optic SKUs share one family page; index.json lists those retired SKU paths under redirects.
curl -s https://caliberapi.com/data/v1/index.json | jq '.counts'
curl -s https://caliberapi.com/data/v1/pistols/sig-sauer/p320-m17.json | jq '.accepted_footprints' Does the Aimpoint ACRO C-2 fit the Sig Sauer P320 M17?
Fetch fits.json once and filter by the two slugs from index.json:
curl -s https://caliberapi.com/data/v1/fits.json \
| jq '.fits[] | select(.pistol_slug == "sig-sauer/p320-m17" and .optic_slug == "aimpoint/acro-c-2")' {
"pistol_slug": "sig-sauer/p320-m17",
"pistol": "Sig Sauer P320 M17",
"optic_slug": "aimpoint/acro-c-2",
"optic": "Aimpoint ACRO C-2",
"fit": "adapter",
"via": [
{
"manufacturer": "C&H Precision",
"model": "P320 R1P/DPP-cut plate (ACRO)",
"mount_footprint": "SIG P320 C&H plate system",
"presents_footprint": "ACRO",
"sources": [
"https://chpws.com/product/sig-p320-x-series-legion-w-romeo1pro-dpp-cut-to-aimpoint-acro-steel/"
]
}
],
"footprint": "ACRO",
"source_urls": [
"https://www.sigsauer.com/p320-m17.html",
"https://www.sigsauer.com/blog/sig-sauer-announces-p320-pro-cut-slide-assembly-available-exclusively-at-sig-sauer-web-store",
"https://chpws.com/product/sig-p320-legion-x-five-m17-m18-w-r1p-dpp-cut-to-rmr-sro-holosun-adapter-plate-w-10-8-rear-sight/",
"https://www.aimpoint.com/products/acro-c-2-35-moa-red-dot-reflex-sight-with-integrated-acro-interface/"
]
} fit: "direct"means the optic mounts on the slide cut.fit: "adapter"means it needs the plate named invia; never report an adapter fit as direct.- A pair missing from fits.json means the dataset has no cited fit for it, not that the optic does not fit.
- Verify with the manufacturer before mounting.
How to cite
Cite the dataset version and link the page for the pistol or optic you mention.
CaliberAPI (2026). Pistol Optic Compatibility Dataset (version 2026-11-14) [Data set]. https://caliberapi.com/data/. Licensed under CC BY-NC 4.0. @misc{caliberapi_20261114,
author = {{CaliberAPI}},
title = {Pistol Optic Compatibility Dataset},
year = {2026},
version = {2026-11-14},
howpublished = {\url{https://caliberapi.com/data/}},
note = {Licensed under CC BY-NC 4.0}
} Download sample data
Sample files are free to download and evaluate. They contain up to 50 representative records.
Data shape
A compatibility record looks like this:
{
"pistol_manufacturer": "Sig Sauer",
"pistol_model": "P320 M17",
"optic_manufacturer": "Bushnell",
"optic_model": "RXE-MR1",
"footprint": "DPP",
"fit_type": "direct",
"source_urls": [
"https://www.bushnell.com/products/rxe-mr1-enclosed-dot-sight"
]
} Fields shown are a representative subset. Full records include additional provenance and the adapter-plate chain for adapter fits.
Methodology and provenance
Every compatibility claim in this dataset is individually sourced. Each record carries one or more source URLs: manufacturer specification pages, product listings, or official compatibility charts. We do not assert a fit unless at least one verifiable source supports it.
Footprint names are normalized to a controlled vocabulary (for example, "RMR" always refers to the Trijicon RMR pattern, not a brand-specific synonym). This makes cross-manufacturer queries reliable.
Records are tagged with an ingestion method: hand-curated foundation data, or pipeline-extracted data that was subsequently verified. Where a record has been corrected after initial ingestion, it is tagged accordingly.
This sourcing approach is the core of what makes the data usable for developers and retailers. You can follow the citation trail for any claim rather than taking our word for it.
Access and licensing
The dataset is licensed under Creative Commons Attribution-NonCommercial 4.0 (CC BY-NC 4.0). You may share and adapt it for non-commercial use with attribution to CaliberAPI and the dataset version (2026-11-14). Commercial licensing is available on request at hello@caliberapi.com. We are open to working with developers, retailers, and researchers who need reliable structured firearms data.
Want the answers on your own site instead of the raw data? The free fit checker widget embeds on any site, stores included, with an attribution link.