> ## 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 Assessment ## OpenAPI ````yaml post /v1/assessments 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/assessments: post: tags: - Assessments summary: Create assessment operationId: createAssessment requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssessmentCreate' responses: '201': description: Assessment created components: schemas: AssessmentCreate: type: object required: - status - patientId - summary properties: status: type: string enum: - in-progress - completed statusReason: type: string maxLength: 500 description: Reason for current status patientId: type: string encounterId: type: string practitionerId: type: string code: type: string maxLength: 200 description: Kind of assessment (initial-assessment, follow-up, discharge) description: type: string maxLength: 2000 summary: type: string maxLength: 5000 findings: type: array maxItems: 50 items: type: object properties: code: type: string description: ICD-10 or SNOMED code text: type: string basis: type: string description: Which investigations support this finding note: type: string maxLength: 2000 effectiveDateTime: type: string format: date-time date: type: string format: date-time description: When the assessment was documented (defaults to now) previousAssessmentId: type: string description: Reference to the previous assessment for this patient problemIds: type: array description: Condition or AllergyIntolerance IDs being assessed items: type: string investigations: type: array maxItems: 20 description: Sets of investigations (labs, imaging, questionnaires) items: type: object required: - name properties: name: type: string description: Name/code for the investigation set itemIds: type: array items: type: string description: Reference IDs to Observation, DiagnosticReport, etc. protocol: type: array description: Clinical protocol URIs followed items: type: string prognosis: type: array maxItems: 10 description: Prognosis codes (good, poor, guarded) items: type: object properties: code: type: string text: type: string supportingInfoIds: type: array description: Supporting information references items: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Your ClinikAPI secret key (clk_live_* or clk_test_*) ````