> ## Documentation Index > Fetch the complete documentation index at: https://docs.clinikapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Patient ## OpenAPI ````yaml post /v1/patients openapi: 3.1.0 info: title: ClinikAPI version: 1.0.0 description: > ClinikAPI is a managed healthcare infrastructure platform providing a developer-friendly REST API for storing, querying, and managing clinical data using the FHIR R4 standard. ## Authentication All endpoints (except `/v1/metadata` and `/health`) require an API key via the `x-api-key` header. - Production keys: `clk_live_*` - Test/sandbox keys: `clk_test_*` ## Response Format All responses are wrapped in `{ data: T, meta: { requestId, timestamp, status, rateLimitTotal, rateLimitRemaining, rateLimitReset } }`. ## Rate Limits Rate limits are plan-based and returned in response headers: - `X-RateLimit-Limit` — total requests allowed per window - `X-RateLimit-Remaining` — requests remaining - `X-RateLimit-Reset` — seconds until window resets ## Overages Requests beyond your plan limit are charged at $0.003/request. contact: name: ClinikAPI Support email: support@clinikapi.com url: https://clinikapi.com license: name: Proprietary servers: - url: https://api.clinikapi.com description: Production - url: http://localhost:3000 description: Local development security: - ApiKeyAuth: [] tags: - name: System description: Health check and metadata - name: Patients description: Patient demographics and records - name: Practitioners description: Healthcare providers and clinicians - name: PractitionerRoles description: Practitioner roles, specialties, and availability - name: Encounters description: Clinical visits and interactions - name: Observations description: Vitals, lab values, and clinical measurements - name: Medications description: Drug catalog entries - name: Appointments description: Scheduling and booking - name: Prescriptions description: Medication orders (MedicationRequest) - name: Intakes description: Questionnaire responses and intake forms - name: Consents description: Privacy and treatment consent directives - name: Labs description: Diagnostic reports and lab results - name: Notes description: Clinical notes and documents (DocumentReference) - name: Assessments description: Clinical impressions and evaluations - name: Documents description: Structured clinical documents (Composition) - name: Devices description: Medical devices, equipment, and implantable hardware - name: DeviceRequests description: Orders and proposals for device use - name: DeviceUseStatements description: Records of device use on patients - name: Goals description: Patient care goals and targets - name: Invoices description: Healthcare billing invoices - name: MedicationDispenses description: Pharmacy medication dispensing records - name: MedicationKnowledge description: Drug reference data and formulary information - name: MedicationStatements description: Patient-reported medication usage records - name: PaymentNotices description: Payment status notifications between payers and providers - name: PaymentReconciliations description: Detailed payment settlement information with line-item breakdowns - name: Specimens description: Biological samples collected from patients for laboratory testing - name: ImagingStudies description: Radiology and diagnostic imaging exams with series-level detail - name: EnrollmentRequests description: Insurance enrollment requests for patients - name: EnrollmentResponses description: Insurer responses to enrollment requests - name: ImmunizationEvaluations description: Evaluation of immunization events against protocol requirements - name: Media description: Clinical images, videos, and audio recordings - name: AuditEvents description: Security-relevant event records for compliance and audit trails - name: Measures description: Quality measures and clinical performance metric definitions - name: MeasureReports description: Results of evaluating quality measures against populations or patients - name: ImmunizationRecommendations description: Patient-specific vaccine recommendations based on immunization history - name: Bulk description: Bulk import and export operations - name: FHIR Passthrough description: Raw FHIR R4 access with tenant isolation paths: /v1/patients: post: tags: - Patients summary: Create patient operationId: createPatient requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PatientCreate' responses: '201': description: Patient created content: application/json: schema: $ref: '#/components/schemas/ApiResponse' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: PatientCreate: type: object required: - firstName - lastName properties: firstName: type: string maxLength: 100 lastName: type: string maxLength: 100 email: type: string format: email phone: type: string maxLength: 20 gender: type: string enum: - male - female - other - unknown birthDate: type: string description: Date of birth (YYYY-MM-DD) address: $ref: '#/components/schemas/Address' maritalStatus: type: string maxLength: 50 description: Marital status (married, single, divorced, widowed) photo: type: object properties: url: type: string format: uri data: type: string description: Base64-encoded image contentType: type: string contact: type: array maxItems: 10 description: Emergency contacts / next of kin items: type: object properties: relationship: type: string firstName: type: string lastName: type: string phone: type: string email: type: string format: email address: $ref: '#/components/schemas/Address' languages: type: array maxItems: 20 description: Languages the patient speaks items: type: object required: - language properties: language: type: string description: BCP-47 language code or display name preferred: type: boolean generalPractitionerId: type: string description: Reference to the patient's GP (Practitioner ID) ApiResponse: type: object properties: data: description: The resource or result payload meta: $ref: '#/components/schemas/ResponseMeta' Error: type: object properties: error: type: string message: type: string code: type: string requestId: type: string issues: type: array items: type: object properties: severity: type: string code: type: string diagnostics: type: string Address: type: object properties: line: type: array items: type: string city: type: string state: type: string postalCode: type: string country: type: string ResponseMeta: type: object properties: requestId: type: string example: req_k8f3a7x2 timestamp: type: string format: date-time status: type: integer example: 200 rateLimitTotal: type: integer rateLimitRemaining: type: integer rateLimitReset: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Your ClinikAPI secret key (clk_live_* or clk_test_*) ````