---
title: "Lista e faturave te blerjes"
operation_id: "api.v1.purchase-invoices.list"
method: GET
path: "/api/v1/purchase-invoices"
group: "Faturat e blerjes"
api_version: "v1"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v1-purchase-invoices-list.html"
---

# Lista e faturave te blerjes

Part of the [fature.al API](/api-reference/index.html) documentation.

## GET /api/v1/purchase-invoices

Merrni faturat qe furnitoret ju kane leshuar juve, ashtu sic i ka regjistruar sistemi fiskal.
Furnitori nuk ju dergon gje: dokumentet vijne nga tatimet.

Per cdo fature terhiqen te dhenat e plota: artikujt, shitesi, bleresi, TVSH-ja dhe menyrat e
pageses. Kjo e ben rakordimin e blerjeve dhe te TVSH-se te mundur pa asnje hap manual.

## Faqezimi

Ky endpoint lexon nga fiskalizimi, jo nga baza jone, prandaj faqezohet me `page` qe fillon nga
`1` dhe jo me `limit` me `offset`. Perseritni me `page + 1` derisa `items` te kthehet bosh.

Pa `fromDate` dhe `toDate` merret dita e sotme, jo e gjithe historia.

Full URL: `https://fature.al/api/v1/purchase-invoices`

API version: `v1`.

Authentication: required (bearer token).

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `fromDate` | string | no | Data e fillimit (YYYY-MM-DD). Pa te merret sot. |
| `toDate` | string | no | Data e perfundimit (YYYY-MM-DD). Pa te merret sot. |
| `fic` | string | no | Filtro sipas FIC per nje fature te vetme. |
| `page` | integer | no | Faqja e listes nga fiskalizimi. Perserit me page+1 derisa items te kthehet bosh. Defaults to `1`. |

### Example request

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

### Responses

**200** — OK

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.items` | array |  |
| `data.items[].iic` | string |  |
| `data.items[].fic` | string |  |
| `data.items[].invoiceNumber` | string |  |
| `data.items[].invoiceOrderNumber` | integer |  |
| `data.items[].dateTimeCreated` | string |  |
| `data.items[].payDeadline` | string, nullable |  |
| `data.items[].invoiceType` | string |  |
| `data.items[].issuerTaxNumber` | string |  |
| `data.items[].seller` | object |  |
| `data.items[].seller.idType` | string |  |
| `data.items[].seller.idNum` | string |  |
| `data.items[].seller.name` | string |  |
| `data.items[].seller.address` | string, nullable |  |
| `data.items[].seller.town` | string, nullable |  |
| `data.items[].seller.country` | string, nullable |  |
| `data.items[].buyer` | object |  |
| `data.items[].buyer.idType` | string |  |
| `data.items[].buyer.idNum` | string |  |
| `data.items[].buyer.name` | string |  |
| `data.items[].buyer.address` | string, nullable |  |
| `data.items[].buyer.town` | string, nullable |  |
| `data.items[].buyer.country` | string, nullable |  |
| `data.items[].items` | array |  |
| `data.items[].items[].name` | string |  |
| `data.items[].items[].code` | string, nullable |  |
| `data.items[].items[].unit` | string, nullable |  |
| `data.items[].items[].quantity` | number |  |
| `data.items[].items[].unitPriceAfterVat` | number |  |
| `data.items[].items[].priceAfterVat` | number |  |
| `data.items[].items[].vatAmount` | number |  |
| `data.items[].items[].vatRate` | number, nullable |  |
| `data.items[].items[].exemptFromVat` | string, nullable |  |
| `data.items[].paymentMethod` | array |  |
| `data.items[].paymentMethod[].typeCode` | string |  |
| `data.items[].paymentMethod[].compCard` | string, nullable |  |
| `data.items[].currency` | object, nullable |  |
| `data.items[].currency.code` | string |  |
| `data.items[].currency.exchangeRate` | number |  |
| `data.items[].totalPrice` | number |  |
| `data.items[].totalPriceWithoutVAT` | number |  |
| `data.items[].reverseCharge` | boolean |  |
| `data.items[].businessUnit` | string, nullable |  |
| `data.items[].operatorCode` | string, nullable |  |
| `data.items[].tcrCode` | string, nullable |  |
| `data.items[].softwareCode` | string, nullable |  |
| `data.items[].iicSignature` | string, nullable |  |
| `data.pagination` | object |  |
| `data.pagination.records` | integer |  |
| `data.pagination.page` | integer |  |

```json
{
    "status": true,
    "data": {
        "items": [
            {
                "iic": "iic",
                "fic": "fic",
                "invoiceNumber": "invoiceNumber",
                "invoiceOrderNumber": 1,
                "dateTimeCreated": "dateTimeCreated",
                "payDeadline": "payDeadline",
                "invoiceType": "invoiceType",
                "issuerTaxNumber": "issuerTaxNumber",
                "seller": {
                    "idType": "idType",
                    "idNum": "idNum",
                    "name": "Jane Doe",
                    "address": "1 Example Street",
                    "town": "town",
                    "country": "US"
                },
                "buyer": {
                    "idType": "idType",
                    "idNum": "idNum",
                    "name": "Jane Doe",
                    "address": "1 Example Street",
                    "town": "town",
                    "country": "US"
                },
                "items": [
                    {
                        "name": "Jane Doe",
                        "code": "code",
                        "unit": "unit",
                        "quantity": 2,
                        "unitPriceAfterVat": 1999,
                        "priceAfterVat": 1999,
                        "vatAmount": 4200,
                        "vatRate": 19.99,
                        "exemptFromVat": "exemptFromVat"
                    }
                ],
                "paymentMethod": [
                    {
                        "typeCode": "typeCode",
                        "compCard": "compCard"
                    }
                ],
                "currency": {
                    "code": "code",
                    "exchangeRate": 19.99
                },
                "totalPrice": 4200,
                "totalPriceWithoutVAT": 4200,
                "reverseCharge": true,
                "businessUnit": "businessUnit",
                "operatorCode": "operatorCode",
                "tcrCode": "tcrCode",
                "softwareCode": "softwareCode",
                "iicSignature": "iicSignature"
            }
        ],
        "pagination": {
            "records": 1,
            "page": 1
        }
    }
}
```

**422** — Formati i datave nuk eshte YYYY-MM-DD.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```

**500** — Gabim i papritur ne server.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```

**502** — Fiskalizimi u pergjigj me nje gabim.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```

**503** — Sherbimi i fiskalizimit eshte i paarritshem.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```