---
title: "Get order by reference number or ID"
method: GET
path: "/orders/{reference_number}/reference"
tags: ["Orders"]
---

# Get order by reference number or ID

`GET /orders/{reference_number}/reference`

## 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/orders/{reference_number}/reference`
- Auth: one of:
  - HTTP bearer
  - none

Get an order by reference number or order ID. Returns full data for authenticated owners, limited data for guests.

## Path parameters

- `reference_number` string, required: Reference number or order ID

## Response `200`

Order retrieved successfully

- union
  - object
    - `id` string, uuid, required
    - `created_at` union, required
      - string, nullable
      - string
      - unknown
    - `updated_at` union, required
      - string, nullable
      - string
      - unknown
    - `total` number, nullable, required
    - `subtotal` number, nullable, required
    - `processing_fee` number, nullable, required
    - `discount` number, nullable, required
    - `coupon` string, nullable, required
    - `client_secret` string, required
    - `credits_applied` number, nullable, required
    - `payment_status` 'NOT_STARTED' | 'OPEN' | 'PROCESSING' | 'FAILED' | 'EXPIRED' | 'PAID', required
    - `status` 'CREATED' | 'PAID' | 'CANCELLED', required
    - `reference_number` string, nullable, required
    - `is_guest_order` boolean, required
    - `line_items` object[], required
      - `id` string, uuid, required
      - `order_id` string, uuid, required
      - `product_id` string, uuid, nullable, required
      - `quantity` number, required
      - `price` number, nullable, required
      - `is_add_on` boolean, nullable
      - `linked_order_line_item_id` string, uuid, nullable, required
      - `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
      - `pending_units` integer, required
      - `lifespan_guaranteed` boolean, nullable, required: The placement's submission_requirements.lifespan.guaranteed; null means unknown, never covered.
      - `outlet` object, nullable, required
        - `id` string, required
        - `name` string, required
        - `logo` string, nullable, required
        - `website_url` string, nullable, required
      - `includes` object[], required
        - `channel_type` string, required
        - `placement_type` string, nullable, required
  - object
    - `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
    - `metadata` object, 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
    - `line_items` object[], required
      - `id` string, uuid, required
      - `order_id` string, uuid, required
      - `product_id` string, uuid, nullable, required
      - `quantity` number, required
      - `price` number, nullable, required
      - `internal_cost` number, nullable, required
      - `is_add_on` boolean, nullable
      - `linked_order_line_item_id` string, uuid, nullable, required
      - `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
      - `pending_units` integer, required
      - `lifespan_guaranteed` boolean, nullable, required: The placement's submission_requirements.lifespan.guaranteed; null means unknown, never covered.
      - `outlet` object, nullable, required
        - `id` string, required
        - `name` string, required
        - `logo` string, nullable, required
        - `website_url` string, nullable, required
      - `includes` object[], required
        - `channel_type` string, required
        - `placement_type` string, nullable, required

## Changes

- **2026-10-20** `6cc194695138`: 2 info
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/presscart/apis/presscart-prod-api/changes/orders/:reference_number/reference/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/6cc194695138?raw)