{"openapi":"3.1.0","info":{"title":"Inflector API","version":"1.0.0","description":"English word inflection as an API. Pluralize or singularize any word — correctly handling the irregulars that trip up naive code (person ↔ people, cactus ↔ cacti, goose ↔ geese, analysis ↔ analyses, and uncountables like sheep and series). Get count-aware inflection (\"1 item\" vs \"3 items\", optionally with the number included), and check whether a given word is already singular or plural. Everything is computed locally, so it is instant and always available. Ideal for ORMs and code generators, REST resource naming, UI labels and notifications (\"3 result(s)\"), search and autocomplete, and any app that turns counts into correct grammar. For case styles and URL slugs, use the Text API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/inflector-api","description":"oanor gateway"}],"tags":[{"name":"Inflector"},{"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/check":{"get":{"operationId":"get_v1_check","tags":["Inflector"],"summary":"Is a word plural or singular?","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Word, e.g. geese","schema":{"type":"string"},"example":"geese"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"word":"geese","plural":"geese","singular":"goose","is_plural":true,"is_singular":false},"meta":{"timestamp":"2026-06-01T00:04:23.629Z","request_id":"3fbe651f-1e58-4440-9d1d-359e171dc3dd"},"status":"ok","message":"Checked","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/inflect":{"get":{"operationId":"get_v1_inflect","tags":["Inflector"],"summary":"Count-aware inflection","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Word, e.g. item","schema":{"type":"string"},"example":"item"},{"name":"count","in":"query","required":false,"description":"Count (default 2)","schema":{"type":"string"},"example":"3"},{"name":"include_count","in":"query","required":false,"description":"true to prefix the number","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"word":"item","count":3,"result":"3 items","inflected":"items","is_plural":true},"meta":{"timestamp":"2026-06-01T00:04:23.710Z","request_id":"cce4a605-422d-4c60-ae13-71bb9496261e"},"status":"ok","message":"Inflected","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/pluralize":{"get":{"operationId":"get_v1_pluralize","tags":["Inflector"],"summary":"Pluralize a word","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Word, e.g. cactus","schema":{"type":"string"},"example":"cactus"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"word":"cactus","plural":"cacti","already_plural":false},"meta":{"timestamp":"2026-06-01T00:04:23.780Z","request_id":"8db7f68b-62e2-4c6c-bd91-e36b653e9235"},"status":"ok","message":"Pluralized","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/singularize":{"get":{"operationId":"get_v1_singularize","tags":["Inflector"],"summary":"Singularize a word","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Word, e.g. mice","schema":{"type":"string"},"example":"mice"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"word":"mice","singular":"mouse","already_singular":false},"meta":{"timestamp":"2026-06-01T00:04:23.832Z","request_id":"8b939f60-cf43-4d79-a500-7c422853d340"},"status":"ok","message":"Singularized","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":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"English word inflection. /v1/pluralize?word=cactus → cacti; /v1/singularize?word=mice → mouse; /v1/inflect?word=item&count=3 → items (count-aware; include_count=true → '3 items'); /v1/check?word=geese → whether it is plural/singular plus both forms. Handles irregular nouns (person↔people, goose↔geese, sheep↔sheep). Runs fully locally. For case styles & slugs use the Text API.","source":"local inflector (pluralize engine)","endpoints":["/v1/pluralize","/v1/singularize","/v1/inflect","/v1/check","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:23.901Z","request_id":"8ac22097-578e-409c-b467-0f3260624d2d"},"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":18000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":210,"monthly_call_quota":245000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":790,"monthly_call_quota":960000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2710,"monthly_call_quota":3950000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/inflector-api"}