{
 "openapi": "3.1.0",
 "info": {
  "title": "Lithuanian name declension API (Vardų linksniai)",
  "version": "1.0.0",
  "description": "Declines Lithuanian first names and surnames into all 7 cases and returns the vocative for e-mail greetings. Free key with 500 requests at https://apibase.lt/vardai/#raktas; €20 per 10,000 requests.",
  "contact": {
   "name": "MB Web studija",
   "email": "info@saitai.lt",
   "url": "https://apibase.lt/vardai/"
  }
 },
 "servers": [
  {
   "url": "https://apibase.lt/api/vardai/v1"
  }
 ],
 "components": {
  "securitySchemes": {
   "ApiKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-Api-Key"
   }
  }
 },
 "security": [
  {
   "ApiKey": []
  }
 ],
 "paths": {
  "/linksniai": {
   "get": {
    "operationId": "linksniai",
    "summary": "All 7 cases + greetings",
    "parameters": [
     {
      "name": "vardas",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "First name(s), e.g. Jonas / Ona Marija"
     },
     {
      "name": "pavarde",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Surname, e.g. Petraitis / Kazlauskienė"
     },
     {
      "name": "pilnas",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Full name in one string (last word = surname)"
     },
     {
      "name": "lytis",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "v",
        "m"
       ]
      },
      "description": "v = male, m = female (optional, detected)"
     }
    ],
    "responses": {
     "200": {
      "description": "Cases (linksniai), greetings (kreipinys), notes (pastabos)"
     },
     "402": {
      "description": "Balance empty"
     },
     "429": {
      "description": "Rate limit"
     }
    }
   }
  },
  "/kreipinys": {
   "get": {
    "operationId": "kreipinys",
    "summary": "Vocative greeting only",
    "parameters": [
     {
      "name": "vardas",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "First name(s), e.g. Jonas / Ona Marija"
     },
     {
      "name": "pavarde",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Surname, e.g. Petraitis / Kazlauskienė"
     },
     {
      "name": "pilnas",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Full name in one string (last word = surname)"
     },
     {
      "name": "lytis",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "v",
        "m"
       ]
      },
      "description": "v = male, m = female (optional, detected)"
     }
    ],
    "responses": {
     "200": {
      "description": "kreipinys: vardu, pilnas, oficialus, laba_diena"
     }
    }
   }
  },
  "/masinis": {
   "post": {
    "operationId": "masinis",
    "summary": "Bulk declension, up to 500 names",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "vardai": {
          "type": "array",
          "items": {
           "oneOf": [
            {
             "type": "string"
            },
            {
             "type": "object",
             "properties": {
              "vardas": {
               "type": "string"
              },
              "pavarde": {
               "type": "string"
              },
              "lytis": {
               "type": "string",
               "enum": [
                "v",
                "m"
               ]
              }
             }
            }
           ]
          }
         }
        },
        "required": [
         "vardai"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "rezultatai[]"
     }
    }
   }
  },
  "/tikrinti": {
   "post": {
    "operationId": "tikrinti",
    "summary": "Check greetings in Lithuanian text",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "tekstas": {
          "type": "string"
         }
        },
        "required": [
         "tekstas"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "klaidos[], pataisytas"
     }
    }
   }
  },
  "/raktas": {
   "get": {
    "operationId": "raktas",
    "summary": "Key balance and purchase link",
    "responses": {
     "200": {
      "description": "likutis, sunaudota, pirkti"
     }
    }
   }
  },
  "/status": {
   "get": {
    "operationId": "status",
    "security": [],
    "summary": "Service status",
    "responses": {
     "200": {
      "description": "ok"
     }
    }
   }
  }
 }
}