Doctors

Retrieve the list of active practitioners registered at a clinic.

The doctors endpoint returns the active medical staff for the clinic associated with your API credentials. No clinic identifier is required in the URL — the API resolves it from your access token automatically.

The Doctor object

Field	Type	Description
`name`	string	Full display name of the practitioner (first name + last name).
`profileImage`	string	Public URL of the practitioner's profile photo. May be `null` if no photo has been uploaded.

List doctors

GET /api/v1/equipe/doctors

Returns all active practitioners for the clinic. The response is a plain JSON array, ordered by the clinic's internal display order.

Request

No query parameters. No request body. Authentication via Bearer token is required.

cURL

curl https://api.nextgen.arzamed.com/api/v1/equipe/doctors \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

JSON · 200 OK

[
  {
    "name": "Dr. Marco Bianchi",
    "profileImage": "https://assets.arzamed.com/photos/a1b2c3.jpg"
  },
  {
    "name": "Dr. Sofia Ricci",
    "profileImage": null
  },
  {
    "name": "Dr. Luca Ferrari",
    "profileImage": "https://assets.arzamed.com/photos/g7h8i9.jpg"
  }
]

Error responses

Status	Cause
`401`	Missing or invalid `Authorization` header, or the token has expired.
`403`	The API key has been revoked, the key's expiry date has passed, or the key is not registered in the system.
`503`	The upstream service is temporarily unavailable. Retry with exponential back-off.

Notes

Only practitioners with an active account are included. Deactivated or archived staff do not appear.
The name field is a pre-formatted display string — there are no separate first/last name fields in the external API.
profileImage is a direct public S3 URL. No signing or credentials are needed to access it. Cache the URL as long as the token is valid; the resource is permanent and will not rotate.
The response contains no internal identifiers. Arzamed internal UUIDs are never exposed to external callers.

Coming soon

The following endpoints are in development and will be added to the external API in a future release.

📅

If your integration depends on calendar events or patient data, contact your Arzamed account manager to be notified when these endpoints are available.

Endpoint	Description	Status
`GET /api/v1/equipe/calendar/events`	List upcoming appointment slots for the clinic.	Coming soon
`GET /api/v1/equipe/patients`	List patients registered at the clinic.	Coming soon