fature.al është platforma e faturimit dhe fiskalizimit për bizneset në Shqipëri. Hap një llogari
Skip to content
fature.al API Menu

Listo faturat

GET /api/v2/invoice Requires authentication Rate limited by the `api-global` limiter v2

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

E njëjta listë si te v1, ku çdo faturë mban payment_methods në vend të payment_method. Filtrat dhe pagination janë ata të GET /api/v1/invoice.

URL-ja e plotë: https://fature.al/api/v2/invoice

Ndryshuar që nga v1:

What changed v1 v2
query limit integer, optional —
query offset integer, optional —
query type string, optional —
query fromDate string, optional —
query toDate string, optional —
query query string, optional —
200 data.items[].payment_method string, nullable —
200 data.items[].payment_methods — array
200 data.items[].payment_methods[].type — string
200 data.items[].payment_methods[].amount — number
200 data.items[].payment_methods[].company_card — any
200 data.items[].payment_methods[].vouchers — any
422 documented not documented
429 documented not documented
500 documented not documented

Përgjigjet

200 Faturat e periudhës te `items`, nga më e reja te më e vjetra, me `pagination`; `items` është bosh kur nuk ka fatura.

Field Tipi Përshkrimi
status boolean
data object
data.items array
data.items[].id integer Id-ja e faturës në fature.al
data.items[].number string, nullable Numri i faturës, si `12/2026`
data.items[].type string Lloji i faturës: `CASH`, `NONCASH` ose `EINVOICE`
data.items[].issue_date string Data e lëshimit, `YYYY-MM-DD`
data.items[].due_date string Afati i pagesës, `YYYY-MM-DD`
data.items[].delivery_date string Data e dorëzimit, ose fundi i periudhës së furnizimit, `YYYY-MM-DD`
data.items[].created_at string, nullable Data dhe ora e krijimit, `YYYY-MM-DD HH:MM:SS`, ora lokale
data.items[].supply_start_date string, nullable Fillimi i periudhës së furnizimit, `YYYY-MM-DD`
data.items[].supply_end_date string, nullable Fundi i periudhës së furnizimit, `YYYY-MM-DD`
data.items[].client object Blerësi i faturës
data.items[].client.name string Emri i plotë i personit ose emri i kompanisë
data.items[].client.id object Identifikuesi fiskal i blerësit
data.items[].client.address object Adresa e blerësit
data.items[].amount object Shumat e faturës, në monedhën e saj dhe në lekë
data.items[].amount.currency string Monedha e faturës, ISO 4217
data.items[].amount.exchange_rate any Kursi i këmbimit ndaj lekut; null kur fatura është tashmë në lek
data.items[].amount.gross number Totali me TVSH, pasi është hequr zbritja mbi faturën
data.items[].amount.net number Totali pa TVSH, pasi është hequr zbritja mbi faturën
data.items[].amount.vat number TVSH-ja gjithsej
data.items[].amount.discount number Zbritja mbi të gjithë faturën, si shumë pa TVSH: sa u hoq nga vlera pa TVSH e faturës. Zbritjet e rreshtave nuk janë këtu; ato janë te `lines[].discount`. Zero kur fatura nuk ka zbritje mbi faturën
data.items[].amount.net_all number Totali pa TVSH në lek
data.items[].amount.gross_all number Totali me TVSH në lek
data.items[].amount.vat_all number TVSH-ja në lek
data.items[].amount.discount_all number Zbritja mbi faturën në lek
data.items[].amount.local_currency any I pranishëm vetëm në një faturë në monedhë të huaj
data.items[].payment object Sa është shlyer nga fatura
data.items[].payment.state string `PAID`, `PARTIALLY_PAID` ose `UNPAID`
data.items[].payment.amount_paid number Shuma e arkëtuar deri tani, në monedhën e faturës
data.items[].payment.amount_left number Totali me TVSH minus shumën e arkëtuar, në monedhën e faturës
data.items[].bank_account object, nullable Llogaria bankare e shtypur në faturë, ose `null`
data.items[].bank_account.id any Id-ja e llogarisë bankare në fature.al
data.items[].bank_account.bank_name any Emri i bankës
data.items[].bank_account.iban any IBAN-i i llogarisë
data.items[].bank_account.swift any Kodi SWIFT i bankës
data.items[].bank_account.currency any Monedha e llogarisë, ISO 4217
data.items[].bank_account.notes any Shënime të lira mbi llogarinë
data.items[].notes string, nullable Shënimet që dalin në faturë
data.items[].iic string, nullable Kodi identifikues i faturës (IIC, në ligj NSLF)
data.items[].fic string, nullable Kodi që ktheu CIS-i kur e regjistroi faturën (FIC, në ligj NIVF). `null` sa kohë fatura pret fiskalizimin
data.items[].eic string, nullable Kodi i faturës në platformën e e-faturave. Vetëm te e-faturat
data.items[].doc_type string, nullable Lloji i dokumentit në UBL: `380` faturë, `381` notë krediti, `383` notë debiti. `null` te një faturë e zakonshme fiskale
data.items[].process string, nullable Profili UBL: `P1` për një shitje, `P9` për një korrigjim. Vendoset te e-faturat
data.items[].self_issue_type string, nullable Lloji i vetëfaturimit, kur fatura është vetëfaturim
data.items[].reversed_at string, nullable Kur u anulua fatura, `YYYY-MM-DD HH:MM:SS`, ose `null`
data.items[].reversed_by integer, nullable Id-ja e faturës që kjo faturë anulon, ose `null`
data.items[].pdf_url string URL-ja për të shkarkuar PDF-në e faturës
data.items[].reverse_charge boolean Ngarkesë e kundërt: TVSH-në e deklaron blerësi
data.items[].periodic_invoice boolean Faturë e një cikli të përsëritur faturimi
data.items[].payment_methods array Një element për çdo mënyrë pagese, me shumën që u shlye me secilën. Një faturë e paguar me një mënyrë të vetme mban një element me të gjithë shumën
data.items[].payment_methods[].type string Mënyra e pagesës, p.sh. `BANKNOTE` ose `CARD`
data.items[].payment_methods[].amount number Shuma e shlyer me këtë mënyrë, me TVSH, në monedhën e faturës
data.items[].payment_methods[].company_card any Numri i kartës së kompanisë; i plotësuar vetëm kur `type` është `COMPANY`, përndryshe null
data.items[].payment_methods[].vouchers any Numrat serialë të tollonave; të plotësuar vetëm kur `type` është `SVOUCHER`, përndryshe listë bosh
data.pagination object
data.pagination.records integer Sa fatura mban `items` në këtë faqe
data.pagination.limit integer Parametri `limit` i kërkesës, pas rrumbullakimit në të paktën 1
data.pagination.offset integer Parametri `offset` i kërkesës, pas rrumbullakimit në të paktën 0
data.pagination.type string, nullable Filtri `type` ashtu siç u dërgua, `null` kur nuk u dërgua
data.pagination.query string, nullable Filtri `query` ashtu siç u dërgua, `null` kur nuk u dërgua

401 Unauthenticated

Field Tipi Përshkrimi
message string

Shembull kërkese

cURL 
curl -X GET 'https://fature.al/api/v2/invoice' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
PHP (Laravel) 
use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/v2/invoice');

$data = $response->json();
PHP (Guzzle) 
use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v2/invoice', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode((string) $response->getBody(), true);
JavaScript 
const response = await fetch('https://fature.al/api/v2/invoice', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Shembull përgjigjeje

200 
{
    "status": true,
    "data": {
        "items": [
            {
                "id": 40323,
                "number": "12/2026",
                "type": "EINVOICE",
                "issue_date": "2026-09-13",
                "due_date": "2026-09-27",
                "delivery_date": "2026-09-13",
                "created_at": "2026-09-13 10:15:00",
                "supply_start_date": "2026-09-01",
                "supply_end_date": "2026-09-13",
                "client": {
                    "name": "Alba Trade shpk",
                    "id": [],
                    "address": []
                },
                "amount": {
                    "currency": "EUR",
                    "exchange_rate": 98.5,
                    "gross": 540,
                    "net": 450,
                    "vat": 90,
                    "discount": 0,
                    "net_all": 44325,
                    "gross_all": 53190,
                    "vat_all": 8865,
                    "discount_all": 0,
                    "local_currency": "USD"
                },
                "payment": {
                    "state": "PARTIALLY_PAID",
                    "amount_paid": 300,
                    "amount_left": 240
                },
                "bank_account": {
                    "id": 27,
                    "bank_name": "Banka Kombëtare Tregtare",
                    "iban": "AL47212110090000000235698741",
                    "swift": "NCBAALTX",
                    "currency": "EUR",
                    "notes": "Llogaria në euro"
                },
                "notes": "Pagesa brenda 14 ditëve.",
                "iic": "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35",
                "fic": "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91",
                "eic": "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65",
                "doc_type": 380,
                "process": "P1",
                "self_issue_type": "DOMESTIC",
                "reversed_at": "2026-09-14 08:05:00",
                "reversed_by": 40311,
                "pdf_url": "https://fature.al/api/v1/invoice/print/40323",
                "reverse_charge": false,
                "periodic_invoice": false,
                "payment_methods": [
                    {
                        "type": "ACCOUNT",
                        "amount": 540,
                        "company_card": "company card",
                        "vouchers": []
                    }
                ]
            }
        ],
        "pagination": {
            "records": 10,
            "limit": 10,
            "offset": 0,
            "type": "CASH,NONCASH",
            "query": "K12345AB"
        }
    }
}
401 
{
    "message": "Unauthenticated."
}

Regjistrimi është falas.

Regjistrohu në fature.al

This page as Markdown, or the whole API as OpenAPI.