{"openapi":"3.1.0","info":{"title":"MIME API","version":"1.0.0","description":"A fast, fully-local MIME and file-type toolkit: look up the MIME type, charset and category for a filename or extension, list every file extension registered for a MIME type, and detect a file's real type from its leading magic bytes (over 40 signatures, including RIFF container disambiguation for WEBP, WAV and AVI), accepting hex or base64 input. Every endpoint accepts input via the query string or the request body. Pure server-side compute, no third-party upstream, so responses are instant and always available. Ideal for upload validation, security (verify a file's real type against its claimed extension), CDNs and content pipelines.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mime-api","description":"oanor gateway"}],"tags":[{"name":"MIME"}],"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/detect":{"get":{"operationId":"get_v1_detect","tags":["MIME"],"summary":"Detect type from magic bytes","description":"","parameters":[{"name":"hex","in":"query","required":false,"description":"Leading bytes as hex","schema":{"type":"string"},"example":"89504e470d0a1a0a"},{"name":"base64","in":"query","required":false,"description":"Leading bytes as base64","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mime":"image/png","name":"PNG image","category":"image","detected":true,"extension":"png","signature":"89504e47"},"meta":{"timestamp":"2026-05-30T10:10:55.631Z","request_id":"a6db6fec-6d5d-4a48-b730-beba9d09ca13"},"status":"ok","message":"OK","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/extensions":{"get":{"operationId":"get_v1_extensions","tags":["MIME"],"summary":"MIME to extensions","description":"","parameters":[{"name":"mime","in":"query","required":true,"description":"MIME type","schema":{"type":"string"},"example":"image/png"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mime":"image/png","primary":"png","category":"image","extensions":["png"]},"meta":{"timestamp":"2026-05-30T10:10:55.707Z","request_id":"b6a3ba6f-4cd3-45e6-9d5d-99aa845d1fd9"},"status":"ok","message":"OK","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/lookup":{"get":{"operationId":"get_v1_lookup","tags":["MIME"],"summary":"Filename/extension to MIME","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Filename or extension","schema":{"type":"string"},"example":"report.pdf"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mime":"application/pdf","input":"report.pdf","category":"document","extension":"pdf","content_type":"application/pdf"},"meta":{"timestamp":"2026-05-30T10:10:55.782Z","request_id":"1712e8e1-fcc0-4c3b-9cfe-f22c80ec7c06"},"status":"ok","message":"OK","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":13000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":500,"monthly_call_quota":175000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":950000,"rps_limit":40,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4100,"monthly_call_quota":5000000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mime-api"}