Skip to content
AISARAISAR
REST API

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

MethodPath
GET/v1/public/partners

List catalog integrators with filters and pages

GET/v1/public/partners/sitemap

Slug and update date of all visible integrators (for a sitemap)

GET/v1/public/partners/{slug}

Integrator card

GET/v1/public/partners/{slug}/{asset}

Integrator logo (`logo`) or link preview image (`og-image`)

POST/v1/public/partner-leads

Request for an integrator (202, the code is sent by email)

POST/v1/public/partner-leads/verify

Confirm a request by `submission_token` and the code from the email

POST/v1/public/partner-leads/{publicId}/verify

Confirm a request by the id from the email link and the code

GET/v1/public/geo/cities

City reference of a country (KZ, KG, UZ, RU) with a name-prefix search

Examples

List WhatsApp integrators in Kazakhstan

Request

bash
curl "https://api.aisar.app/v1/public/partners?country=KZ&specialization=whatsapp&locale=ru"

Response

json
{
  "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

bash
curl "https://api.aisar.app/v1/public/partners/acme-integrations?locale=en"

Response

json
{
  "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

bash
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

json
{ "status": "check_email", "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy" }

Confirm a request by submission_token

Request

bash
curl -X POST https://api.aisar.app/v1/public/partner-leads/verify \
  -H "Content-Type: application/json" \
  -d '{ "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy", "code": "482913" }'

Response

json
{ "status": "verified" }

Confirm a request from the email link

Request

bash
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

json
{ "status": "verified" }

Wrong code (422)

Request

bash
curl -X POST https://api.aisar.app/v1/public/partner-leads/verify \
  -H "Content-Type: application/json" \
  -d '{ "submission_token": "Xk3m9QwR7tYb2LpZ0aVn8CdEfGhJ4sUoI5rT1uBy", "code": "000000" }'

Response

json
{ "error": "invalid_code" }

Catalog sitemap

Request

bash
curl "https://api.aisar.app/v1/public/partners/sitemap"

Response

json
{
  "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

bash
# 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.png

City search

Request

bash
curl "https://api.aisar.app/v1/public/geo/cities?country=KZ&q=алм&locale=ru"

Response

json
{
  "data": [
    { "id": 101, "code": "KZ-ALA", "name": "Алматы", "region": "Алматы", "is_admin_center": true }
  ]
}