---
title: "Get an orderItem"
method: GET
path: "/v0/order-items/{id}"
tags: ["Order"]
---

# Get an orderItem

`GET /v0/order-items/{id}`

Get an orderitem by it's ID, it will also return the list of tasks associated with the ID.

## Path parameters

- `id` string, required

## Response `200`

OK

- ClerkOrderItemResponse
  - `area` integer — UTM based area of the current order in sq. km.
  - `bandset` ClerkOrderItemBandset
    - `bands` ClerkBand[] — list of bands in the bandset
      - `name` string — name of the band
      - `wavelength` number — wavelength of the band in nm
    - `bandset_id` string — id of the bandset
    - `custom` array[]
      - integer[]
  - `base_amount` number — base amount of the order item without any uplifts or discounts
  - `cloud_cover` integer — maximum cloud cover percentage for the tasking order
  - `cloud_delivery` ClerkCloudDelivery
    - `config` string, required — id of the store
    - `path` string — prefix path to which resource should be transferred to
  - `created_at` string — timestamp of the creation of the order item
  - `created_by` string — uuid of the user who created the order item
  - `delivery_speed` 'STANDARD' | 'NOT_APPLICABLE'
  - `end_date` string — end date of your tasking order, the utc date will be considered as the end date.
  - `feasibility_status` 'NOT_APPLICABLE' | 'FAILED' | 'WEAK_SUCCESS' | 'SUCCESS' | 'UNSPECIFIED'
  - `final_amount` number — final amount of the order item after applying uplifts and discounts
  - `id` string — unique identifier of the order item
  - `image_type` 'VNIR' | 'SWIR' | 'VSWIR'
  - `images` ClerkImage[] — list of images associated with the order item
    - `geometry` unknown
    - `item_id` string — STAC item id for the image
  - `last_feasibility_check` string — (only for tasking) timestamp of the feasibility status. Feasibility status can change wrt time for the same order.
  - `name` string — name of the order item
  - `no_of_occurrences` integer — number of occurrences of the recurring order.
  - `number_of_bands` integer — number of bands in the tasking order
  - `occurrences` ClerkInterval[] — list of intervals of recurring orders.
    - `end` string — end time of the interval
    - `start` string — start time of the interval
  - `off_nadir` integer — maximum off nadir angle for the tasking order
  - `order_id` string — UUID of the order
  - `org_id` string — UUID of the workspace
  - `payment_status` 'PAID' | 'PARTIAL-REFUND' | 'REFUND' | 'UNPAID' | 'PARTIAL-MONTHLY'
  - `project_id` string — UUID of the project
  - `recurrence` 'ONCE' | 'MONTHLY' | 'BIMONTHLY' | 'QUARTERLY' | 'NOT_APPLICABLE'
  - `start_date` string — start date of your tasking order, the utc date will be considered as the start date.
  - `status` 'DRAFT' | 'ACTIVE' | 'FULFILLED' | 'CANCELLED' | 'FAILED' | 'PARTIALLY_FULFILLED'
  - `tasks` ClerkTask[] — list of tasks associated with the order item
    - `created_at` string — timestamp of the creation of the task
    - `created_by` string — uuid of the user who created the task
    - `delivery_status` 'UNSPECIFIED' | 'CREATED' | 'FAILED' | 'IN_PROGRESS' | 'SUCCESS'
    - `end_date` string — relevant only for tasking
    - `id` string — uuid of the task
    - `number_of_strips` integer — (relevant only for tasking) number of strips generated for the task
    - `order_item_id` string — uuid of the order item
    - `start_date` string — relevant only for tasking
    - `status` 'DRAFT' | 'SUBMITTED' | 'IN_PROGRESS' | 'FULFILLED' | 'PARTIALLY_FULFILLED' | 'FAILED' | 'CANCELLED' | 'EXPIRED'
    - `tokens_used` integer — tokens used by the specific task, for recurring tasking, tokens are consumed on task level and not orderitem level.
    - `transaction_id` string — uuid of the transaction associated with the task, transaction id will be different for tasks of recurring order items, since each task is transacted for when it's requested/created.
    - `type` 'ARCHIVE' | 'TASKING'
    - `updated_at` string — timestamp of the last update of the task
    - `updated_by` string — uuid of the user who last updated the task
  - `tokens_used` integer — tokens used by the order item, populated only after payment
  - `transaction_id` string — transaction id assorciated with the order item
  - `type` 'TASKING' | 'ARCHIVE' | 'RECURRING'
  - `updated_at` string — timestamp of the last update of the order item
  - `updated_by` string — uuid of the user who last updated the order item
  - `uplifts` ClerkUplift[] — list of uplifts/discounts applied to the order
    - `amount` integer — delta amount due to the uplift
    - `item_id` string — (only for archive order) the item id to which the uplift applies
    - `percentage` integer — percentage of the uplift
    - `subtitle` string — description of the uplift
    - `title` string — type/cause of the uplift
  - `usecase` string — usecase for which this order was requested
  - `user_id` string — UUID of the user
  - `validation_errors` object[] — list of validation errors for the order item

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)