Skip to content

Fatura Listesi​

GET
/api/v1/finance/invoices

Organizasyonunuzun faturalarını sayfalı olarak listeler.

Parametreler​

Başlık Parametreleri

Authorization*

Token Alma isteğinden dönen token, Bearer önekiyle

Tipstring
Zorunlu
Örnek"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.signature"
Accept-Language

Yanıttaki ad alanlarının (ülke, ölçü birimi, durum ve paket ek ücreti adları) ve doğrulama mesajlarının dili. en ile başlıyorsa (ör. en, en-US) İngilizce, aksi halde Türkçe. Başarı, iş kuralı, yetki ve 503 mesajları her zaman Türkçe döner.

Tipstring
Örnekler
"tr"
"en"
Varsayılan"tr"

Query Parametreleri

page

Sayfa numarası

Tipinteger
Minimum1
Varsayılan1
perPage

Sayfa başına kayıt sayısı

Tipinteger
Minimum1
Maksimum200
Varsayılan25
sortBy

Sıralama alanı

Tipstring
Geçerli değerler
"id""number""dateAt""paymentExpirationAt""priceTry""priceUsd"
Varsayılan"id"
sortOrder

Sıralama yönü

Tipstring
Geçerli değerler
"asc""desc"
Varsayılan"desc"
search

Tek değerde ID'si bu değere eşit ya da numarasında bu değer geçen faturalar döner. Virgülle ayrılmış değerlerde her biri ID ya da numarayla tam eşleşir.

Tipstring
Örnek"ZEM2026"
Min Uzunluk1
Max Uzunluk255
id

Fatura ID'si

Tipinteger
Minimum1
number

Fatura numarası (tam eşleşme)

Tipstring
Örnek"ZEM2026000000009"
Min Uzunluk1
Max Uzunluk16
statusId

Fatura durumu. 1 = NEW, 2 = WAITING, 3 = COMPLETED.

Tipinteger
Geçerli değerler
123
isPaid

true ödenmiş, false ödenmemiş faturalar (1 / 0 da kabul edilir)

Tipboolean
dateFrom

Fatura tarihi başlangıcı (YYYY-MM-DD, gün dahil)

Tipstring
Örnek"2026-01-01"
Format"date"
dateTo

Fatura tarihi bitişi (YYYY-MM-DD, gün dahil)

Tipstring
Örnek"2026-01-31"
Format"date"
paymentExpirationFrom

Son ödeme tarihi başlangıcı (YYYY-MM-DD, gün dahil)

Tipstring
Format"date"
paymentExpirationTo

Son ödeme tarihi bitişi (YYYY-MM-DD, gün dahil)

Tipstring
Format"date"

Cevaplar​

Faturalar listelendi

application/json
JSON
{
"success": true,
"message": "Faturalar listelendi",
"items": [
{
"id": 28,
"organizationId": 1,
"number": "ZEM2026000000009",
"dateAt": "2026-01-16T14:30:00.000Z",
"paymentExpirationAt": "2026-01-17T14:45:00.000Z",
"priceTry": 192.45,
"priceUsd": 12.83,
"firstName": "EFATURA",
"lastName": "EFATURA",
"citizenshipNumber": "string",
"company": "GOOGLE",
"taxNumber": "9971861566",
"isPaid": false,
"status": {
"id": 2,
"slug": "WAITING"
},
"addressType": {
"id": 3,
"slug": "CORPORATION"
},
"currencyCode": "USD"
}
],
"meta": {
"page": 1,
"perPage": 25,
"total": 3,
"pageCount": 1
}
}

Test​

Başlıklar
Değişkenler
Key
Değer

Örnekler​

cURL
JavaScript
PHP
Python