Skip to main content
GET
/
api
/
medicos
/
public
List Public Doctors
curl --request GET \
  --url https://api.example.com/api/medicos/public
{
  "doctors": [
    {
      "[].id": 123,
      "[].persona_id": 123,
      "[].especialidad_id": 123,
      "[].email": "<string>",
      "[].colegiatura": "<string>",
      "[].activo": true,
      "[].persona": {
        "persona.nombres": "<string>",
        "persona.apellidos": "<string>",
        "persona.telefono": "<string>"
      },
      "[].especialidad": {
        "especialidad.nombre": "<string>"
      }
    }
  ],
  "500 Internal Server Error": {}
}
This endpoint returns a list of all active doctors available for appointments. Only doctors with activo: true status are included in the response.

​
Authentication

No authentication required - this is a public endpoint.

​
Query Parameters

No query parameters required.

​
Response

Returns an array of doctor objects.
​
doctors
array
Array of active doctor objects
​
[].id
number
Doctor ID
​
[].persona_id
number
Associated person ID
​
[].especialidad_id
number
Specialty ID
​
[].email
string
Doctor’s email address
​
[].colegiatura
string
Doctor’s professional license number
​
[].activo
boolean
Active status (always true for this endpoint)
​
[].persona
object
Personal information of the doctor
​
persona.nombres
string
Doctor’s first name(s)
​
persona.apellidos
string
Doctor’s last name(s)
​
persona.telefono
string
Doctor’s phone number
​
[].especialidad
object
Specialty information
​
especialidad.nombre
string
Specialty name

​
Error Responses

​
500 Internal Server Error
object
Returned when a server error occurs
{
  "message": "Error al listar médicos"
}

​
Example Request

curl https://api.example.com/api/medicos/public

​
Example Response

[
  {
    "id": 1,
    "persona_id": 10,
    "especialidad_id": 2,
    "email": "[email protected]",
    "colegiatura": "MED-12345",
    "activo": true,
    "persona": {
      "nombres": "María",
      "apellidos": "García López",
      "telefono": "+502 5555-9876"
    },
    "especialidad": {
      "nombre": "Cardiología"
    }
  },
  {
    "id": 2,
    "persona_id": 15,
    "especialidad_id": 5,
    "email": "[email protected]",
    "colegiatura": "MED-67890",
    "activo": true,
    "persona": {
      "nombres": "Carlos",
      "apellidos": "Rodríguez Pérez",
      "telefono": "+502 5555-5432"
    },
    "especialidad": {
      "nombre": "Pediatría"
    }
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us