---
title: "Retrieve a list of orders"
method: GET
path: "/admin/orders"
tags: ["Orders"]
---

# Retrieve a list of orders

`GET /admin/orders`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/admin/orders`
- Auth: HTTP bearer

Retrieve a list of orders for the admin dashboard.

## Query parameters

- `limit` number, nullable
- `page` number, nullable
- `order_by` 'asc' | 'desc'
- `sort_by` string
- `include_archived` 'true' | 'false'
- `skip_pagination` 'true' | 'false'
- `filters` object
  - `search` string
  - `team_ids` string[]
  - `start_date` string, nullable
  - `end_date` string, nullable
  - `profile_id` string, uuid
  - `status` 'CREATED' | 'PAID' | 'CANCELLED'
  - `paid_orders_only` 'true' | 'false'
  - `include_outlets_data` 'true' | 'false'

## Response `200`

Order retrieved successfully

- object
  - `total_pages` number, required
  - `current_page` number, required
  - `next_page` number, nullable, required
  - `previous_page` number, nullable, required
  - `records` object[], required
    - `id` string, uuid, required
    - `profile_id` string, uuid, nullable, required
    - `client_id` string, uuid, nullable, required
    - `checkout_by_id` string, uuid, nullable, required
    - `team_id` string, uuid, nullable, required
    - `total` number, nullable, required
    - `subtotal` number, nullable, required
    - `processing_fee` number, nullable, required
    - `discount` number, nullable, required
    - `credits_applied` number, nullable, required
    - `coupon` string, nullable, required
    - `client_secret` string, required
    - `date_paid` union, required
      - string, nullable
      - string
      - unknown
    - `status` 'CREATED' | 'PAID' | 'CANCELLED', required
    - `reference_number` string, nullable, required
    - `external_reference_number` string, nullable, required
    - `customer_invoice_id` string, nullable, required
    - `customer_invoice_source` 'STRIPE' | 'BILL_COM' | 'WIRE', nullable, required
    - `customer_invoice_date` union, required
      - string, nullable
      - string
      - unknown
    - `customer_invoice_url` string, nullable, required
    - `is_guest_order` boolean, required
    - `guest_email` string, email, nullable, required
    - `account_owner_email` string, email, nullable, required
    - `guest_stripe_customer_id` string, nullable, required
    - `checkout_session_id` string, nullable, required
    - `payment_intent_id` string, nullable, required
    - `payment_status` 'NOT_STARTED' | 'OPEN' | 'PROCESSING' | 'FAILED' | 'EXPIRED' | 'PAID', required
    - `payment_expires_at` union, required
      - string, nullable
      - string
      - unknown
    - `posthog_distinct_id` string, nullable, required
    - `created_at` union, required
      - string, nullable
      - string
      - unknown
    - `updated_at` union, required
      - string, nullable
      - string
      - unknown
    - `deleted_at` union, required
      - string, nullable
      - string
      - unknown
    - `metadata` unknown
    - `team` object, nullable, required
      - `name` string, required
      - `contact_email` string, email, nullable, required
    - `line_items` object[], required
      - `id` string, uuid, required
      - `order_id` string, uuid, required
      - `product_id` string, nullable, required
      - `quantity` number, required
      - `price` number, nullable, required
      - `is_add_on` boolean
      - `linked_order_line_item_id` string, nullable
      - `source` string, nullable, required
      - `niche_snapshot` object, nullable, required
        - `version` 1, required
        - `outlet_niche_id` string, uuid, required
        - `niche` 'CRYPTO' | 'CBD' | 'GAMBLING' | 'ADULT_CONTENT' | 'SUPPLEMENTS' | 'MEDICAL' | 'INVESTING' | 'POLITICAL' | 'WEIGHT_LOSS' | 'GRAY_AREA_SERVICES', required
        - `multiplier` string, required
        - `parent_unit_price_cents` integer, required
        - `surcharge_unit_price_cents` integer, required
        - `display_name` string, required
      - `created_at` union, required
        - string, nullable
        - string
        - unknown
      - `updated_at` union, required
        - string, nullable
        - string
        - unknown
      - `deleted_at` union, required
        - string, nullable
        - string
        - unknown
      - `name` string, nullable, required
      - `product_type_name` string, nullable, required
      - `type_id` string, uuid, nullable, required
      - `product_type_prefix` string, nullable, required
      - `pending_units` integer, required
      - `outlet` object, nullable, required
        - `logo` string, nullable, required
        - `website_url` string, nullable, required
    - `checkout_link` string, nullable, required: Guest checkout link. Only present when the order is not yet paid.
    - `current_invoice` OrderInvoiceSummary, required
      - `reference_number` string, nullable, required
      - `source` 'STRIPE' | 'BILL_COM' | 'WIRE', nullable, required
      - `issued_at` union, required
        - string, nullable
        - string
        - unknown
      - `url` string, nullable, required
  - `total_records` number, required

## Changes

- **2026-10-20** `2154581d845e`: 1 info
  - added the required property `records/items/current_invoice` to the response with the `200` status

[Operation history](https://skmtc.dev/presscart/apis/presscart-prod-api/changes/admin/orders/get.md)

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/2154581d845e?raw)