Skip to main content
GET
/
professionals
Get All Professionals
curl --request GET \
  --url https://api.example.com/professionals \
  --header 'Authorization: <authorization>'
{
  "200": {},
  "401": {},
  "404": {},
  "500": {},
  "professionals": [
    {
      "id": 123,
      "name": "<string>",
      "surname": "<string>",
      "dni": 123,
      "birthdate": "<string>",
      "gender": "<string>",
      "address": "<string>",
      "phone": "<string>",
      "email": "<string>",
      "specialityID": 123,
      "state": "<string>",
      "Especialidade": {
        "name": "<string>"
      },
      "HorarioTrabajos": [
        {
          "dayOfWeek": "<string>",
          "startTime": "<string>",
          "endTime": "<string>"
        }
      ]
    }
  ],
  "countActives": 123
}
Retrieves a list of all professionals in the system with optional filtering capabilities.

​
Authentication

​
Authorization
string
required
Bearer token (JWT) required for authentication.

​
Query Parameters

​
search
string
Search term to filter professionals by name, surname, or DNI (partial match).
​
gender
string
Filter professionals by gender.
​
specialityID
number
Filter professionals by specialty ID.
​
state
string
Filter professionals by state. Valid values:
  • Activo/a - Active professional
  • Inactivo/a - Inactive professional
  • Licencia - On license

​
Response

​
professionals
array
Array of professional objects with their details and related information.
​
countActives
number
Total count of active professionals in the system.

​
Status Codes

​
200
Success
Professionals retrieved successfully.
​
401
Unauthorized
Missing or invalid JWT token.
​
404
Not Found
No professionals found in the system.
​
500
Server Error
Internal server error occurred.

​
Example Request

curl -X GET "https://api.clinicavitalis.com/professionals?specialityID=1&state=Activo/a" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Example Response

{
  "professionals": [
    {
      "id": 1,
      "name": "Juan",
      "surname": "Pérez",
      "dni": 12345678,
      "birthdate": "1985-03-15T00:00:00.000Z",
      "gender": "Masculino",
      "address": "Av. Corrientes 1234, Buenos Aires",
      "phone": "+54 11 1234-5678",
      "email": "[email protected]",
      "specialityID": 1,
      "state": "Activo/a",
      "Especialidade": {
        "name": "Cardiología"
      },
      "HorarioTrabajos": [
        {
          "dayOfWeek": "Lunes",
          "startTime": "09:00",
          "endTime": "17:00"
        },
        {
          "dayOfWeek": "Miércoles",
          "startTime": "09:00",
          "endTime": "17:00"
        }
      ]
    }
  ],
  "countActives": 25
}

Build docs developers (and LLMs) love

Get started for freeTalk to us