List Patients

GET /patients

Returns a paginated list of patients belonging to the authenticated clinic.

Scope required: patient.read

Query Parameters

Parameter	Type	Description
search	string	Full-text search on name, phone, email
page	integer	Page number (default: 1)
limit	integer	Items per page — max 100 (default: 20)

Request

GET /api/developer/v1/patients?search=ali&page=1&limit=20
Authorization: Developer wc_live_…:wcs_live_…

Response 200

{
  "data": [
    {
      "id": "018f1a2b-3c4d-7e5f-a6b7-c8d9e0f1a2b3",
      "full_name": "Ali Yılmaz",
      "first_name": "Ali",
      "last_name": "Yılmaz",
      "date_of_birth": "1985-06-15",
      "gender": "male",
      "phone_number": "+905321234567",
      "email_address": "ali@example.com",
      "created_at": "2025-03-01T10:00:00+03:00"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "total_pages": 1
  }
}