VertAPI

API ᲓᲝᲙᲣᲛᲔᲜᲢᲐᲪᲘᲐAPI documentation

მშენებლობის პროექტების API (თბილისი და ბათუმი) საპილოტე კომპანიებისთვის უკვე მუშაობს. აქ არის ყველაფერი, რაც დასაკავშირებლად გჭირდებათ.The construction projects API (Tbilisi and Batumi) is live for pilot companies. Here’s everything you need to connect.

ᲛᲘᲛᲝᲮᲘᲚᲕᲐOverview

VertAPI საჯარო წყაროებს თქვენ ნაცვლად კითხულობს და მონაცემებს ერთი მარტივი API-ით გაწვდით. დღეს მუშაობს თბილისის მშენებლობის ნებართვები.VertAPI reads public sources for you and serves the data through one simple API. Live today: Tbilisi building permits.

საბაზო მისამართიBase URLhttps://api.vertapi.app
ფორმატიFormatJSON, UTF-8
გასაღებიKeysგაიცემა მოთხოვნით, ერთ კომპანიაზე ერთი.Issued on request, one per company. მოთხოვნა →Request one →

რა მუშაობსWhat’s live

მშენებლობის ნებართვები, APIBuilding permits APIმუშაობს · პილოტიLive · pilot
ელფოსტის დაიჯესტი, Telegram ბოტიEmail digest, Telegram botმუშაობს · პილოტიLive · pilot
MCP სერვერიMCP serverმალეComing
დღგ-ის სტატუსის APIVAT status APIდაგეგმილიაPlanned

ᲐᲕᲢᲝᲠᲘᲖᲐᲪᲘᲐAuthentication

ყველა მოთხოვნას გასაღები Authorization სათაურით დაურთეთ:Send your key in the Authorization header of every request:

HTTP
Authorization: Bearer YOUR_KEY
  • გასაღებს მხოლოდ ჰეშის სახით ვინახავთ, ამიტომ მისი აღდგენა ჩვენც არ შეგვიძლია. თუ დაკარგეთ, ახალს გამოგიგზავნით და ძველი გაუქმდება.We store only a hash of your key, so we can’t recover it either. If you lose it, we issue a new one and the old one stops working.
  • გასაღები ერთ კომპანიას ეკუთვნის და მისი გადაცემა არ შეიძლება. სხვასთან გაზიარებულ გასაღებს შევაჩერებთ.A key belongs to one company and can’t be transferred. Shared keys get suspended.
  • გასაღები სერვერზე შეინახეთ. ნუ ჩასვამთ მას ბრაუზერის ან მობილური აპლიკაციის კოდში.Keep the key on your server. Don’t put it in browser or mobile app code.

ᲔᲜᲓᲞᲝᲘᲜᲢᲔᲑᲘEndpoints

GET/v1/projects

აბრუნებს პერიოდის დიდ სამშენებლო პროექტებს თქვენს გეგმაში შემავალი ქალაქებიდან, ერთ პასუხში, გვერდებად დაყოფის გარეშე. ითვლება დღიურ ლიმიტში. /v1/permits იგივეა, მხოლოდ თბილისით.Returns the period’s large construction projects for the cities in your plan, in one response, with no paging. Counts toward your daily limit. /v1/permits is the same, Tbilisi only.

ქალაქები და ეტაპებიCities and stages

ქალაქიCityრას აბრუნებსWhat you get
tbilisistage: permitგაცემული მშენებლობის ნებართვები, თბილისის არქიტექტურის სამსახურის რეესტრიდან. ვამოწმებთ ყოველ 3 საათში. მესაკუთრე — ნაკვეთის მესაკუთრე საჯარო რეესტრის მიხედვით.Construction permits issued, from the Tbilisi Architecture Service register. Checked every 3 hours. Owner = the plot owner per the public registry.
batumistage: development_planდიდი პროექტები განაშენიანების დეტალური გეგმის ეტაპზე, ნებართვამდე, ბათუმის მერიის საჯარო განხილვებიდან. ადრეული სიგნალია; განმცხადებელი ჩვეულებრივ დეველოპერია.Big projects at the detailed development plan stage, before the permit, from Batumi City Hall public hearings. An earlier signal; the applicant is usually the developer.

პარამეტრებიParameters

პარამეტრიParameterაღწერაDescription
citystring, optionaltbilisi, batumi ან all. ნაგულისხმევად all (თქვენი გეგმის ქალაქები).tbilisi, batumi or all. Default all (the cities in your plan).
sincestring, YYYY-MM-DD, optionalპერიოდის დასაწყისი. ნაგულისხმევად 7 დღის წინ; მაქსიმუმ 31 დღით უკან.Start of the period. Default 7 days ago; at most 31 days back.
untilstring, YYYY-MM-DD, optionalპერიოდის დასასრული. ნაგულისხმევად დღეს.End of the period. Default today.
scopestring, optionallarge (ნაგულისხმევი) ან all — თბილისის ყველა ნებართვა, კერძო სახლების გარდა.large (default) or all — every Tbilisi permit except private houses.

მოთხოვნაRequest

curl
curl "https://api.vertapi.app/v1/projects?city=all&since=2026-10-28" \
  -H "Authorization: Bearer YOUR_KEY"

პასუხიResponse

200 · JSON
{
  "period": { "since": "2026-10-28", "until": "2026-11-03" },
  "cities": ["tbilisi", "batumi"],
  "data_as_of": "2026-11-03T15:05:58Z",
  "count": 2,
  "permits": [
    {
      "city": "tbilisi",
      "stage": "permit",
      "date": "2026-11-02",
      "document_no": "AR11166946",
      "building_type": "მრავალფუნქციური კომპლექსი/შენობა",
      "building_class": "IV კლასი",
      "action": "ახალი მშენებლობა",
      "address": "ქალაქი თბილისი, უნივერსიტეტის ქუჩა N 46",
      "cadastral_codes": ["01.14.06.006.169"],
      "developer": {
        "name": "შპს „მაგალითი“",
        "companies": [{ "name": "შპს „მაგალითი“", "id_code": "400000000" }],
        "basis": "plot_owner",
        "confidence": "high"
      },
      "owner_type": "company",
      "height_m": 18.93,
      "has_lift": true,
      "construction_start": "2026-11-02",
      "construction_end": "2029-11-02",
      "public_page": "https://tas.ge/?p=publicpage&documentId=1166946"
    },
    {
      "city": "batumi",
      "stage": "development_plan",
      "date": "2026-10-22",
      "building_type": "მრავალბინიანი საცხოვრებელი კომპლექსი",
      "address": "ქალაქი ბათუმი, ქუჩა ლერმონტოვი, N 108",
      "cadastral_codes": ["05.26.29.096"],
      "developer": { "name": "შპს „მაგალითი 2“", "basis": "applicant" },
      "floors_max": 22,
      "height_m": 75,
      "document_url": "https://batumi.gov.ge/storage/…pdf"
    }
  ],
  "quota": { "limit": 1, "remaining": 0, "resets_at": "2026-11-03T20:00:00.000Z" }
}

ველებიFields

ველიFieldაღწერაDescription
city, stagestringქალაქი და ეტაპი: permit (ნებართვა გაცემულია) ან development_plan (ნებართვამდე).City and stage: permit (permit issued) or development_plan (before the permit).
datestring, dateთბილისი: ნებართვის გაცემის თარიღი. ბათუმი: განცხადების გამოქვეყნების თარიღი.Tbilisi: date the permit was issued. Batumi: date the notice was published.
building_type, building_class, actionstringობიექტის ტიპი, კლასი და ქმედება (მაგ. ახალი მშენებლობა). კლასი და ქმედება მხოლოდ თბილისში.Building type, class and action (e.g. new build). Class and action are Tbilisi only.
address, cadastral_codesstring, arrayმისამართი და საკადასტრო კოდები.Address and cadastral codes.
developerobject | nullკომპანია ან სახელმწიფო საიდენტიფიკაციო კოდით. თბილისი: ნაკვეთის მესაკუთრე (basis: plot_owner). ბათუმი: განმცხადებელი (basis: applicant). ფიზიკურ პირებს არ ვაბრუნებთ.A company or the state, with its ID code. Tbilisi: the plot owner (basis: plot_owner). Batumi: the applicant (basis: applicant). We never return private individuals.
owner_typestring | nullcompany, state, private (სახელის გარეშე) ან common (ბინის მესაკუთრეთა საერთო საკუთრება).company, state, private (no name given) or common (apartment owners’ shared property).
height_m, has_lift, floors_min, floors_maxnumber, booleanსიმაღლე, ლიფტი (თბილისი) და სართულები (ბათუმი), სადაც წყარო მიუთითებს.Height, lift (Tbilisi) and floors (Batumi), where the source states them.
construction_start, construction_endstring, dateმშენებლობის ვადა (თბილისი).Construction term (Tbilisi).
public_page, document_urlstringოფიციალური გვერდი ან PDF, გადასამოწმებლად.The official page or PDF, to double-check.
quotaobjectდღის ლიმიტი და როდის განახლდება.Your daily limit and when it resets.

მესაკუთრის და განმცხადებლის ველები ოფიციალური წყაროებიდანაა, მაგრამ ავტომატურად ემთხვევა და შეიძლება არაზუსტი იყოს. ნაკვეთის მესაკუთრე ყოველთვის დეველოპერი არ არის. გადაწყვეტილების მიღებამდე გადაამოწმეთ.Owner and applicant fields come from official sources but are matched automatically and may be inaccurate. A plot owner isn’t always the developer. Double-check before you act on them.

GET/v1/usage

გიჩვენებთ, რამდენი მოთხოვნა დაგრჩათ დღეს. დღიურ ლიმიტში არ ითვლება; საათში 10-ჯერ შეგიძლიათ გამოიძახოთ.Shows how many requests you have left today. It doesn’t count toward the daily limit; you can call it up to 10 times an hour.

curl
curl https://api.vertapi.app/v1/usage \
  -H "Authorization: Bearer YOUR_KEY"
200 · JSON
{
  "limit": 1,
  "used": 1,
  "remaining": 0,
  "resets_at": "2026-11-04T00:00:00+04:00"
}
ველიFieldაღწერაDescription
limitintegerდღიური ლიმიტი.Daily limit.
usedintegerდღეს გამოყენებული მოთხოვნები.Requests used today.
remainingintegerდარჩენილი მოთხოვნები.Requests left.
resets_atstring, ISO 8601როდის განახლდება ლიმიტი (00:00, თბილისის დროით).When the limit resets (00:00 Tbilisi time).

ᲚᲘᲛᲘᲢᲔᲑᲘLimits

თითოეულ კომპანიას ერთი გასაღები აქვს. ლიმიტები გასაღებზეა მიბმული და არა IP მისამართზე.Each company gets one key. Limits are tied to the key, not to an IP address.

/v1/projectsდღეში 1 მოთხოვნა გასაღებზე. ლიმიტი განახლდება 00:00-ზე, თბილისის დროით.1 request per day per key. Resets at 00:00 Tbilisi time.
პერიოდიWindowერთი მოთხოვნა აბრუნებს ბოლო 7 დღის ყველა ნებართვას, გვერდებად დაყოფის გარეშე. საჭიროებისას 31 დღემდე შეგიძლიათ დაბრუნდეთ უკან.One request returns every permit from the last 7 days, with no paging. You can go back up to 31 days.
ჩვენი შეცდომაOur errorsთუ შეცდომა ჩვენს მხარესაა (5xx), მოთხოვნა არ ითვლება.If the error is on our side (5xx), the request doesn’t count.
/v1/usageსაათში 10-მდე. დღიურ ლიმიტში არ ითვლება.Up to 10 times an hour. Doesn’t count toward the daily limit.
არასწორი გასაღებიInvalid keyწუთში 5 მოთხოვნა. საათში 20 წარუმატებელი მცდელობის შემდეგ IP მისამართი 1 საათით იბლოკება.5 requests a minute. After 20 failed attempts in an hour, that IP address is blocked for an hour.
Telegramერთ ანგარიშზე ერთი ჩატი. /latest დღეში ერთხელ.One chat per account. /latest once a day.

ᲛᲝᲜᲐᲪᲔᲛᲔᲑᲘᲡ ᲡᲘᲐᲮᲚᲔData freshness

  • წყაროს ყოველ 3 საათში ხელახლა ვკითხულობთ.We re-read the source every 3 hours.
  • თქვენი მოთხოვნა სახელმწიფო საიტს არ ეხება: პასუხი ჩვენი ასლიდან მოდის, ამიტომ ნელი ან გათიშული წყარო თქვენს მოთხოვნას არ აფერხებს.Your request never touches a government site. The answer comes from our copy, so a slow or unavailable source doesn’t hold up your request.
  • ყველა პასუხში data_as_of გიჩვენებთ, როდის განახლდა მონაცემები ბოლოს.Every response includes data_as_of, showing when the data was last refreshed.
  • დეველოპერისა და საკონტაქტო ველები ავტომატურად ემთხვევა და შეიძლება არაზუსტი იყოს.Developer and contact fields are matched automatically and may be inaccurate.

ᲨᲔᲪᲓᲝᲛᲔᲑᲘErrors

შეცდომისას API აბრუნებს HTTP სტატუსს და JSON-ს error ველით:On an error the API returns an HTTP status and JSON with an error field:

429 · JSON
{ "error": "daily_limit_reached" }
სტატუსიStatusროდისWhen
400არასწორი პარამეტრი, მაგალითად days 31-ზე მეტია.A bad parameter, for example days over 31.
401გასაღები არ არის ან არასწორია.The key is missing or invalid.
404ასეთი ენდპოინტი არ არსებობს.No such endpoint.
429დღის მოთხოვნა უკვე გამოყენებულია, /v1/usage-ის საათობრივი ლიმიტი ამოიწურა, ან არასწორი გასაღებით ძალიან ბევრი მოთხოვნა გაიგზავნა.Today’s request is already used, the hourly /v1/usage limit is reached, or too many requests came with an invalid key.
5xxშეცდომა ჩვენს მხარეს. ლიმიტში არ ითვლება; სცადეთ ცოტა ხანში.Something failed on our side. It doesn’t count toward your limit; try again shortly.

ᲛᲘᲬᲝᲓᲔᲑᲐ ᲙᲝᲓᲘᲡ ᲒᲐᲠᲔᲨᲔDelivery without code

პროგრამისტი არ გჭირდებათ: იგივე მონაცემები ელფოსტით ან Telegram-ითაც მოდის.You don’t need a developer: the same data also arrives by email or Telegram.

ელფოსტის დაიჯესტიEmail digest

  • ყოველდღე 09:00-ზე (თბილისის დროით) ახალ პროექტებს (თბილისი და ბათუმი) Excel ფაილით გიგზავნით.Every day at 09:00 Tbilisi time we email the new projects (Tbilisi and Batumi) as an Excel attachment.
  • ერთ კომპანიაზე ერთი ელფოსტის მისამართი.One email address per company.

Telegram ბოტიTelegram bot

  • @vertapi_bot. ჩვენგან მიიღებთ ერთჯერად კოდს, რომელიც ბოტს ერთ ჩატთან აკავშირებს.@vertapi_bot. We give you a one-time code that links the bot to one chat.
  • ახალ დიდ პროექტებს გამოქვეყნებისთანავე გიგზავნით.New large projects are pushed to you as soon as they’re published.
  • /latest: ბოლო 7 დღე, დღეში ერთხელ./latest: the last 7 days, once a day.
  • /status: კავშირის სტატუსი და მონაცემების ბოლო განახლების დრო./status: your link status and when the data was last refreshed.

MCP მალეComing

დისტანციური MCP სერვერი mcp.vertapi.app-ზე მზადდება. იმავე გასაღებით Claude, ChatGPT ან თქვენი აგენტი ნებართვებს პირდაპირ მოიძიებს.A remote MCP server at mcp.vertapi.app is coming. With the same key, Claude, ChatGPT or your own agent will be able to look up permits directly.

გინდათ პირველებმა სცადოთ? მოთხოვნაში მიუთითეთ.Want to try it first? Mention it in your request.

ᲓᲦᲒ-ᲘᲡ APIVAT API დაგეგმილია, არ მუშაობსPlanned, not live

დაახლოებით ასე გამოიყურება დღგ-ის სტატუსის API. ის ჯერ არ მუშაობს და ველები შეიძლება შეიცვალოს.This is roughly how the VAT status API will look. It isn’t live yet, and the fields may change.

curl · დაგეგმილიplanned
curl https://api.vertapi.app/v1/vat-status/400000000 \
  -H "Authorization: Bearer YOUR_KEY"
JSON · დაგეგმილიplanned
{
  "id_code": "400000000",
  "name": "შპს „მაგალითი“",
  "vat_status": "non_qualified",
  "previous": "qualified",
  "changed_on": "2026-11-02"
}

მანამდე დღგ-ის სტატუსის შემოწმება ელფოსტით შეგიძლიათ:Until then, VAT status checks work by email: როგორ მუშაობს →how it works →