{"openapi":"3.1.0","info":{"title":"CaliberAPI pistol optic compatibility data","version":"2026-11-14","description":"Static, read-only JSON files with source-cited pistol optic footprint compatibility. Direct fits and adapter-plate fits are distinct; never treat 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. Retail offers and UPCs are not included. Commercial licensing on request: hello@caliberapi.com.","license":{"name":"Creative Commons Attribution-NonCommercial 4.0 International","identifier":"CC-BY-NC-4.0"},"contact":{"email":"hello@caliberapi.com","url":"https://caliberapi.com/data/"}},"servers":[{"url":"https://caliberapi.com"}],"externalDocs":{"url":"https://caliberapi.com/data/"},"paths":{"/data/v1/index.json":{"get":{"operationId":"getIndex","summary":"Dataset index: counts and every pistol, optic and footprint with its URLs","responses":{"200":{"description":"Dataset index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Index"}}}}}}},"/data/v1/fits.json":{"get":{"operationId":"listFits","summary":"Every recorded pistol and optic pair in one file","description":"Filter fits[] by pistol_slug and optic_slug to answer a pair question. A pair missing from fits.json means the dataset has no cited fit for it, not that the optic does not fit.","responses":{"200":{"description":"All recorded fits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fits"}}}}}}},"/data/v1/pistols/{manufacturer}/{model}.json":{"get":{"operationId":"getPistol","summary":"One pistol with its direct and adapter fit optics","parameters":[{"name":"manufacturer","in":"path","required":true,"schema":{"type":"string"},"example":"anderson-manufacturing"},{"name":"model","in":"path","required":true,"schema":{"type":"string"},"example":"kiger-9c-pro"}],"responses":{"200":{"description":"Pistol record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pistol"}}}},"404":{"description":"No such pistol page"}}}},"/data/v1/optics/{manufacturer}/{model}.json":{"get":{"operationId":"getOptic","summary":"One optic (or optic family) with the pistols it fits","parameters":[{"name":"manufacturer","in":"path","required":true,"schema":{"type":"string"},"example":"aimpoint"},{"name":"model","in":"path","required":true,"schema":{"type":"string"},"example":"acro-c-2"}],"responses":{"200":{"description":"Optic record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Optic"}}}},"404":{"description":"No such optic page"}}}},"/data/v1/footprints/{slug}.json":{"get":{"operationId":"getFootprint","summary":"One footprint standard or factory plate system","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"acro"}],"responses":{"200":{"description":"Footprint record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Footprint"}}}},"404":{"description":"No such footprint page"}}}}},"components":{"schemas":{"License":{"type":"object","required":["id","name","url"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"attribution":{"type":"string"},"commercial":{"type":"string"}}},"ViaPlate":{"type":"object","required":["manufacturer","model","mount_footprint","presents_footprint","sources"],"properties":{"manufacturer":{"type":"string"},"model":{"type":"string"},"mount_footprint":{"type":["string","null"]},"presents_footprint":{"type":["string","null"]},"sources":{"type":"array","items":{"type":"string"}}}},"Provenance":{"oneOf":[{"type":"object","required":["fit","footprint"],"properties":{"fit":{"const":"direct"},"footprint":{"type":["string","null"]}}},{"type":"object","required":["fit","via"],"properties":{"fit":{"const":"adapter"},"via":{"type":"array","items":{"$ref":"#/components/schemas/ViaPlate"}}}}]},"SpecFact":{"type":"object","required":["value","display","source_url","quote"],"properties":{"value":{},"unit":{"type":["string","null"]},"norm":{"type":["number","null"]},"display":{"type":"string"},"source_url":{"type":"string"},"source_kind":{"enum":["manufacturer","retailer","press"]},"quote":{"type":"string"}}},"Specs":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/SpecFact"}},"Fit":{"type":"object","required":["pistol_slug","pistol","optic_slug","optic","fit","via","footprint","source_urls"],"properties":{"pistol_slug":{"type":"string"},"pistol":{"type":"string"},"optic_slug":{"type":"string"},"optic":{"type":"string"},"fit":{"enum":["direct","adapter"]},"via":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ViaPlate"}},{"type":"null"}]},"footprint":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}}}},"Fits":{"type":"object","required":["version","schema_version","license","count","fits"],"properties":{"version":{"type":"string"},"schema_version":{"type":"integer"},"license":{"$ref":"#/components/schemas/License"},"note":{"type":"string"},"count":{"type":"integer"},"fits":{"type":"array","items":{"$ref":"#/components/schemas/Fit"}}}},"IndexEntry":{"type":"object","required":["slug","json_url","html_url"],"properties":{"slug":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"name":{"type":"string"},"json_url":{"type":"string"},"html_url":{"type":"string"}}},"Index":{"type":"object","required":["version","schema_version","license","counts","pistols","optics","footprints"],"properties":{"version":{"type":"string"},"schema_version":{"type":"integer"},"license":{"$ref":"#/components/schemas/License"},"description":{"type":"string"},"docs_url":{"type":"string"},"openapi_url":{"type":"string"},"fits_url":{"type":"string"},"note":{"type":"string"},"counts":{"type":"object","additionalProperties":{"type":"integer"}},"pistols":{"type":"array","items":{"$ref":"#/components/schemas/IndexEntry"}},"optics":{"type":"array","items":{"$ref":"#/components/schemas/IndexEntry"}},"footprints":{"type":"array","items":{"$ref":"#/components/schemas/IndexEntry"}},"redirects":{"description":"Retired SKU page paths and the family page that replaced each","type":"array","items":{"type":"object","required":["from","to"],"properties":{"from":{"type":"string"},"to":{"type":"string"}}}}}},"OpticFitRow":{"type":"object","required":["manufacturer","model","slug","footprint","provenance","source_urls"],"properties":{"slug":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"sku":{"type":["string","null"]},"variant_count":{"type":"integer"},"footprint":{"type":["string","null"]},"provenance":{"$ref":"#/components/schemas/Provenance"},"source_urls":{"type":"array","items":{"type":"string"}}}},"Pistol":{"type":"object","required":["manufacturer","model","slug","accepted_footprints","direct_fit_optics","adapter_fit_optics","source_urls","html_url","version","license"],"properties":{"slug":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"optic_ready":{"type":"boolean"},"accepted_footprints":{"type":"array","items":{"type":"string"}},"source_urls":{"type":"array","items":{"type":"string"}},"compatible_optic_count":{"type":"integer"},"direct_fit_optics":{"type":"array","items":{"$ref":"#/components/schemas/OpticFitRow"}},"adapter_fit_optics":{"type":"array","items":{"$ref":"#/components/schemas/OpticFitRow"}},"specs":{"$ref":"#/components/schemas/Specs"},"siblings":{"type":"array","items":{"type":"object"}},"html_url":{"type":"string"},"version":{"type":"string"},"schema_version":{"type":"integer"},"license":{"$ref":"#/components/schemas/License"}}},"Optic":{"type":"object","required":["manufacturer","model","slug","footprint","fits_pistols","source_urls","html_url","version","license"],"properties":{"slug":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"sku":{"type":["string","null"]},"footprint":{"type":["string","null"]},"emitter_type":{"enum":["open","enclosed","prism",null]},"reticle":{"type":["string","null"]},"window_width_mm":{"type":["number","null"]},"window_height_mm":{"type":["number","null"]},"weight_oz":{"type":["number","null"]},"battery_type":{"type":["string","null"]},"verified":{"type":"boolean"},"source_urls":{"type":"array","items":{"type":"string"}},"family":{"oneOf":[{"type":"object"},{"type":"null"}]},"variants":{"type":"array","items":{"type":"object"}},"fits_pistols":{"type":"array","items":{"type":"object","required":["slug","fit_type","provenance","source_urls"],"properties":{"slug":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"fit_type":{"enum":["direct","adapter"]},"provenance":{"$ref":"#/components/schemas/Provenance"},"source_urls":{"type":"array","items":{"type":"string"}}}}},"specs":{"$ref":"#/components/schemas/Specs"},"peers":{"type":"array","items":{"type":"object"}},"html_url":{"type":"string"},"version":{"type":"string"},"schema_version":{"type":"integer"},"license":{"$ref":"#/components/schemas/License"}}},"Footprint":{"type":"object","required":["name","slug","kind","source_urls","optics","pistols_direct","html_url","version","license"],"properties":{"name":{"type":"string"},"family":{"type":"string"},"slug":{"type":"string"},"short_name":{"type":"string"},"kind":{"enum":["footprint","plate_system"]},"screw_count":{"type":["integer","null"]},"recoil_lug_count":{"type":["integer","null"]},"mounting_type":{"type":"string"},"description":{"type":["string","null"]},"source_urls":{"type":"array","items":{"type":"string"}},"optic_count":{"type":"integer"},"pistol_count_direct":{"type":"integer"},"pistol_count_via_plate":{"type":"integer"},"optics":{"type":"array","items":{"type":"object"}},"pistols_direct":{"type":"array","items":{"type":"object"}},"mount_paths":{"type":"array","items":{"type":"object"}},"plate_paths":{"type":"array","items":{"type":"object"}},"html_url":{"type":"string"},"version":{"type":"string"},"schema_version":{"type":"integer"},"license":{"$ref":"#/components/schemas/License"}}}}}}