{"openapi":"3.1.0","info":{"title":"URI Schemes API","version":"1.0.0","description":"The IANA Uniform Resource Identifier (URI) Schemes registry as an API — all 413 registered schemes (http, https, mailto, tel, ftp, ssh, magnet, bitcoin, geo, did, …). Look up any scheme to get its description, registration status (Permanent, Provisional or Historical) and defining reference; search by name or description; or list all schemes filtered by status. Ideal for URL parsers and validators, link handlers, deep-linking, security allow-lists and developer tooling that needs to recognise or vet URI schemes.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/urischemes-api","description":"oanor gateway"}],"tags":[{"name":"URI Schemes"},{"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/list":{"get":{"operationId":"get_v1_list","tags":["URI Schemes"],"summary":"All schemes (optionally by status)","description":"","parameters":[{"name":"status","in":"query","required":false,"description":"Filter by status","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-413, default 50)","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":{"count":50,"limit":50,"total":413,"offset":0,"results":[{"scheme":"aaa","status":"Permanent","reference":"[RFC6733]","description":"Diameter Protocol","well_known_support":"-"},{"scheme":"aaas","status":"Permanent","reference":"[RFC6733]","description":"Diameter Protocol with Secure Transport","well_known_support":"-"},{"scheme":"about","status":"Permanent","reference":"[RFC6694]","well_known_support":"-"},{"scheme":"acap","status":"Permanent","reference":"[RFC2244]","description":"application configuration access protocol","well_known_support":"-"},{"scheme":"acct","status":"Permanent","reference":"[RFC7565]","well_known_support":"-"},{"scheme":"acd","status":"Provisional","template":"prov/acd","reference":"[Michael_Hedenus]","well_known_support":"-"},{"scheme":"acr","status":"Provisional","template":"prov/acr","reference":"[OMA-OMNA]","well_known_support":"-"},{"scheme":"adiumxtra","status":"Provisional","template":"prov/adiumxtra","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"adt","status":"Provisional","template":"prov/adt","reference":"[SAP_SE]","well_known_support":"-"},{"scheme":"afp","status":"Provisional","template":"prov/afp","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"afs","status":"Provisional","reference":"[RFC1738]","description":"Andrew File System global file names","well_known_support":"-"},{"scheme":"agtp","status":"Provisional","template":"prov/agtp","reference":"[Chris_Hood]","well_known_support":"-"},{"scheme":"aim","status":"Provisional","template":"prov/aim","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"amss","status":"Provisional","template":"prov/amss","reference":"[RadioDNS_Project]","well_known_support":"-"},{"scheme":"android","status":"Provisional","template":"prov/android","reference":"[Adam_Barth][https://developer.android.com/guide/topics/manifest/manifest-intro]","well_known_support":"-"},{"scheme":"appdata","status":"Provisional","template":"prov/appdata","reference":"[urischemeowners_at_microsoft.com]","well_known_support":"-"},{"scheme":"apt","status":"Provisional","template":"prov/apt","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"ar","status":"Provisional","template":"prov/ar","reference":"[Arweave_Team]","well_known_support":"-"},{"scheme":"ari","status":"Provisional","template":"prov/ari","reference":"[draft-ietf-dtn-ari-04]","well_known_support":"-"},{"scheme":"ark","status":"Provisional","template":"prov/ark","reference":"[ARK_agency][https://n2t.net/ark:/21206/10015]","well_known_support":"-"},{"scheme":"at","status":"Provisional","template":"prov/at","reference":"[Bluesky_PBLLC][Paul_Frazee]","description":"at (see [reviewer notes])","well_known_support":"-"},{"scheme":"attachment","status":"Provisional","template":"prov/attachment","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"aw","status":"Provisional","template":"prov/aw","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"barion","status":"Provisional","template":"prov/barion","reference":"[Bíró_Tamás]","well_known_support":"-"},{"scheme":"bb","status":"Historical","template":"historic/bb","reference":"[IESG]","well_known_support":"-"},{"scheme":"beshare","status":"Provisional","template":"prov/beshare","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"bitcoin","status":"Provisional","template":"prov/bitcoin","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"bitcoincash","status":"Provisional","template":"prov/bitcoincash","reference":"[Corentin_Mercier]","well_known_support":"-"},{"scheme":"bl","status":"Provisional","template":"prov/bl","reference":"[Daniel_Cowling]","description":"bluetooth (shortened)","well_known_support":"-"},{"scheme":"blob","status":"Provisional","template":"prov/blob","reference":"[W3C_WebApps_Working_Group][Chris_Rebert]","well_known_support":"-"},{"scheme":"bluetooth","status":"Provisional","template":"prov/bluetooth","reference":"[Daniel_Cowling]","well_known_support":"-"},{"scheme":"bolo","status":"Provisional","template":"prov/bolo","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"brid","status":"Provisional","template":"prov/brid","reference":"[Jürgen_Grupp][Michael_Ranft][Sophie_Schenkel]","well_known_support":"-"},{"scheme":"browserext","status":"Provisional","template":"prov/browserext","reference":"[Mike_Pietraszak]","well_known_support":"-"},{"scheme":"cabal","status":"Provisional","template":"prov/cabal","reference":"[Frédéric_Wang][Cabal_Club]","well_known_support":"-"},{"scheme":"calculator","status":"Provisional","template":"prov/calculator","reference":"[urischemeowners_at_microsoft.com]","well_known_support":"-"},{"scheme":"callto","status":"Provisional","template":"prov/callto","reference":"[Alexey_Melnikov]","well_known_support":"-"},{"scheme":"cap","status":"Permanent","reference":"[RFC4324]","description":"Calendar Access Protocol","well_known_support":"-"},{"scheme":"caip","status":"Provisional","template":"prov/caip","reference":"[Patrick_Collins]","well_known_support":"-"},{"scheme":"cast","status":"Provisional","template":"prov/cast","reference":"[Adam_Barth][https://developers.google.com/cast/docs/registration]","well_known_support":"-"},{"scheme":"casts","status":"Provisional","template":"prov/casts","reference":"[Adam_Barth][https://developers.google.com/cast/docs/registration]","well_known_support":"-"},{"scheme":"chrome","status":"Provisional","template":"prov/chrome","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"chrome-extension","status":"Provisional","template":"prov/chrome-extension","reference":"[Dave_Thaler]","well_known_support":"-"},{"scheme":"cid","status":"Permanent","reference":"[RFC2392]","description":"content identifier","well_known_support":"-"},{"scheme":"coap","status":"Permanent","reference":"[RFC7252]","well_known_support":"[RFC7252]"},{"scheme":"coap+tcp","status":"Permanent","reference":"[RFC8323]","description":"coap+tcp (see [reviewer notes])","well_known_support":"[RFC8323]"},{"scheme":"coap+ws","status":"Permanent","reference":"[RFC8323]","description":"coap+ws (see [reviewer notes])","well_known_support":"[RFC8323]"},{"scheme":"coaps","status":"Permanent","reference":"[RFC7252]","well_known_support":"[RFC7252]"},{"scheme":"coaps+tcp","status":"Permanent","reference":"[RFC8323]","description":"coaps+tcp (see [reviewer notes])","well_known_support":"[RFC8323]"},{"scheme":"coaps+ws","status":"Permanent","reference":"[RFC8323]","description":"coaps+ws (see [reviewer notes])","well_known_support":"[RFC8323]"}]},"meta":{"timestamp":"2026-05-31T05:48:01.923Z","request_id":"d2a8ac73-fa39-4530-849d-3aeb54f5c8e6"},"status":"ok","message":"Schemes 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/scheme":{"get":{"operationId":"get_v1_scheme","tags":["URI Schemes"],"summary":"A single URI scheme","description":"","parameters":[{"name":"scheme","in":"query","required":true,"description":"Scheme name, e.g. mailto (a trailing \":\" is accepted)","schema":{"type":"string"},"example":"mailto"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"scheme":"mailto","status":"Permanent","reference":"[RFC6068]","description":"Electronic mail address","well_known_support":"-"},"meta":{"timestamp":"2026-05-31T05:48:02.000Z","request_id":"0ae5e821-4d9b-444f-9232-570eefe0fba4"},"status":"ok","message":"Scheme 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":["URI Schemes"],"summary":"Search schemes by name or description","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Keyword, e.g. mail","schema":{"type":"string"},"example":"mail"},{"name":"status","in":"query","required":false,"description":"Permanent | Provisional | Historical","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":4,"limit":20,"query":"mail","total":4,"offset":0,"results":[{"scheme":"mailserver","status":"Historical","reference":"[RFC6196]","description":"Access to data available from mail servers","well_known_support":"-"},{"scheme":"mailto","status":"Permanent","reference":"[RFC6068]","description":"Electronic mail address","well_known_support":"-"},{"scheme":"ms-settings-emailandaccounts","status":"Provisional","template":"prov/ms-settings-emailandaccounts","reference":"[urischemeowners_at_microsoft.com]","well_known_support":"-"},{"scheme":"mupdate","status":"Permanent","reference":"[RFC3656]","description":"Mailbox Update (MUPDATE) Protocol","well_known_support":"-"}]},"meta":{"timestamp":"2026-05-31T05:48:02.074Z","request_id":"40b4567d-c6f0-458c-889c-40d3b7d4ed85"},"status":"ok","message":"Schemes 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 & status breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Permanent = standardised; Provisional = registered but not standardised; Historical = deprecated.","total":413,"fields":["scheme","description","status","template","well_known_support","reference"],"source":"IANA Uniform Resource Identifier (URI) Schemes registry","by_status":[{"count":99,"status":"Permanent"},{"count":296,"status":"Provisional"},{"count":18,"status":"Historical"}]},"meta":{"timestamp":"2026-05-31T05:48:02.147Z","request_id":"e7c364a3-14d9-4a12-9f2c-68882055a55c"},"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":25000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":150,"monthly_call_quota":200000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":500,"monthly_call_quota":900000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":1500,"monthly_call_quota":4000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/urischemes-api"}