Δικαιούμενες ποσότητες ενός έτους

GET

/diesel/entitlements

Δίνεται το έτος και ένα από τα δύο: afterChangeNo ή modifiedFrom.

Ενέργεια	Κλήση
Αρχική φόρτωση	`afterChangeNo=0`, ξανά και ξανά όσο `hasMore = true`
Καθημερινή ενημέρωση	`afterChangeNo=` ο τελευταίος `lastChangeNo` που κράτησα
Εβδομαδιαία επαλήθευση	`afterChangeNo=0` και σύγκριση ένα προς ένα με τα δικά μου
Έλεγχο με ημερομηνίες	`modifiedFrom` και προαιρετικά `modifiedTo`

Οι εγγραφές έρχονται πάντα σε αύξουσα σειρά changeNo, μία ανά ΑΦΜ, με την τρέχουσα τιμή.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://auth.example.gov.gr/oauth2/token

Query Params

Responses

🟢200

application/json

Επιτυχία, ακόμη και με κενό data

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500InternalError

🔴503ServiceUnavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location '/diesel/entitlements?year=&afterChangeNo=&modifiedFrom=&modifiedTo=&limit='

Response Example

200 - Πλήρης εικόνα (afterChangeNo=0), πρώτο κομμάτι

{
    "requestId": "b7c1f0e2-3a4d-4e5b-9c8a-1d2e3f4a5b6c",
    "generatedAt": "2026-09-17T07:00:03Z",
    "year": 2026,
    "lastChangeNo": 5212,
    "hasMore": true,
    "data": [
        {
            "taxId": "111111111",
            "year": 2026,
            "litres": 1630.2,
            "changeNo": 1,
            "changedAt": "2026-03-02T23:10:00Z"
        },
        {
            "taxId": "222222222",
            "year": 2026,
            "litres": 6340.8,
            "changeNo": 2,
            "changedAt": "2026-03-02T23:10:00Z"
        }
    ]
}

Modified at 2026-09-17 22:05:29

TaxId