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

# Get Order

> Returns a synced order and its writable result components.

Returns a single synced order along with its `result_components` — the writable result columns for that order. Each component's `field_id` is the write target accepted by [Add Order Results](/api-reference/orders/results), so fetch the order first to learn which components you can populate.

### Example Request

```bash theme={null}
curl -X GET https://api.usecobalt.com/v1/orders/ord_123456 \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH'
```

### Example Response

```json theme={null}
{
  "success": true,
  "order": {
    "id": "ord_123456",
    "order_id": "998877",
    "appointment_id": "445566",
    "patient_name": "P-778899",
    "patient_mrn": "12345",
    "order_date": "2026-02-15",
    "order_name": "1hr Glucose Tolerance (OB)",
    "provider_id": "789",
    "patient_dob": "1980-06-15",
    "lab_results": null,
    "priority": "routine",
    "assigned_to_name": "Jane Doe",
    "emr_assigned_to_id": "staff_101",
    "result_components": [
      {
        "field_id": "col_1001",
        "name": "1hr Glucose (OB)"
      },
      {
        "field_id": "col_1002",
        "name": "Fasting Glucose (OB)"
      }
    ]
  }
}
```


## OpenAPI

````yaml GET /orders/{id}
openapi: 3.1.0
info:
  title: Cobalt API
  version: 1.0.1
  description: API for interacting with Cobalt's EHR integration services
servers:
  - url: https://api.usecobalt.com/v1
    description: Production
security:
  - ClientCredentials: []
    ClientSecret: []
    AccessToken: []
paths:
  /orders/{id}:
    get:
      tags:
        - Orders
      summary: Get an order
      description: >-
        Returns a synced order and its result components (columns) so callers
        know which values POST /v1/orders/{id}/results accepts.
      operationId: getOrder
      parameters:
        - name: id
          in: path
          description: Cobalt order ID.
          schema:
            type: string
          required: true
      responses:
        '200':
          description: The order and its result components
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  order:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Cobalt order ID (dashless UUID).
                      order_id:
                        type: string
                        description: EMR order ID (emr_order_id).
                      appointment_id:
                        type:
                          - string
                          - 'null'
                        description: EMR appointment ID (emr_appointment_id).
                      patient_name:
                        type:
                          - string
                          - 'null'
                        description: EMR patient identifier (emr_patient_id).
                      patient_mrn:
                        type:
                          - string
                          - 'null'
                        description: Patient Medical Record Number.
                      order_date:
                        type:
                          - string
                          - 'null'
                        description: Order date (ISO 8601 date).
                      order_name:
                        type:
                          - string
                          - 'null'
                        description: Order name.
                      provider_id:
                        type:
                          - string
                          - 'null'
                        description: EMR provider ID.
                      patient_dob:
                        type:
                          - string
                          - 'null'
                        description: Patient date of birth (ISO 8601 date).
                      lab_results:
                        description: >-
                          Lab results payload (EMR-specific JSON), when
                          available.
                      priority:
                        type:
                          - string
                          - 'null'
                        description: Order priority.
                      assigned_to_name:
                        type:
                          - string
                          - 'null'
                        description: Name of the staff member the order is assigned to.
                      emr_assigned_to_id:
                        type:
                          - string
                          - 'null'
                        description: EMR ID of the staff member the order is assigned to.
                      result_components:
                        type: array
                        items:
                          type: object
                          properties:
                            field_id:
                              type: string
                              description: EMR component id; write target for results.
                            name:
                              type: string
                              description: Human column name, e.g. "1hr Glucose (OB)".
                          required:
                            - field_id
                            - name
                        description: Writable result columns for this order.
                    required:
                      - id
                      - order_id
                      - appointment_id
                      - patient_name
                      - patient_mrn
                      - order_date
                      - order_name
                      - provider_id
                      - patient_dob
                      - priority
                      - assigned_to_name
                      - emr_assigned_to_id
                      - result_components
                required:
                  - success
                  - order
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  responses:
    BadRequest:
      description: Bad request — missing or invalid parameters
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                enum:
                  - false
              message:
                type: string
            required:
              - success
              - message
    Unauthorized:
      description: Unauthorized — missing or invalid credentials
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                enum:
                  - false
              message:
                type: string
            required:
              - success
              - message
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                enum:
                  - false
              message:
                type: string
            required:
              - success
              - message
  securitySchemes:
    ClientCredentials:
      type: apiKey
      in: header
      name: client_id
    ClientSecret:
      type: apiKey
      in: header
      name: client_secret
    AccessToken:
      type: apiKey
      in: header
      name: access_token

````