> ## Documentation Index > Fetch the complete documentation index at: https://developer.eka.care/llms.txt > Use this file to discover all available pages before exploring further. # Get a record > Fetches one record by your own id for it. ## OpenAPI ````yaml get /admin/datasets/v1/{entity_id}/ openapi: 3.1.0 info: title: Eka Care Datasets API description: >- Manage your workspace's formulary catalogs (medications, lab tests, symptoms and diagnoses): upload them as JSON or CSV, keep them in sync, read them back, and switch on partner search in the Eka Medical Database. Every request acts only on the workspace your access token belongs to. version: 1.0.0 contact: name: Eka Care Support url: https://eka.care/ email: support@eka.care servers: - url: https://api.eka.care description: Production - url: https://api.dev.eka.care description: Stage/Sandbox security: - BearerAuth: [] tags: - name: datasets paths: /admin/datasets/v1/{entity_id}/: get: tags: - datasets summary: Get a record description: Fetches one record by your own id for it. operationId: getDatasetRecord parameters: - name: entity_id in: path required: true description: >- Your id for the record (`medication_id`, `lab_test_id`, `symptom_id` or `diagnosis_id`). schema: type: string - $ref: '#/components/parameters/Type' responses: '200': description: The record. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: '#/components/schemas/Record' example: success: true message: found data: symptom_id: SYM1001 name: Chest Pain display_name: Chest Pain aliases: - Chest Discomfort snomed_id: '1263722001' icd10: R07.4 icd10_term: Chest pain, unspecified gender: null is_active: true updated_at: '2026-09-28T10:15:00+00:00' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': description: No record with this id in your workspace. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false message: no symptom with id 'SYM9999' components: parameters: Type: name: type in: query required: true description: Which catalog to act on. schema: type: string enum: - medication - lab_test - symptom - diagnosis schemas: SuccessEnvelope: type: object required: - success - message properties: success: type: boolean const: true message: type: string Record: description: A record of the requested type, as returned by the API. oneOf: - $ref: '#/components/schemas/Medication' - $ref: '#/components/schemas/LabTest' - $ref: '#/components/schemas/Symptom' - $ref: '#/components/schemas/Diagnosis' ErrorResponse: type: object required: - success - message properties: success: type: boolean const: false message: type: string errors: type: array description: >- Present when validation failed or the shrink guard stopped a reconcile. items: oneOf: - $ref: '#/components/schemas/FieldError' - $ref: '#/components/schemas/ShrinkGuardError' Medication: type: object title: Medication required: - medication_id - name properties: medication_id: type: string maxLength: 200 description: Your id for the drug. name: type: string maxLength: 200 aliases: type: array items: type: string maxLength: 200 description: Alternate names and short forms, used by search. display_name: type: string maxLength: 200 description: Shown to end users. Defaults to `name`. strength: type: string maxLength: 32 generic_name: type: string maxLength: 300 generic_id: type: string maxLength: 64 generic_list: type: array items: type: string maxLength: 100 description: All generic (salt) components. generic_list_ids: type: array items: type: string maxLength: 64 form_name: type: string maxLength: 64 description: >- Dosage form. Matched case-insensitively against the [accepted drug forms](/api-reference/datasets/forms); a match links the drug to Eka's form, and any other value is stored as text without that link. sku: type: string maxLength: 64 schedule_code: type: string maxLength: 32 custom_type: type: string maxLength: 64 therapy_class: type: string maxLength: 128 therapy_class_id: type: string maxLength: 64 action_class: type: string maxLength: 128 action_class_id: type: string maxLength: 64 manufacturer: type: string maxLength: 200 otc: type: boolean is_active: type: boolean description: Defaults to true on write. updated_at: type: string format: date-time readOnly: true LabTest: type: object title: LabTest required: - lab_test_id - name - kind - result_type description: >- `specimen` is required when `kind` is `laboratory`, `unit` when `result_type` is `numerical`, and `panel_members` when `kind` is `panel`. properties: lab_test_id: type: string maxLength: 200 description: Your id for the test. name: type: string maxLength: 200 display_name: type: string maxLength: 200 description: Shown to end users. Defaults to `name`. aliases: type: array items: type: string maxLength: 200 loinc: type: string maxLength: 32 description: LOINC code. Not checked against the LOINC vocabulary. kind: type: string enum: - imaging - laboratory - functional - special_test - package - panel result_type: type: string enum: - numerical - ordinal - string - na discipline: type: array items: type: string maxLength: 100 description: For example biochemistry, hematology, micro, molecular, cardiology. specimen: type: string maxLength: 100 unit: type: string maxLength: 32 unit_id: type: string maxLength: 64 panel_members: type: array items: type: string maxLength: 200 description: Names of the member tests. panel_member_ids: type: array items: type: string maxLength: 200 method: type: string maxLength: 100 description: For example ELISA, RAPID_ICT, CHEMILUMINESCENCE (CLIA). body_part: type: string maxLength: 100 description: Imaging only. laterality: type: string maxLength: 32 description: Imaging only. view: type: string maxLength: 64 description: Imaging only. is_active: type: boolean description: Defaults to true on write. updated_at: type: string format: date-time readOnly: true Symptom: type: object title: Symptom required: - symptom_id - name properties: symptom_id: type: string maxLength: 200 description: Your id for the symptom. name: type: string maxLength: 200 display_name: type: string maxLength: 200 description: Shown to end users. Defaults to `name`. aliases: type: array items: type: string maxLength: 200 snomed_id: type: string maxLength: 32 description: SNOMED CT concept id. Not checked against the vocabulary. icd10: type: string maxLength: 32 icd10_term: type: string maxLength: 255 gender: type: - string - 'null' enum: - M - F - null description: Leave empty when the symptom applies to everyone. is_active: type: boolean description: Defaults to true on write. updated_at: type: string format: date-time readOnly: true Diagnosis: type: object title: Diagnosis required: - diagnosis_id - name properties: diagnosis_id: type: string maxLength: 200 description: Your id for the diagnosis. name: type: string maxLength: 200 display_name: type: string maxLength: 200 description: Shown to end users. Defaults to `name`. aliases: type: array items: type: string maxLength: 200 snomed_id: type: string maxLength: 32 description: SNOMED CT concept id. Not checked against the vocabulary. icd10: type: string maxLength: 32 icd10_term: type: string maxLength: 255 gender: type: - string - 'null' enum: - M - F - null description: Leave empty when the diagnosis applies to everyone. is_active: type: boolean description: Defaults to true on write. updated_at: type: string format: date-time readOnly: true FieldError: type: object properties: index: type: - integer - 'null' description: >- For a JSON body, the 0-based position of the failing record in the list. For a CSV, the 1-based data row (the header row is not counted). `null` for a file-level error. field: type: - string - 'null' msg: type: string value: description: The rejected value. ShrinkGuardError: type: object properties: code: type: string const: shrink_guard active_before: type: integer would_deactivate: type: integer responses: BadRequest: description: Invalid request, for example a missing or unknown `type`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false message: >- type must be one of 'medication', 'lab_test', 'symptom', 'diagnosis' Unauthorized: description: The access token is missing, invalid or expired. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: Access token for your workspace. ````