---
title: "Retrieve Orders per Account"
method: GET
path: "/v2/{account_id}/orders"
---

# Retrieve Orders per Account

`GET /v2/{account_id}/orders`

## Request

- Base URL: `https://developers.yotpo.com`
- URL: `https://developers.yotpo.com/v2/{account_id}/orders`
- Auth: API key in header `X-Yotpo-Token`

Retrieves the orders Yotpo holds for the store, newest first by `order_date`. For full order data with line items and fulfillments, use [Retrieve Orders](ref:retrieve-orders2).

## Path parameters

- `account_id` string, required

## Query parameters

- `page` integer
- `count` integer

## Response `200`

200

- object
  - `status` object: Request status.
    - `code` integer: HTTP status code.
    - `message` string: Status message, such as `OK`.
  - `pagination` object: Paging details.
    - `page` integer: The current page number.
    - `count` integer: The page size: the `count` you sent, capped at `total`.
    - `total` integer: Total number of orders for the store.
  - `orders` object: The orders on this page.
    - `purchases` object[]: Orders, newest first by `order_date`.
      - `id` integer: Always `0`. Use `order_id` to identify the order.
      - `user_email` string: The customer's email address.
      - `user_name` string: The customer's name.
      - `order_id` string: The order ID in the store's ecommerce platform.
      - `external_product_id` string: The product ID in the store's ecommerce platform. Can be an empty string.
      - `product_url` string: The URL of the product page.
      - `order_date` string, date-time: When the order was placed (ISO 8601, UTC).
      - `product_description` string: The product description. Can be an empty string.
      - `created_at` string, date-time: When Yotpo recorded the order (ISO 8601, UTC).

## Other responses

- `400`: 400
- `401`: Missing or invalid access token. Send a valid token in the `X-Yotpo-Token` header.

## Changes

- **2026-11-03** `5bcae8239b6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yotpo/apis/app-developer-api/changes/v2/:account_id/orders/get.md)

---

[API](https://skmtc.dev/yotpo/apis/app-developer-api.md) - [All operations](https://skmtc.dev/yotpo/apis/app-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/app-developer-api/revisions/5bcae8239b6e?raw)