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​