API Reference

OpenKyrgyz provides a free REST API for verb conjugation and noun declension. All endpoints are read-only and require no authentication.

Download OpenAPI spec (openapi.yaml)

GET /api/v1/verbs/conjugations/{verb}

Returns verb conjugations. By default includes all 10 tenses × 4 forms × 8 pronouns, imperatives, optative, and moods.

Parameter	Required	Default	Description
`verb`	Path	—	Verb stem in Kyrgyz Cyrillic (e.g. бар, кел, жаз)
`tenses`	No	all	Comma-separated tenses/sections. Values: PresentAndFuture, PresentContinuous, FutureProbable, FutureGoingTo, PastDefinite, PastIndefinite, PastUsedTo, PastSudden, Conditional, Intention, Imperative, Optative
`forms`	No	all	Comma-separated forms. Values: Positive, Negative, Interrogative, NegativeAndInterrogative
`includeMoods`	No	`true`	Include passive/reflexive/cooperative moods
`includeVerbForms`	No	`false`	Include verb forms: gerund, participle, cause, goal, although, despite, etc.
`includeTimeForms`	No	`false`	Include time-related forms: when, while, before, after, until, etc.

# All conjugations
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар"

# Only past tenses + imperatives
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар?tenses=PastDefinite,Imperative"

# Negative form only, with verb forms
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар?forms=Negative&includeVerbForms=true"

GET /api/v1/nouns/declensions/{noun}

Returns noun declensions. By default includes cases and possessive forms.

Parameter	Required	Default	Description
`noun`	Path	—	Noun in Kyrgyz Cyrillic (e.g. үй, бала, китеп)
`includeCases`	No	`true`	Include singular and plural declensions across 6 cases
`includePossessive`	No	`true`	Include possessive forms with full case declensions for all 7 pronouns
`includeCopula`	No	`false`	Include copula (to be) forms for all 8 pronouns

# Cases and possessive (default)
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй"

# Cases only
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй?includePossessive=false"

# With copula forms
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй?includeCopula=true"