> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cairhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Patient

> Reads a patient by external patient id.

## Overview

Reads a patient record by external patient id, the same
identifier used by the professional claim endpoints.

## Authentication

JWT Bearer token from `/api/token`.

## Path Parameters

<ParamField path="patientId" type="string" required>
  External patient id.
</ParamField>

## Example

```bash theme={null}
curl "https://forecaster.cairhealth.com/api/patient/EXT-PAT-123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Response

Returns the FHIR `Patient` resource for the matching patient.

```json theme={null}
{
  "success": true,
  "data": {
    "resourceType": "Patient",
    "id": "fhir-patient-id",
    "active": true,
    "identifier": [
      {
        "system": "https://fhir.cairhealth.com/fhir/identifier/customer-patient-id",
        "value": "EXT-PAT-123"
      }
    ],
    "name": [
      { "use": "usual", "family": "Doe", "given": ["Jane"] }
    ],
    "gender": "female",
    "birthDate": "1990-01-02",
    "telecom": [{ "system": "email", "value": "jane@example.com" }],
    "address": [
      {
        "line": ["1 Main St"],
        "city": "Springfield",
        "state": "IL",
        "postalCode": "62704"
      }
    ]
  }
}
```

Returns `404` when no patient matches the external id.


## OpenAPI

````yaml GET /api/patient/{patientId}
openapi: 3.1.0
info:
  title: Cair Health APIs
  description: APIs for the Cair Health platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://forecaster.cairhealth.com
security:
  - bearerAuth: []
paths:
  /api/patient/{patientId}:
    get:
      description: Reads a patient by external patient id.
      parameters:
        - name: patientId
          in: path
          required: true
          schema:
            type: string
          description: External patient id
      responses:
        '200':
          description: Patient fetched successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    description: The FHIR Patient resource
        '400':
          description: Invalid request body or validation error
        '401':
          description: Unauthorized access or invalid organization ID
        '404':
          description: Organization or patient not found
        '409':
          description: Patient already exists
        '500':
          description: Server error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.