Ergani Web API
Ergani is the Greek Ministry of Labour's digital work-time platform. The Web API lets your software submit and retrieve labour declarations directly — instead of using the government's web forms or XML uploads.
Who this is for
You're integrating if you build or operate:
- a time-clock / attendance system, reporting employee check-ins and check-outs in real time (the Digital Work Card mechanism), or
- payroll or HR software, submitting employment changes, schedules, or hiring forms.
This documentation is built around the first case — the Digital Work Card — because it's the workflow most integrators need and the one with the clearest, most consistent API shape. If you need the other declaration types (schedules, hiring forms, leaves), see Other declaration types after finishing the Work Card path.
The recommended path
- Quickstart — authenticate and send your first check-in event. 5–10 minutes.
- Core Concepts — the mental model: events, reference dates, the submission lifecycle.
- Authentication — token lifecycle and refresh, for production use.
- Workflows — check-in, check-out, corrections, late submissions, bulk sends.
- Error Handling and Production Guide — before you go live.
Environments
| Environment | API base URL |
|---|---|
| Trial (δοκιμαστικό) | https://trialv2eservices.yeka.gr/WebservicesAPI/Api/ |
| Production (παραγωγικό) | https://eservices.yeka.gr/WebservicesAPI/Api/ |
Both environments use real e-ΕΦΚΑ credentials. Documents submitted in the trial environment are marked void (ΑΚΥΡΟ) and have no legal effect — this is where you test. Don't point your integration at production until you've verified the full flow in trial.
What's next
Start with the Quickstart.