---
title: "Merr gjendjen e arkës"
operation_id: "api.v2.cash-register.balance"
method: GET
path: "/api/v2/cash-register/balance"
group: "Arka fiskale"
api_version: "v2"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v2-cash-register-balance.html"
---

# Merr gjendjen e arkës

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

## GET /api/v2/cash-register/balance

Kthen gjendjen e pajisjes fiskale (TCR) të përdoruesit të token-it, në ALL, bashkë me kodin e
saj `fiscal_tcr_code`.

Pa `toDate` kthehet gjendja e tanishme. Me `toDate` kthehet gjendja në fund të asaj dite, për
rakordim me një ditë të shkuar. Gjendja ruhet në cache për 5 sekonda, ndaj një veprim i sapo
regjistruar mund të duket pas pak.

- Përdoruesi duhet të ketë një TCR.

URL-ja e plotë: `https://fature.al/api/v2/cash-register/balance`

Versioni i API-t: `v2`.

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

### Parametrat query

| Fusha | Tipi | E detyrueshme | Përshkrimi |
| --- | --- | --- | --- |
| `toDate` | string<date>, nullable | jo | Data, `YYYY-MM-DD`, deri te e cila llogaritet gjendja e arkës. Pa të kthehet gjendja e fundit. |

### Shembull kërkese

```bash
curl -X GET 'https://fature.al/api/v2/cash-register/balance' \
  -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**: Kur përdoruesi nuk ka pajisje fiskale, përgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja është te `message`.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.fiscal_tcr_code` | string | Kodi i pajisjes fiskale (TCR) të përdoruesit të token-it, ajo për të cilën u llogarit gjendja |
| `data.currency` | string | Kodi ISO 4217 i monedhës së gjendjes; gjithmonë `ALL` |
| `data.to_date` | string, nullable | Parametri `toDate` i kërkesës ashtu siç u dërgua, `YYYY-MM-DD`: gjendja është ajo në fund të kësaj dite, me çdo veprim dhe faturë të regjistruar deri në orën 23:59:59. `null` kur nuk u dërgua dhe gjendja është e tanishmja |
| `data.balance` | number | Gjendja, në lekë, me dy shifra pas presjes: hyrjet minus daljet e regjistruara në këtë TCR plus faturat cash të lëshuara prej saj, ku vetëfaturimet zbriten dhe faturat porosi nuk hyjnë |

```json
{
    "status": true,
    "data": {
        "fiscal_tcr_code": "pp556gh743",
        "currency": "ALL",
        "to_date": "2026-09-14",
        "balance": 23450.5
    }
}
```

**401**: Unauthenticated

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

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

**422**: Të dhënat nuk kaluan validimin. Kjo përgjigje përdor fushën `success`, jo `status`, dhe `errors` është objekt sipas fushës.

| Fusha | Tipi | Përshkrimi |
| --- | --- | --- |
| `success` | boolean | Gjithmonë false |
| `message` | string | Një rresht përmbledhës, i njëjtë për çdo dështim validimi |
| `errors` | object | Fushat që nuk kaluan validimin, secila me mesazhet e veta. Çelësat me pikë tregojnë brenda objekteve dhe elementëve të array-ve, p.sh. `lines.0.quantity` |

```json
{
    "success": false,
    "message": "Te dhena jo te sakta",
    "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"
    ]
}
```