Ana içeriğe geç

Müşteri Listesi

Tüm müşterileri listeler.

Endpoint​

GET /api/v1/customers

Authentication​

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission​

  • customers.view - Tüm müşterileri görüntüleme
  • customers.view.own - Sadece kendi müşterilerini görüntüleme

Request​

Headers​

HeaderDeğerZorunlu
AuthorizationBearer \{token\}Evet

Query Parameters​

ParametreTipZorunluAçıklama
searchstringHayırGenel arama (company_name, legal_name, tax_number, email)
is_activebooleanHayırAktif/pasif filtresi
with_trashedbooleanHayırSilinen müşterileri de dahil et
pageintegerHayırSayfa numarası (varsayılan: 1)
per_pageintegerHayırSayfa başına kayıt (varsayılan: 15, max: 100)

Response​

Success Response (200 OK)​

{
  "data": [
    {
      "id": 1,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "company_name": "Örnek Şirket",
      "legal_name": "Örnek Şirket Ltd.",
      "tax_number": "1234567890",
      "email": "info@ornek.com",
      "is_active": true,
      "user_id": 1,
      "detail": {
        "annual_revenue": 1000000,
        "annual_revenue_converted": 1000000,
        "annual_revenue_currency": "TRY"
      },
      "created_at": "2025-11-20T12:00:00.000000Z"
    }
  ],
  "current_page": 1,
  "per_page": 15,
  "total": 1,
  "last_page": 1
}

Code Examples​

cURL​

curl -X GET https://api.example.com/api/v1/customers \
  -H "Authorization: Bearer \{token\}"

Notes​

  • Varsayılan olarak sadece aktif müşteriler döner
  • .own permission'ı olan kullanıcılar sadece kendi müşterilerini görür
  • Müşteri detayları (detail) ile birlikte döner
  • Yıllık gelir kullanıcının para birimi tercihine göre dönüştürülür