Skip to main content

Your First Request

After obtaining your API key, you're ready to make your first request!

List Departments

The simplest way to test your API key is to list available departments:

curl -X GET https://mc-prd.duckdns.org/api/v1/departments -H "X-API-Key: YOUR_API_KEY"

Response:

[
{
"id": 5,
"name": "Passport Service",
"description": "Passport issuance",
"organization": {
"id": 1,
"name": "Ministry of Interior"
}
}
]

Create an Appointment

Now, let's create an appointment:

curl -X POST https://mc-prd.duckdns.org/api/v1/appointments -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"departmentId": 5,
"dateTime": "2026-01-25T14:30:00",
"name": "Jean Dupont"
}'

Get an Appointment

curl -X GET https://mc-prd.duckdns.org/api/v1/appointments/12345 -H "X-API-Key: YOUR_API_KEY"

Next Steps