---
title: "Listo faturat elektronike të blerjes"
operation_id: "api.v1.purchase-einvoices.list"
method: GET
path: "/api/v1/purchase-einvoices"
group: "Faturat elektronike të blerjes"
api_version: "v1"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v1-purchase-einvoices-list.html"
---

# Listo faturat elektronike të blerjes

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

## GET /api/v1/purchase-einvoices

Kthen faturat elektronike që furnitorët i kanë dërguar biznesit tuaj, të lexuara nga shërbimi i
faturave elektronike të CIS-it, secila me EIC-në dhe statusin. Ato me `canChangeStatus: true`
presin përgjigjen tuaj: pranojini me `POST /purchase-einvoices/{eic}/accept` ose refuzojini me
`POST /purchase-einvoices/{eic}/refuse`.

- Periudha përfshin të dyja ditët, nga ora 00:00:00 e `fromDate` deri në 23:59:59 të `toDate`,
  sipas datës kur CIS-i e mori faturën. Data që mungon merr ditën e sotme.
- CIS-i i kthen të gjitha faturat e periudhës në një përgjigje, prandaj lista nuk ka faqe.
  Për periudha të gjata kërkoni muaj pas muaji.
- Lista kthehet nga më e reja te më e vjetra.

URL-ja e plotë: `https://fature.al/api/v1/purchase-einvoices`

Versioni i API-t: `v1`.

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

### Parametrat query

| Fusha | Tipi | E detyrueshme | Përshkrimi |
| --- | --- | --- | --- |
| `status` | string | jo | Kthe vetëm faturat me këtë status: `DELIVERED`, `ACCEPTED`, `REFUSED`, `PAID`, `PARTIALLY_PAID` ose `OVERPAID`. |
| `fromDate` | string | jo | Data e fillimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme. |
| `toDate` | string | jo | Data e mbarimit, `YYYY-MM-DD`, e përfshirë. Pa të merret dita e sotme. |
| `eic` | string | jo | Kthe vetëm faturën me këtë EIC. |
| `sellerTin` | string | jo | Kthe vetëm faturat e furnitorit me këtë NIPT. |

### Shembull kërkese

```bash
curl -X GET 'https://fature.al/api/v1/purchase-einvoices' \
  -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**: Faturat elektronike të periudhës te `items`, me numrin e tyre te `count`.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.items` | array |  |
| `data.items[].eic` | string | Kodi identifikues i faturës elektronike, EIC. Me të pranohet ose refuzohet fatura |
| `data.items[].docNumber` | string | Numri i faturës siç e lëshoi furnitori |
| `data.items[].sellerTin` | string | NIPT-i i furnitorit |
| `data.items[].sellerName` | string, nullable | Emri i furnitorit, kur NIPT-i i tij është te klientët tuaj në fature.al; ndryshe `null` |
| `data.items[].buyerTin` | string | NIPT-i i blerësit, pra i biznesit tuaj |
| `data.items[].receivedAt` | string | Data dhe ora kur CIS-i e mori faturën: datë-orë ISO 8601 me zonën orare |
| `data.items[].dueDate` | string, nullable | Afati i pagesës, `YYYY-MM-DD`; `null` kur fatura nuk mban afat |
| `data.items[].status` | string | Statusi i faturës te CIS-i: `DELIVERED` (pret përgjigjen tuaj), `ACCEPTED`, `REFUSED`, `PAID`, `PARTIALLY_PAID` ose `OVERPAID` |
| `data.items[].canChangeStatus` | boolean | `true` kur statusi lejon ende pranimin ose refuzimin: `DELIVERED` ose `PARTIALLY_PAID` |
| `data.items[].amount` | number | Shuma totale e faturës, me TVSH, në monedhën e saj |
| `data.items[].currency` | string | Kodi ISO 4217 i monedhës së faturës |
| `data.count` | integer |  |

```json
{
    "status": true,
    "data": {
        "items": [
            {
                "eic": "3f6c2a1e-9b8d-4c7e-a5f4-2d1e0c9b8a76",
                "docNumber": "152/2026",
                "sellerTin": "K12345678A",
                "sellerName": "Furnizime Tirana shpk",
                "buyerTin": "L88776655B",
                "receivedAt": "2026-11-03T10:15:23+01:00",
                "dueDate": "2026-12-03",
                "status": "DELIVERED",
                "canChangeStatus": true,
                "amount": 24000,
                "currency": "ALL"
            }
        ],
        "count": 3
    }
}
```

**401**: Token-i mungon ose nuk është i vlefshëm, ose biznesi nuk lëshon fatura.

| 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"
    ]
}
```

**403**: Përdoruesi nuk ka të drejtën e faturave elektronike të blerjes.

| 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"
    ]
}
```

**422**: Datat nuk janë në formatin `YYYY-MM-DD`, ose `status` nuk është një nga vlerat e lejuara.

| 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"
    ]
}
```

**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"
    ]
}
```

**502**: CIS-i u përgjigj me një gabim; arsyeja është te `message`.

| 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"
    ]
}
```

**503**: Shërbimi i faturave elektronike nuk u arrit. Riprovoni më vonë. `message` vjen bosh; arsyeja është te `errors`.

| 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"
    ]
}
```