{
 "openapi": "3.1.0",
 "info": {
  "title": "Lithuania Public Procurement API (lt-procurement)",
  "version": "1.0.0",
  "description": "Active public procurement notices in Lithuania from the EU TED portal and the national CVP IS public list (viesiejipirkimai.lt). Search by keywords, CPV, region, value and deadline; track changes. Every record links to the original notice. Data may lag up to 24 h. Free: 100 requests per key (10/day without key). Paid: EUR 19/month for 10,000 requests.",
  "contact": {
   "name": "MB Web studija",
   "email": "info@saitai.lt",
   "url": "https://apibase.lt/pirkimai/"
  },
  "termsOfService": "https://apibase.lt/pirkimai/api/#salygos"
 },
 "externalDocs": {
  "url": "https://apibase.lt/pirkimai/api/"
 },
 "servers": [
  {
   "url": "https://apibase.lt/api/pirkimai"
  }
 ],
 "security": [
  {
   "ApiKey": []
  },
  {
   "Bearer": []
  },
  {}
 ],
 "components": {
  "securitySchemes": {
   "ApiKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-Api-Key"
   },
   "Bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {
   "Tender": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "buyer": {
      "type": "string"
     },
     "deadline": {
      "type": "string"
     },
     "published": {
      "type": "string"
     },
     "value": {
      "type": "number"
     },
     "currency": {
      "type": "string"
     },
     "contract_type": {
      "type": "string"
     },
     "procedure": {
      "type": "string"
     },
     "status": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "notice_pdf": {
      "type": "string"
     },
     "ted_url": {
      "type": "string"
     },
     "active": {
      "type": "boolean"
     },
     "first_seen": {
      "type": "string"
     },
     "updated": {
      "type": "string"
     },
     "description": {
      "type": "string"
     },
     "cpv": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "cpv_names": {
      "type": "array",
      "items": {
       "type": [
        "string",
        "null"
       ]
      }
     },
     "region": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "nuts": {
         "type": "string"
        },
        "name": {
         "type": "string"
        }
       }
      }
     }
    }
   },
   "Error": {
    "type": "object",
    "properties": {
     "error": {
      "type": "string"
     },
     "message": {
      "type": "string"
     }
    }
   }
  }
 },
 "paths": {
  "/v1/tenders": {
   "get": {
    "operationId": "searchTenders",
    "summary": "Search active tenders",
    "tags": [
     "Tenders"
    ],
    "parameters": [
     {
      "name": "text",
      "in": "query",
      "required": false,
      "description": "Keywords (all must match, Lithuanian endings ignored)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "cpv",
      "in": "query",
      "required": false,
      "description": "CPV codes or prefixes, comma-separated (e.g. 72 or 45233000)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "region",
      "in": "query",
      "required": false,
      "description": "NUTS code LT011…LT029 or county name (e.g. Kauno)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "min_value",
      "in": "query",
      "required": false,
      "description": "Minimum estimated value, EUR",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "max_value",
      "in": "query",
      "required": false,
      "description": "Maximum estimated value, EUR",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "deadline_from",
      "in": "query",
      "required": false,
      "description": "Deadline from (YYYY-MM-DD), default now",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "deadline_to",
      "in": "query",
      "required": false,
      "description": "Deadline until (YYYY-MM-DD)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "published_from",
      "in": "query",
      "required": false,
      "description": "Published from (YYYY-MM-DD)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "contract_type",
      "in": "query",
      "required": false,
      "description": "Contract type",
      "schema": {
       "type": "string",
       "enum": [
        "works",
        "services",
        "supplies"
       ]
      }
     },
     {
      "name": "buyer",
      "in": "query",
      "required": false,
      "description": "Contracting authority name contains",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "source",
      "in": "query",
      "required": false,
      "description": "Source",
      "schema": {
       "type": "string",
       "enum": [
        "ted",
        "cvpis"
       ]
      }
     },
     {
      "name": "sort",
      "in": "query",
      "required": false,
      "description": "Sort order",
      "schema": {
       "type": "string",
       "enum": [
        "deadline",
        "published",
        "value"
       ]
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Results per page (1–50, default 20)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Offset",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Results",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "total": {
           "type": "integer"
          },
          "count": {
           "type": "integer"
          },
          "offset": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Tender"
           }
          },
          "requests_remaining": {
           "type": "integer"
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "Bad parameter",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "Invalid key",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "402": {
      "description": "Free requests used up — subscribe",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "Rate limit or monthly quota",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/v1/tenders/{id}": {
   "get": {
    "operationId": "getTender",
    "summary": "One tender with full description",
    "tags": [
     "Tenders"
    ],
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "ted:787554-2023",
      "description": "cvpis:<resourceId> or ted:<publication-number>"
     }
    ],
    "responses": {
     "200": {
      "description": "Tender",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Tender"
        }
       }
      }
     },
     "404": {
      "description": "Not found",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "400": {
      "description": "Bad parameter",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "Invalid key",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "402": {
      "description": "Free requests used up — subscribe",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "Rate limit or monthly quota",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/v1/changes": {
   "get": {
    "operationId": "changesSince",
    "summary": "New, changed and closed tenders since a time",
    "tags": [
     "Tenders"
    ],
    "parameters": [
     {
      "name": "since",
      "in": "query",
      "required": false,
      "description": "ISO time, e.g. 2026-11-20T00:00:00Z",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "cursor",
      "in": "query",
      "required": false,
      "description": "next_cursor from the previous response",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "cpv",
      "in": "query",
      "required": false,
      "description": "CPV codes or prefixes",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "1–100, default 50",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Changes",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "items": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Tender"
           }
          },
          "next_cursor": {
           "type": "string"
          },
          "has_more": {
           "type": "boolean"
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "Bad parameter",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "Invalid key",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "402": {
      "description": "Free requests used up — subscribe",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "Rate limit or monthly quota",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/v1/cpv": {
   "get": {
    "operationId": "listCpv",
    "summary": "Find CPV codes (free)",
    "tags": [
     "Reference"
    ],
    "security": [
     {}
    ],
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": false,
      "description": "Words or code prefix",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "1–50",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "CPV codes",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/v1/key": {
   "get": {
    "operationId": "keyStatus",
    "summary": "Key balance and plan",
    "tags": [
     "Account"
    ],
    "responses": {
     "200": {
      "description": "Key status",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Key required",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/v1/status": {
   "get": {
    "operationId": "status",
    "summary": "Data freshness and pricing (free)",
    "tags": [
     "Reference"
    ],
    "security": [
     {}
    ],
    "responses": {
     "200": {
      "description": "Status",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 }
}