{"openapi":"3.1.0","info":{"title":"HTTP Reference API","version":"1.0.0","description":"A clean, programmatic reference for HTTP semantics, built on the official IANA registries. Look up any status code with its reason phrase and class (404 → Not Found, Client Error; 503 → Service Unavailable, Server Error), list a whole class (4xx, 5xx…); look up any method with its safe/idempotent flags (GET → safe + idempotent, POST → neither, DELETE → idempotent); or look up / search the 255 registered HTTP header fields (Content-Type, Authorization, …) with their registration status. Ideal for API tooling, HTTP clients, documentation, linters, learning resources and error pages.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/http-api","description":"oanor gateway"}],"tags":[{"name":"HTTP"},{"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/header":{"get":{"operationId":"get_v1_header","tags":["HTTP"],"summary":"A header field, search, or all","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Header field, e.g. Content-Type","schema":{"type":"string"},"example":"Content-Type"},{"name":"q","in":"query","required":false,"description":"Substring search of field names","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results when listing (1-255)","schema":{"type":"string"},"example":"50"},{"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":{"name":"Content-Type","status":"permanent","reference":"[RFC 9110, Section 8.3: HTTP Semantics]"},"meta":{"timestamp":"2026-05-31T05:48:02.245Z","request_id":"6b848203-dd1c-4e7a-874c-58ec00eef7be"},"status":"ok","message":"Header field 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/method":{"get":{"operationId":"get_v1_method","tags":["HTTP"],"summary":"An HTTP method (safe/idempotent), or all","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Method, e.g. GET (omit to list all)","schema":{"type":"string"},"example":"GET"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"safe":true,"method":"GET","reference":"[RFC9110, Section 9.3.1]","idempotent":true},"meta":{"timestamp":"2026-05-31T05:48:02.315Z","request_id":"1000c756-0a59-4095-8d52-cd9240d258a5"},"status":"ok","message":"Method 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/status":{"get":{"operationId":"get_v1_status","tags":["HTTP"],"summary":"A status code, a class, or all","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"Status code, e.g. 404","schema":{"type":"string"},"example":"404"},{"name":"class","in":"query","required":false,"description":"Class, e.g. 4xx or \"Client Error\" (omit to list all)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":404,"message":"Not Found","category":"Client Error","reference":"[RFC9110, Section 15.5.5]"},"meta":{"timestamp":"2026-05-31T05:48:02.395Z","request_id":"d9ab6da1-443e-4a5f-8ec4-f1506eb75934"},"status":"ok","message":"Status code 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & status-class breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Registered HTTP semantics from IANA. Methods carry safe/idempotent flags; status codes carry their class.","source":"IANA HTTP registries (status codes, methods, field names)","methods":41,"endpoints":["/v1/status","/v1/method","/v1/header","/v1/meta"],"status_codes":63,"header_fields":255,"status_by_class":[{"class":"Informational","count":5},{"class":"Success","count":10},{"class":"Redirection","count":8},{"class":"Client Error","count":29},{"class":"Server Error","count":11}]},"meta":{"timestamp":"2026-05-31T05:48:02.465Z","request_id":"9823c09e-6b09-4845-b8b3-0d5f1f980215"},"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":20000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":200,"monthly_call_quota":150000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":600,"monthly_call_quota":700000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":1800,"monthly_call_quota":3500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/http-api"}