Mijozlar ro'yxatini olish

GET

/v1/client

curl --request GET \
  --url 'https://api-admin.billz.ai/v1/client?page=1&limit=10' \
  --header 'Authorization: Bearer <token>' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

• Production

Xato kodlari: 400 — kiruvchi ma’lumotlar validatsiya xatosi; 401, 403, 429, 500 — barcha metodlar uchun umumiy. Tana formatlari va semantikasi: Javob kodlari va xatolar.

Authorizations

• BearerAuth

Parameters

Query Parameters

page

integer format: int32

default: 1

Sahifa raqami

limit

integer format: int32

default: 10

Sahifa hajmi

phone_number

string

Aniq telefon

chat_id

string

Telegram chat_id

search

string

Qidiruv satri

Header Parameters

platform-id

string

default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platforma identifikatori. Integratsiyalar uchun statik qiymat ishlatiladi.

Responses

200

Muvaffaqiyatli javob

Media typeapplication/json

object

count

Topilgan mijozlarning umumiy soni

integer format: int32

clients

Mijozlar ro’yxati

Array<object>

nullable

object

id

Mijoz IDsi

string format: uuid

external_id

Tashqi (tartib) identifikator

string

first_name

Ism

string

last_name

Familiya

string

middle_name

Otasining ismi

string

created_at

Yaratilgan sana

string

birth_date

Tug’ilgan sana

string

first_transaction_date

Birinchi tranzaksiya sanasi

string

last_transaction_date

Oxirgi tranzaksiya sanasi

string

balance

Keshbek balansi

number format: double

cards

Kartalar kodlari

Array<string>

company_name

Kompaniya nomi

string

chat_id

Telegram chat_id; qiymat bo’sh bo’lsa, maydon javobda bo’lmaydi

string

phone_numbers

Telefonlar

Array<string>

gender

Jins: male, female yoki bo’sh satr

string

Example^generated

{
  "count": 1,
  "clients": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "external_id": "example",
      "first_name": "example",
      "last_name": "example",
      "middle_name": "example",
      "created_at": "example",
      "birth_date": "example",
      "first_transaction_date": "example",
      "last_transaction_date": "example",
      "balance": 1,
      "cards": [
        "example"
      ],
      "company_name": "example",
      "chat_id": "example",
      "phone_numbers": [
        "example"
      ],
      "gender": "example"
    }
  ]
}