Skip to main content
Method and path: GET {BASE_URL}/providers Returns the list of providers for your organization, with optional filters.

​
Query parameters (all optional)

ParameterTypeDescription
specialtystringFilter by specialty code (max 20 characters).
activeOnlybooleanOnly active (default true).
searchstringSearch by name (partial, max 100 characters).
professionalTypestringFilter by professional type (e.g. MedicoGeneral).

​
Examples

  • All active: GET {BASE_URL}/providers
  • By name: GET {BASE_URL}/providers?search=Juan
  • By specialty: GET {BASE_URL}/providers?specialty=CA003
  • By type: GET {BASE_URL}/providers?professionalType=MedicoGeneral

​
Success response (200)

{
  "success": true,
  "data": {
    "providers": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "name": "Dr. Ana María Rodríguez",
        "professionalLicense": "123456789",
        "professionalType": "Médico General",
        "specialtyCode": "CA003",
        "specialtyName": "Medicina General",
        "phone": "+573019876543",
        "email": "[email protected]",
        "isActive": true,
        "createdAt": "2024-12-15 10:30"
      }
    ]
  },
  "metadata": {
    "requestId": "a1b2c3d4e5",
    "timestamp": "2024-12-15T10:30:00Z",
    "version": "v1"
  }
}