---
title: "Merr një faturë sipas id"
operation_id: "api.v1.invoice.details"
method: GET
path: "/api/v1/invoice/{id}/details"
group: "Faturat"
api_version: "v1"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v1-invoice-details.html"
---

# Merr një faturë sipas id

Pjesë e dokumentacionit [fature.al API](/api-reference/index.html).

## GET /api/v1/invoice/{id}/details

Kthen faturën e plotë sipas `id`-së së saj në fature.al: blerësin, shumat, pagesën, kodet
fiskale dhe rreshtat.

Kur fatura nuk gjendet, ose nuk i përket kompanisë suaj, `data.invoice` është `null` me
statusin `200`. Për ta gjetur me numrin tuaj përdorni `POST /invoice/details/{internalId}`.

URL-ja e plotë: `https://fature.al/api/v1/invoice/{id}/details`

Versioni i API-t: `v1`.

Identifikimi: i detyrueshëm (bearer token, plus the `X-Client-Id` and `X-Client-Secret` headers).

### Parametrat në path

| Fusha | Tipi | E detyrueshme | Përshkrimi |
| --- | --- | --- | --- |
| `id` | integer | po | Id-ja e faturës në fature.al. |

### Shembull kërkese

```bash
curl -X GET 'https://fature.al/api/v1/invoice/403/details' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
```

### Përgjigjet

**200**: Fatura e plotë te `data.invoice`, ose `null` kur nuk gjendet.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.invoice` | object, nullable |  |
| `data.invoice.id` | integer | Id-ja e faturës në fature.al |
| `data.invoice.number` | string, nullable | Numri i faturës, si `12/2026` |
| `data.invoice.type` | string | Lloji i faturës: `CASH`, `NONCASH` ose `EINVOICE` |
| `data.invoice.issue_date` | string | Data e lëshimit, `YYYY-MM-DD` |
| `data.invoice.due_date` | string | Afati i pagesës, `YYYY-MM-DD` |
| `data.invoice.delivery_date` | string | Data e dorëzimit, ose fundi i periudhës së furnizimit, `YYYY-MM-DD` |
| `data.invoice.created_at` | string, nullable | Data dhe ora e krijimit, `YYYY-MM-DD HH:MM:SS`, ora lokale |
| `data.invoice.supply_start_date` | string, nullable | Fillimi i periudhës së furnizimit, `YYYY-MM-DD` |
| `data.invoice.supply_end_date` | string, nullable | Fundi i periudhës së furnizimit, `YYYY-MM-DD` |
| `data.invoice.client` | object | Blerësi i faturës |
| `data.invoice.client.name` | string | Emri i plotë i personit ose emri i kompanisë |
| `data.invoice.client.id` | object | Identifikuesi fiskal i blerësit |
| `data.invoice.client.address` | object | Adresa e blerësit |
| `data.invoice.amount` | object | Shumat e faturës, në monedhën e saj dhe në lekë |
| `data.invoice.amount.currency` | string | Monedha e faturës, ISO 4217 |
| `data.invoice.amount.exchange_rate` | any | Kursi i këmbimit ndaj lekut; null kur fatura është tashmë në lek |
| `data.invoice.amount.gross` | number | Totali me TVSH, pasi është hequr zbritja mbi faturën |
| `data.invoice.amount.net` | number | Totali pa TVSH, pasi është hequr zbritja mbi faturën |
| `data.invoice.amount.vat` | number | TVSH-ja gjithsej |
| `data.invoice.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.invoice.amount.net_all` | number | Totali pa TVSH në lek |
| `data.invoice.amount.gross_all` | number | Totali me TVSH në lek |
| `data.invoice.amount.vat_all` | number | TVSH-ja në lek |
| `data.invoice.amount.discount_all` | number | Zbritja mbi faturën në lek |
| `data.invoice.amount.local_currency` | any | I pranishëm vetëm në një faturë në monedhë të huaj |
| `data.invoice.payment` | object | Sa është shlyer nga fatura |
| `data.invoice.payment.state` | string | `PAID`, `PARTIALLY_PAID` ose `UNPAID` |
| `data.invoice.payment.amount_paid` | number | Shuma e arkëtuar deri tani, në monedhën e faturës |
| `data.invoice.payment.amount_left` | number | Totali me TVSH minus shumën e arkëtuar, në monedhën e faturës |
| `data.invoice.bank_account` | object, nullable | Llogaria bankare e shtypur në faturë, ose `null` |
| `data.invoice.bank_account.id` | any | Id-ja e llogarisë bankare në fature.al |
| `data.invoice.bank_account.bank_name` | any | Emri i bankës |
| `data.invoice.bank_account.iban` | any | IBAN-i i llogarisë |
| `data.invoice.bank_account.swift` | any | Kodi SWIFT i bankës |
| `data.invoice.bank_account.currency` | any | Monedha e llogarisë, ISO 4217 |
| `data.invoice.bank_account.notes` | any | Shënime të lira mbi llogarinë |
| `data.invoice.notes` | string, nullable | Shënimet që dalin në faturë |
| `data.invoice.iic` | string, nullable | Kodi identifikues i faturës (IIC, në ligj NSLF) |
| `data.invoice.fic` | string, nullable | Kodi që ktheu CIS-i kur e regjistroi faturën (FIC, në ligj NIVF). `null` sa kohë fatura pret fiskalizimin |
| `data.invoice.eic` | string, nullable | Kodi i faturës në platformën e e-faturave. Vetëm te e-faturat |
| `data.invoice.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.invoice.process` | string, nullable | Profili UBL: `P1` për një shitje, `P9` për një korrigjim. Vendoset te e-faturat |
| `data.invoice.self_issue_type` | string, nullable | Lloji i vetëfaturimit, kur fatura është vetëfaturim |
| `data.invoice.reversed_at` | string, nullable | Kur u anulua fatura, `YYYY-MM-DD HH:MM:SS`, ose `null` |
| `data.invoice.reversed_by` | integer, nullable | Id-ja e faturës që kjo faturë anulon, ose `null` |
| `data.invoice.pdf_url` | string | URL-ja për të shkarkuar PDF-në e faturës |
| `data.invoice.reverse_charge` | boolean | Ngarkesë e kundërt: TVSH-në e deklaron blerësi |
| `data.invoice.periodic_invoice` | boolean | Faturë e një cikli të përsëritur faturimi |
| `data.invoice.payment_method` | string, nullable | Mënyra e pagesës me të cilën u shlye fatura; te një pagesë e ndarë, ajo me pjesën më të madhe |
| `data.invoice.lines` | array | Rreshtat e faturës; ngarkohen vetëm kur lexohet një faturë e vetme |
| `data.invoice.lines[].name` | string | Emri i produktit ose i shërbimit |
| `data.invoice.lines[].product_code` | string, nullable | Kodi i produktit në fature.al, kur rreshti i përket një produkti të katalogut |
| `data.invoice.lines[].unit` | string, nullable | Njësia matëse |
| `data.invoice.lines[].unit_code` | string, nullable | Kodi i njësisë matëse, p.sh. `C62` |
| `data.invoice.lines[].quantity` | number | Sasia |
| `data.invoice.lines[].unitPrice` | number | Çmimi për njësi me TVSH, pasi është hequr zbritja e rreshtit |
| `data.invoice.lines[].vat_rate` | number, nullable | Norma e TVSH-së në përqind |
| `data.invoice.lines[].vat_exempt_type` | string, nullable | Tipi i përjashtimit nga TVSH-ja, kur rreshti është i përjashtuar |
| `data.invoice.lines[].discount_rate` | number, nullable | Zbritja e rreshtit në përqind, siç u dërgua te `lines[].discount`; null kur rreshti nuk ka zbritje |
| `data.invoice.lines[].discount` | number, nullable | Shuma e zbritjes së rreshtit, pa TVSH |
| `data.invoice.lines[].amount_net` | number | Vlera e rreshtit pa TVSH |
| `data.invoice.lines[].amount_vat` | number | TVSH-ja e rreshtit |
| `data.invoice.lines[].total` | number | Totali i rreshtit me TVSH |

```json
{
    "status": true,
    "data": {
        "invoice": {
            "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_method": "ACCOUNT",
            "lines": [
                {
                    "name": "Orë pune mirëmbajtje",
                    "product_code": "SRV-MNT",
                    "unit": "Orë",
                    "unit_code": "HUR",
                    "quantity": 2,
                    "unitPrice": 270,
                    "vat_rate": 20,
                    "vat_exempt_type": "TYPE_1",
                    "discount_rate": 10,
                    "discount": 50,
                    "amount_net": 450,
                    "amount_vat": 90,
                    "total": 540
                }
            ]
        }
    }
}
```

**401**: Unauthenticated

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `message` | string |  |

```json
{
    "message": "Unauthenticated."
}
```

**429**: Kufiri i kërkesave u arrit. Nga kufiri i përgjithshëm përgjigja mban vetëm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard të gabimit.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean | Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data` |
| `message` | string | Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin |
| `errors` | array | Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message` |

```json
{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}
```

**500**: Gabim i papritur në server.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean | Gjithmonë false. Një përgjigje e suksesshme mban `status: true` dhe objektin `data` |
| `message` | string | Përshkrimi i gabimit. Bosh kur dështimi nuk mban ndonjë mesazh të vetin |
| `errors` | array | Mesazhe për t'u shfaqur te përdoruesi ose për t'u ruajtur në log. Mungon kur nuk ka gjë për të shtuar përtej `message` |

```json
{
    "status": false,
    "message": "Te dhenat jo te sakta.",
    "errors": [
        "errors"
    ]
}
```