API ελέγχου υποχρέωσης Ψηφιακής Κάρτας Εργασίας

Αυτόματος εντοπισμός

Το API δημοσιεύεται στον κατάλογο API του ιστοτόπου, σύμφωνα με το RFC 9727.

• Κατάλογος API (Linkset JSON)
• Περιγραφή OpenAPI 3.1

Έλεγχος υποχρέωσης

Το GET /api/check-obligation αναζητά τους δηλωμένους ΚΑΔ μιας επιχείρησης και τους ελέγχει σύμφωνα με τους ισχύοντες κανόνες της Ψηφιακής Κάρτας Εργασίας.

Παράμετροι ερωτήματος

• vat (υποχρεωτική): ελληνικός ΑΦΜ εννέα ψηφίων.

curl "https://jobcard.gr/api/check-obligation?vat=123456789"

Απόκριση

{
  "obliged": true,
  "match": {
    "activity_prefix": "61.90",
    "activity": {
      "code": "61900000",
      "description": "Τηλεπικοινωνίες",
      "kind": "1",
      "kind_description": "Κύρια δραστηριότητα"
    },
    "status": "pilot",
    "pilot_date": "2026-06-02",
    "full_date": "2026-10-12"
  }
}

Σε περίπτωση αποτυχίας επικύρωσης, επαλήθευσης, επικοινωνίας με την εξωτερική υπηρεσία ή σφάλματος διακομιστή, η απόκριση περιλαμβάνει επίσης το πεδίο error. Δείτε την περιγραφή OpenAPI για όλους τους κωδικούς απόκρισης και τα σχήματα δεδομένων.