Alt hesap listeleme

Ana hesabınıza bağlı alt hesapları API anahtarları ve e-Faturam durumlarıyla birlikte listelemek için bu endpoint kullanılır. Liste en son açılan alt hesaptan başlayarak sıralanır.

Bu uç yalnızca Geliştirici paketindeki ana hesabın anahtarıyla çağrılır; alt hesabın anahtarıyla 403 döner.

İstek

GET /api/sub-accounts
Accept: application/json
Authorization: Bearer ANA_HESAP_API_KEY

Sorgu parametreleri

Parametre	Varsayılan	Açıklama
per_page	20	Sayfa başına kayıt sayısı.
page	1	Sayfa numarası.

Örnek istekler

💻 cURL

curl -X GET "https://app.faturaentegrator.com/api/sub-accounts?per_page=50" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ANA_HESAP_API_KEY"

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/sub-accounts?per_page=50');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer ANA_HESAP_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/sub-accounts?per_page=50', {
  headers: { Accept: 'application/json', Authorization: 'Bearer ANA_HESAP_API_KEY' },
});
const data = await res.json();

🐍 Python

import requests
r = requests.get(
    'https://app.faturaentegrator.com/api/sub-accounts',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer ANA_HESAP_API_KEY'},
    params={'per_page': 50},
)
data = r.json()

Yanıt

{
  "data": [
    {
      "id": 1234,
      "name": "Örnek Ticaret Ltd. Şti.",
      "parent_team_id": 42,
      "api_key": "x3Yf9kQ2...",
      "invoice_integrations_count": 1,
      "tenant": {
        "id": 88,
        "name": "ÖRNEK TİCARET LTD. ŞTİ.",
        "tax_number": "1234567890",
        "is_active": true,
        "credit_qty": 150
      },
      "created_at": "2026-11-06T09:00:00.000000Z"
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": null },
  "meta": { "current_page": 1, "per_page": 50, "total": 1, "last_page": 1 }
}

Kayıt alanlarının açıklaması alt hesap oluşturma sayfasındadır.

tenant alanları

tenant, alt hesabın e-Faturam firmasıdır; alt hesap e-Faturam başvurusu yapmadıysa null döner. Kontör yalnızca is_active: true olan firmalara yüklenebilir.

Alan	Açıklama
id	e-Faturam firma kaydının kimliği.
name	Firma unvanı.
tax_number	Firmanın VKN/TCKN değeri.
is_active	Başvuru onaylanıp firma aktifleştiyse true, onay bekliyorsa false.
credit_qty	Firmada kalan e-Faturam kontörü. Kontör yüklemesinden sonra birkaç dakika içinde güncellenir.