{"openapi":"3.1.0","info":{"title":"Formula 1 API","version":"1.0.0","description":"Formula 1 reference data as an API, built on the Ergast / Jolpica F1 dataset — every driver, constructor and circuit in F1 history plus every season since 1950. Look up a driver by id or name (e.g. hamilton → Lewis Hamilton, code HAM, #44, British), a constructor/team (ferrari → Ferrari), or a circuit with its coordinates and country (monza → Autodromo Nazionale di Monza, Italy); or search across all three (e.g. \"verstappen\" → Jos & Max Verstappen). 879 drivers, 214 constructors, 78 circuits. Ideal for motorsport apps, fantasy F1, sports trivia and data dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/f1-api","description":"oanor gateway"}],"tags":[{"name":"Formula 1"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/circuit":{"get":{"operationId":"get_v1_circuit","tags":["Formula 1"],"summary":"A circuit by id or name (with coordinates)","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Circuit id, e.g. monza","schema":{"type":"string"},"example":"monza"},{"name":"name","in":"query","required":false,"description":"Circuit name (fuzzy)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"monza","name":"Autodromo Nazionale di Monza","country":"Italy","latitude":45.6156,"locality":"Monza","wiki_url":"https://en.wikipedia.org/wiki/Monza_Circuit","longitude":9.28111},"meta":{"timestamp":"2026-05-31T05:48:03.616Z","request_id":"22f9557e-3d6b-417b-9263-eeb1c0ef6a3b"},"status":"ok","message":"Circuit retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/constructor":{"get":{"operationId":"get_v1_constructor","tags":["Formula 1"],"summary":"A constructor (team) by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Constructor id, e.g. ferrari","schema":{"type":"string"},"example":"ferrari"},{"name":"name","in":"query","required":false,"description":"Constructor name (fuzzy)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"ferrari","name":"Ferrari","wiki_url":"https://en.wikipedia.org/wiki/Scuderia_Ferrari","nationality":"Italian"},"meta":{"timestamp":"2026-05-31T05:48:03.686Z","request_id":"a4b25703-f1cd-4031-9291-36b4317c445f"},"status":"ok","message":"Constructor retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/driver":{"get":{"operationId":"get_v1_driver","tags":["Formula 1"],"summary":"A driver by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Driver id, e.g. hamilton","schema":{"type":"string"},"example":"hamilton"},{"name":"name","in":"query","required":false,"description":"Driver name (fuzzy), e.g. Senna","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"hamilton","code":"HAM","name":"Lewis Hamilton","number":"44","wiki_url":"http://en.wikipedia.org/wiki/Lewis_Hamilton","given_name":"Lewis","family_name":"Hamilton","nationality":"British","date_of_birth":"1985-01-07"},"meta":{"timestamp":"2026-05-31T05:48:03.757Z","request_id":"fdd328a7-6d51-420b-bee6-cbe8644d9362"},"status":"ok","message":"Driver retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Formula 1"],"summary":"Search across drivers, constructors and circuits","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term, e.g. senna","schema":{"type":"string"},"example":"senna"},{"name":"type","in":"query","required":false,"description":"driver | constructor | circuit","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"limit":20,"query":"senna","total":2,"offset":0,"results":[{"id":"senna","name":"Ayrton Senna","type":"driver","wiki_url":"http://en.wikipedia.org/wiki/Ayrton_Senna","given_name":"Ayrton","family_name":"Senna","nationality":"Brazilian","date_of_birth":"1960-03-21"},{"id":"bruno_senna","code":"SEN","name":"Bruno Senna","type":"driver","wiki_url":"http://en.wikipedia.org/wiki/Bruno_Senna","given_name":"Bruno","family_name":"Senna","nationality":"Brazilian","date_of_birth":"1983-10-15"}]},"meta":{"timestamp":"2026-05-31T05:48:03.808Z","request_id":"caee7513-f523-4e6b-b2d0-f8051fd8cd6f"},"status":"ok","message":"Results listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & season range","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Reference data (drivers, teams, circuits, seasons). Historical, sourced from the Ergast database.","source":"Ergast / Jolpica F1 API","drivers":879,"seasons":{"last":2026,"count":77,"first":1950},"circuits":78,"endpoints":["/v1/driver","/v1/constructor","/v1/circuit","/v1/search","/v1/meta"],"constructors":214},"meta":{"timestamp":"2026-05-31T05:48:03.855Z","request_id":"0ecc79e4-6404-451d-942a-789d5b8290bf"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":50000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3500,"monthly_call_quota":1000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/f1-api"}