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

Header	Değer	Zorunlu
Authorization	Bearer \{token\}	Evet

Query Parameters

Parametre	Tip	Zorunlu	Açıklama
search	string	Hayır	Genel arama (company_name, legal_name, tax_number, email)
is_active	boolean	Hayır	Aktif/pasif filtresi
with_trashed	boolean	Hayır	Silinen müşterileri de dahil et
page	integer	Hayır	Sayfa numarası (varsayılan: 1)
per_page	integer	Hayır	Sayfa 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

Related Endpoints

• Müşteri Oluştur - Yeni müşteri oluştur
• Müşteri Detayı - Müşteri detayını getir