Availability
Free slots the agent can offer.
Get availability
GET/availabilities
Free slots of one doctor, or of every doctor of a specialty, over a range of days.
Query parameters
Prop
Type
Response: 200
Prop
Type
Example request
GET {baseUrl}/availabilities?dateFrom=16/02/2026&dateTo=20/02/2026&specialityId=1&insuranceId=23507325¢erId=1
Accept: application/json
X-Signature: 5f2b9c…Example response
{
"data": [
{
"doctorId": "24895",
"doctorName": "Dr. Juan Pérez",
"availability": [
{
"date": "16/02/2026",
"times": [
{
"time": "16:00"
},
{
"time": "17:00",
"note": "Children only"
}
]
},
{
"date": "18/02/2026",
"times": [
{
"time": "09:30"
}
]
}
]
},
{
"doctorId": "24896",
"doctorName": "Dra. María Gómez",
"availability": [
{
"date": "17/02/2026",
"times": [
{
"time": "11:00"
},
{
"time": "11:30"
}
]
}
]
}
]
}How to answer
- You own the agendas. Ovianta never sends an agenda id. From the doctor or specialty, the insurance and the center, pick the agendas yourself.
- One entry per doctor. When Ovianta searches by specialty, return one entry for each doctor with free slots, merging that doctor's agendas.
- Respect
insuranceIdandcenterId. Return only slots the patient can book: with a doctor who accepts their insurance, at the center asked for. - Use
notefor restrictions the agent must respect, such as "Children only". The agent reads it before offering the slot. - Ovianta always sends
dateTo. It asks for about 30 days when searching one doctor and about 15 days when searching a specialty.