---
title: "Aggregate order breakdowns — by status, program, shipping state, and refunds (no per-order rows)."
method: GET
path: "/api/v1/orders/summary"
tags: ["Orders"]
---

# Aggregate order breakdowns — by status, program, shipping state, and refunds (no per-order rows).

`GET /api/v1/orders/summary`

## Request

- Base URL: `https://api-dev.fusehealth.com`
- URL: `https://api-dev.fusehealth.com/api/v1/orders/summary`
- Auth: API key in header `x-api-key`

Counts and sums only: orders by status, orders and paid sales by program, orders by shipping state, and refund requests by status with the approved total. Never returns an order id, order number, date, patient or medication. A shipping state with fewer than 5 orders is never named; all such states are reported together in `otherStates`. Safe for the AI connector.

## Query parameters

- `startDate` string
- `endDate` string

## Response `200`

Success

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `window` object
      - `startDate` string, nullable
      - `endDate` string, nullable
    - `totalOrders` integer
    - `byStatus` object[]
      - `status` string
      - `orders` integer
    - `byProgram` object[]
      - `programId` string, nullable
      - `programName` string, nullable
      - `orders` integer
      - `paidSales` number
    - `byState` object[]: Only states with 5 or more orders.
      - `state` string
      - `orders` integer
    - `otherStates` object, nullable: States with fewer than 5 orders, unnamed — how many, and their orders together.
      - `states` integer
      - `orders` integer
    - `refunds` object
      - `byStatus` object[]
        - `status` string
        - `requests` integer
      - `approvedAmount` number

## Other responses

- `400`: Invalid startDate or endDate
- `401`: Missing, invalid, inactive, or expired API key (or JWT)

---

[API](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external.md) · [All operations](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/fusehealth/apis/fuse-brand-api-external/revisions/50821832728c?raw)