---
title: "List"
method: GET
path: "/shipping_integrations/atlas/orders/list/v1"
tags: ["/shipping_integrations"]
---

# List

`GET /shipping_integrations/atlas/orders/list/v1`

Returns a paginated list of mirrored Atlas orders with provider organizations expanded, filtering, sorting, pagination, and optional search. | (AtlasOrderListFilters) -> (AtlasOrderListRes)

## Query parameters

- `sort_by` 'mirrored_at_timestamp' | 'created_at_timestamp' | 'updated_at_timestamp' | 'integration_order_id'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `limit` integer — Max items to return
- `page` integer — Page number (1-indexed)
- `search` string, nullable — Search Atlas order IDs.
- `filter_provider_org_id` string[], nullable — Filter by provider org ID(s)
- `filter_integration_order_id` string, nullable — Filter by Atlas's exact order ID
- `filter_mirrored_at_timestamp_gte` string, date-time, nullable — Filter mirrored_at_timestamp >= value
- `filter_mirrored_at_timestamp_lte` string, date-time, nullable — Filter mirrored_at_timestamp <= value
- `filter_created_at_timestamp_gte` string, date-time, nullable — Filter created_at_timestamp >= value
- `filter_created_at_timestamp_lte` string, date-time, nullable — Filter created_at_timestamp <= value
- `filter_updated_at_timestamp_gte` string, date-time, nullable — Filter updated_at_timestamp >= value
- `filter_updated_at_timestamp_lte` string, date-time, nullable — Filter updated_at_timestamp <= value

## Response `200`

Successful Response

- AtlasOrderListRes
  - `items` AtlasOrderExpanded1[], required
    - `schema_version` 1, required
    - `_id` string, required
    - `org_id` string, required — Must be a string starting with `org_`
    - `shipping_integration` 'atlas', required
    - `provider_org_id` string, required — Must be a string starting with `org_`
    - `integration_order_id` string, required
    - `provider_payload` AtlasOrderResponse1, required — Known fields from an Atlas shipment payload, retaining all other fields.
      - `id` string, required
      - `origin` string, nullable
      - `destination` string, nullable
      - `trailer` string, nullable
      - `dateCreated` string, nullable
      - `dateEnd` string, nullable
      - `numStops` integer, nullable
      - `clientReference` string, nullable
      - `status` string, nullable
      - `stops` AtlasStopResponse1[], nullable
        - `truck` string, nullable
        - `origin` string, nullable
        - `destination` string, nullable
        - `sequence` integer, nullable
        - `events` AtlasEventResponse1[]
          - `code` string, nullable
          - `type` string, nullable
          - `latitude` number, nullable
          - `longitude` number, nullable
          - `dateUtc` string, nullable
    - `provider_payload_hash` string, required
    - `created_at_timestamp` string, date-time, required
    - `updated_at_timestamp` string, date-time, required
    - `mirrored_at_timestamp` string, date-time, required
    - `provider_org` OrgPublicData1 — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)