---
title: "Read AI-referred store orders"
method: GET
path: "/ai_orders"
tags: ["Store Integrations"]
---

# Read AI-referred store orders

`GET /ai_orders`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/ai_orders`
- Auth: API key in header `Authorization`

Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders. Revenue values are decimal strings in currency. Team members need read access to AI Traffic. Not available to accounts with a white-label portal or an embed (ERR_INTEGRATION_UNAVAILABLE).

## Query parameters

- `project_id` integer, required
- `platform` 'shopify'
- `from` string, date
- `to` string, date

## Response `200`

Totals, per-assistant rows and the daily series

- AiOrdersResponse
  - `project_id` integer, required
  - `platform` string, required
  - `currency` string, nullable, required: ISO 4217 code of the most recent stored day; null when the window holds no stored order
  - `from` string, date, required
  - `to` string, date, required
  - `totals` object, required
    - `orders` integer, required
    - `revenue` string, required: Decimal amount with two decimals, e.g. 1834.20
  - `by_source` object[], required: One row per AI assistant, highest revenue first
    - `source` string, required: AI assistant slug, e.g. chatgpt or perplexity
    - `name` string, required: Display name, e.g. ChatGPT
    - `orders` integer, required
    - `revenue` string, required
  - `series` object[], required: Days that have stored orders, oldest first
    - `day` string, date, required
    - `orders` integer, required
    - `revenue` string, required
  - `request_id` string, required

## Other responses

- `403`: The account has a white-label portal or an embed, so store integrations are not available (ERR_INTEGRATION_UNAVAILABLE). Writes with a read-only key answer ERR_INSUFFICIENT_SCOPE, and a team member without the permission ERR_INSUFFICIENT_PERMISSION, with the same status
- `404`: Resource not found
- `422`: Invalid parameters

## Changes

- **2026-10-04** `8698fcf9df22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/ai_orders/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)