ZEMLOG

English

Türkçe

English

Türkçe

Appearance

Invoice List​

GET
/api/v1/finance/invoices

Lists your organization's invoices with pagination.

Parameters​

Header Parameters

Authorization*

Token returned by the Get Token request, with the Bearer prefix

Typestring
Required
Example"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.signature"
Accept-Language

Language of the name fields in the response (country, unit of measure, status and package additional fee names) and of validation messages. English when it starts with en (e.g. en, en-US), Turkish otherwise. Success, business rule, authorization and 503 messages are always in Turkish.

Typestring
Examples
"tr"
"en"
Default"tr"

Query Parameters

page

Page number

Typeinteger
Minimum1
Default1
perPage

Records per page

Typeinteger
Minimum1
Maximum200
Default25
sortBy

Sort field

Typestring
Valid values
"id""number""dateAt""paymentExpirationAt""priceTry""priceUsd"
Default"id"
sortOrder

Sort direction

Typestring
Valid values
"asc""desc"
Default"desc"
search

With a single value, invoices whose ID equals it or whose number contains it are returned. With comma-separated values, each one exactly matches the ID or number.

Typestring
Example"ZEM2026"
Min Length1
Max Length255
id

Invoice ID

Typeinteger
Minimum1
number

Invoice number (exact match)

Typestring
Example"ZEM2026000000009"
Min Length1
Max Length16
statusId

Invoice status. 1 = NEW, 2 = WAITING, 3 = COMPLETED.

Typeinteger
Valid values
123
isPaid

true returns paid, false returns unpaid invoices (1 / 0 are also accepted)

Typeboolean
dateFrom

Invoice date start (YYYY-MM-DD, inclusive)

Typestring
Example"2026-01-01"
Format"date"
dateTo

Invoice date end (YYYY-MM-DD, inclusive)

Typestring
Example"2026-01-31"
Format"date"
paymentExpirationFrom

Payment due date start (YYYY-MM-DD, inclusive)

Typestring
Format"date"
paymentExpirationTo

Payment due date end (YYYY-MM-DD, inclusive)

Typestring
Format"date"

Responses​

Invoices listed

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
}
}

Playground​

Headers
Variables
Key
Value

Samples​

cURL
JavaScript
PHP
Python