Λήψη δικαιούμενων ποσοτήτων ενός έτους (πλήρης εικόνα ή μεταβολές)

GET

/diesel/entitlements

Δίνεται ακριβώς ένα από τα afterChangeNo και modifiedFrom.

Χρήση	Κλήση
Αρχική φόρτωση	`afterChangeNo=0`, επανάληψη έως `hasMore = false`
Καθημερινή ενημέρωση	`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 18:47:50

TaxId