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 URL | https://api.vertapi.app |
| ფორმატიFormat | JSON, 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:
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, optional | tbilisi, 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, optional | large (ნაგულისხმევი) ან all — თბილისის ყველა ნებართვა, კერძო სახლების გარდა.large (default) or all — every Tbilisi permit except private houses. |
მოთხოვნაRequest
curl "https://api.vertapi.app/v1/projects?city=all&since=2026-10-28" \ -H "Authorization: Bearer YOUR_KEY"
პასუხიResponse
{
"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 | null | company, 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 https://api.vertapi.app/v1/usage \ -H "Authorization: Bearer YOUR_KEY"
{
"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 includesdata_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:
{ "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 https://api.vertapi.app/v1/vat-status/400000000 \ -H "Authorization: Bearer YOUR_KEY"
{
"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 →
გასაღები გჭირდებათ?Need a key?
წვდომის მოთხოვნაRequest access