Integrator catalog
The public AISAR integrator catalog with no authorization: the list and the card of partners whose profiles passed moderation, logos, a sitemap for search engines, a request for an integrator with confirmation by a code from an email, and the shared city reference (Kazakhstan, Kyrgyzstan, Uzbekistan, Russia). While the catalog or request intake is not open, the matching routes answer 404.
Access and switches
No route of the group needs an Authorization header. The catalog (/v1/public/partners*) and request intake (/v1/public/partner-leads*) are turned on by separate platform switches; while a switch is off the routes answer 404 { "message": "Not found." }. The city reference (/v1/public/geo/cities) does not depend on the switches. Request limits apply per IP: exceeding them returns 429.
Only a partner with an active workspace, a profile approved by a moderator, publication switched on and an accepted current partner agreement is listed. Only the approved snapshot of the profile and earned certifications go out; commissions, contacts and internal notes of the partner are never published. Response format of this group: lists are { "data": [...], "meta": {...} }, the card and the sitemap are { "data": ... }, request form answers have no data wrapper.
List and card
GET /v1/public/partners accepts optional filters: country (KZ, KG, UZ, RU), city_id (a city id from the reference), specialization (whatsapp, instagram, telegram, telephony, ai_agents, automation, bitrix24, amocrm, onboarding), language (ru, kk, en, ky, uz), q (a search of 2 to 80 characters over the name, tagline and cities), locale (ru, en, kk, en by default: the language of city names) and page (1 to 1000). A page holds up to 24 partners ordered by name. The city_id filter matches reference cities only: a partner who typed their own city is found by country and by q. An unknown filter value returns 422.
GET /v1/public/partners/{slug} returns the card: the list card fields plus description, website, founded_year, team_size, cases, og_image_url, published_at. An unknown or hidden slug returns 404 { "message": "Not found." }. The logo and the link preview image are served at GET /v1/public/partners/{slug}/logo and /og-image (links to them arrive in logo_url and og_image_url, with a trailing ?v= for cache busting); a hidden profile or a missing file answers 404. GET /v1/public/partners/sitemap returns the slug and updated_at of all visible partners for a sitemap.
Request for an integrator
POST /v1/public/partner-leads accepts a visitor request. Required fields: contact_name (2 to 100 characters), email, country (KZ, KG, UZ, RU), consent (must be true) and exactly one of two: geo_city_id (a city from the reference, which must belong to the given country) or city_name (your own city as text, up to 80 characters); passing both is not allowed. Optional: partner_slug (a request to a specific integrator from the catalog), ref_slug, phone (validated against the country), company_name, company_size (1-5, 6-15, 16-50, 51-200, 200+), needs[] (specialization codes), message (up to 2000 characters), locale (ru, en, kk), utm_source, utm_medium, utm_campaign, utm_content, utm_term, landing_path, visitor_id. Text fields are stripped of markup. The website and form_started_at fields are bot protection: leave website empty, form_started_at is optional.
The answer is always 202 { "status": "check_email", "submission_token": "..." }, whether the address is new, known or a repeat: the answer never reveals whether an address is in the system. A six-digit code is sent by email. A request is confirmed in one of two ways: POST /v1/public/partner-leads/verify with submission_token (from the create answer, 40 characters) and code, or POST /v1/public/partner-leads/{publicId}/verify with code alone (the request id arrives in the link from the email). The code is six digits and valid for 24 hours, with 5 attempts per request. Success: 200 { "status": "verified" }. A wrong code, an unknown request and used-up attempts all give the same 422 { "error": "invalid_code" }. An unconfirmed request is not shown to integrators.
City reference
GET /v1/public/geo/cities?country=KZ returns the active cities of a country, the largest first. Parameters: country (required: KZ, KG, UZ, RU), q (up to 64 characters, a case-insensitive prefix match over the name in any language or a former name) and locale (ru, en, kk, en by default). An item: id, code, name and region in the chosen language, is_admin_center. The response is cached (ETag, Cache-Control: public, max-age=86400), and a repeat request with If-None-Match gets 304. An id from this reference goes into the catalog city_id and into the request geo_city_id. The data is derived from GeoNames (CC BY 4.0).
Endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/public/partnersList catalog integrators with filters and pages | List catalog integrators with filters and pages |
| GET | /v1/public/partners/sitemapSlug and update date of all visible integrators (for a sitemap) | Slug and update date of all visible integrators (for a sitemap) |
| GET | /v1/public/partners/{slug}Integrator card | Integrator card |
| GET | /v1/public/partners/{slug}/{asset}Integrator logo (`logo`) or link preview image (`og-image`) | Integrator logo (`logo`) or link preview image (`og-image`) |
| POST | /v1/public/partner-leadsRequest for an integrator (202, the code is sent by email) | Request for an integrator (202, the code is sent by email) |
| POST | /v1/public/partner-leads/verifyConfirm a request by `submission_token` and the code from the email | Confirm a request by `submission_token` and the code from the email |
| POST | /v1/public/partner-leads/{publicId}/verifyConfirm a request by the id from the email link and the code | Confirm a request by the id from the email link and the code |
| GET | /v1/public/geo/citiesCity reference of a country (KZ, KG, UZ, RU) with a name-prefix search | City reference of a country (KZ, KG, UZ, RU) with a name-prefix search |
Examples
List WhatsApp integrators in Kazakhstan
Request
curl "https://api.aisar.app/v1/public/partners?country=KZ&specialization=whatsapp&locale=ru"Response
{
"data": [
{
"slug": "acme-integrations",
"display_name": "Acme Integrations",
"tagline": { "ru": "Внедряем WhatsApp и CRM под ключ", "en": "WhatsApp and CRM rollout end to end" },
"logo_url": "https://api.aisar.app/v1/public/partners/acme-integrations/logo?v=1763100000",
"countries": ["KZ"],
"cities": [
{ "id": 101, "name": "Алматы" },
{ "id": null, "name": "Шымкент" }
],
"specializations": ["whatsapp", "bitrix24"],
"languages": ["ru", "kk"],
"certifications": [
{ "slug": "technical-onboarding", "name": "Technical Onboarding", "badge_icon": "settings", "earned_at": "2026-10-02T09:00:00+00:00" }
],
"accepts_leads": true
}
],
"meta": { "current_page": 1, "last_page": 1, "per_page": 24, "total": 1 }
}Integrator card
Request
curl "https://api.aisar.app/v1/public/partners/acme-integrations?locale=en"Response
{
"data": {
"slug": "acme-integrations",
"display_name": "Acme Integrations",
"tagline": { "ru": "Внедряем WhatsApp и CRM под ключ", "en": "WhatsApp and CRM rollout end to end" },
"logo_url": "https://api.aisar.app/v1/public/partners/acme-integrations/logo?v=1763100000",
"countries": ["KZ"],
"cities": [{ "id": 101, "name": "Almaty" }],
"specializations": ["whatsapp", "bitrix24"],
"languages": ["ru", "kk"],
"certifications": [],
"accepts_leads": true,
"description": { "ru": "Команда из 12 человек.", "en": "A team of 12 people." },
"website": "https://acme.example",
"founded_year": 2019,
"team_size": "6-15",
"cases": [
{ "title": "Retail chain", "problem": "Requests got lost across messengers.", "solution": "One inbox with routing.", "result": "First reply time halved." }
],
"og_image_url": null,
"published_at": "2026-11-10T08:30:00+00:00"
}
}Request for an integrator (202)
Request
curl -X POST https://api.aisar.app/v1/public/partner-leads \
-H "Content-Type: application/json" \
-d '{
"partner_slug": "acme-integrations",
"contact_name": "Aigerim",
"email": "aigerim@example.com",
"country": "KZ",
"geo_city_id": 101,
"company_size": "6-15",
"needs": ["whatsapp", "bitrix24"],
"message": "Need WhatsApp inside Bitrix24.",
"locale": "ru",
"consent": true
}'Response
{ "status": "check_email", "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy" }Confirm a request by submission_token
Request
curl -X POST https://api.aisar.app/v1/public/partner-leads/verify \
-H "Content-Type: application/json" \
-d '{ "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy", "code": "482913" }'Response
{ "status": "verified" }Confirm a request from the email link
Request
curl -X POST https://api.aisar.app/v1/public/partner-leads/0b6f7c1e-3a52-4d8e-9f10-6c2e5a7d9b34/verify \
-H "Content-Type: application/json" \
-d '{ "code": "482913" }'Response
{ "status": "verified" }Wrong code (422)
Request
curl -X POST https://api.aisar.app/v1/public/partner-leads/verify \
-H "Content-Type: application/json" \
-d '{ "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy", "code": "000000" }'Response
{ "error": "invalid_code" }Catalog sitemap
Request
curl "https://api.aisar.app/v1/public/partners/sitemap"Response
{
"data": [
{ "slug": "acme-integrations", "updated_at": "2026-11-10T08:30:00+00:00" },
{ "slug": "northwind-digital", "updated_at": "2026-11-12T14:05:00+00:00" }
]
}Integrator logo (image file)
Request
# 200: the image itself (image/png, image/jpeg, image/webp or image/svg+xml),
# Cache-Control: public, max-age=300, X-Content-Type-Options: nosniff.
# Use "og-image" instead of "logo" for the link preview image.
curl "https://api.aisar.app/v1/public/partners/acme-integrations/logo" \
-o acme-logo.pngCity search
Request
curl "https://api.aisar.app/v1/public/geo/cities?country=KZ&q=алм&locale=ru"Response
{
"data": [
{ "id": 101, "code": "KZ-ALA", "name": "Алматы", "region": "Алматы", "is_admin_center": true }
]
}