> ## Documentation Index > Fetch the complete documentation index at: https://docs.spikeapi.com/llms.txt > Use this file to discover all available pages before exploring further. # List patients > List patients associated with your EMR. Optionally filter by clinic_id. Use pagination (_start, _limit) for large result sets. ## OpenAPI ````yaml /api-spike-care/openapi.json get /patients openapi: 3.1.0 info: title: API version: 1.0.0 servers: - description: Spike Care API url: https://api.spikecare.com/public/v1 security: [] paths: /patients: get: tags: - patients summary: List patients description: >- List patients associated with your EMR. Optionally filter by clinic_id. Use pagination (_start, _limit) for large result sets. parameters: - description: >- 0-based index of the first item to return (offset). Use with _limit for paging. explode: false in: query name: _start schema: default: 0 description: >- 0-based index of the first item to return (offset). Use with _limit for paging. format: int64 minimum: 0 type: integer - description: Maximum number of items to return per request (1–100). explode: false in: query name: _limit schema: default: 100 description: Maximum number of items to return per request (1–100). format: int64 maximum: 100 minimum: 1 type: integer - description: >- Name of the field to sort by (e.g. id, name, created_at). Omit for default sort. explode: false in: query name: _sort schema: description: >- Name of the field to sort by (e.g. id, name, created_at). Omit for default sort. type: string - description: 'Sort direction: asc or desc.' explode: false in: query name: _order schema: default: asc description: 'Sort direction: asc or desc.' enum: - asc - desc type: string - description: >- Optional. Limit results to patients assigned to this clinic ID. Omit or 0 for all clinics. explode: false in: query name: clinic_id schema: description: >- Optional. Limit results to patients assigned to this clinic ID. Omit or 0 for all clinics. format: int64 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/PatientsListResponseBody' description: OK '400': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Bad Request '404': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Not Found '422': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Unprocessable Entity '500': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Internal Server Error components: schemas: PatientsListResponseBody: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - >- https://api.spikecare.com/public/v1/schemas/PatientsListResponseBody.json format: uri readOnly: true type: string patients: items: $ref: '#/components/schemas/Patient' type: - array - 'null' required: - patients type: object ErrorModel: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.spikecare.com/public/v1/schemas/ErrorModel.json format: uri readOnly: true type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object Patient: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.spikecare.com/public/v1/schemas/Patient.json format: uri readOnly: true type: string address: description: Patient’s street address (optional). maxLength: 500 type: string clinic_id: description: ID of the clinic this patient is assigned to. format: int64 minimum: 1 type: integer date_of_birth: description: Date of birth in YYYY-MM-DD format. format: date type: string email: description: Patient’s email address (optional). format: email maxLength: 255 type: string group_number: description: Insurance group number (optional). maxLength: 255 type: string id: description: Unique patient identifier assigned by the API. format: int64 minimum: 1 type: integer in_network_override: description: >- Override default network status: true = in-network, false = out-of-network. Omit to use clinic default. type: boolean insurance_provider_id: description: >- ID of the patient’s primary insurance provider (payer) from the insurance-providers reference. format: int64 minimum: 1 type: integer name: description: Patient’s full name as in your EMR. maxLength: 255 minLength: 1 type: string phone: description: Patient’s contact phone number in E.164 format (optional). maxLength: 30 type: string policy_id: description: Insurance policy ID / member ID (optional). maxLength: 255 type: string required: - id - name - date_of_birth - insurance_provider_id - clinic_id type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ````