---
title: "List orders"
method: GET
path: "/appReseller/v1/orders"
tags: ["AppResellerOrder"]
---

# List orders

`GET /appReseller/v1/orders`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/appReseller/v1/orders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/appReseller/v1/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all user orders of a linked company. You can filter the list using optional query parameters.

## Query parameters

- `context` 'RESELLER, RESELLER_MANAGER', required
- `number` integer
- `size` integer
- `sort` string
- `userId` string
- `resellerCompanyId` string, required
- `customerCompanyId` string, required
- `createdOn` string
- `status` string
- `paidStatus` 'PAID, FREE'
- `pending` boolean
- `searchText` string

## Response `200`

Success

- OrderPagedReadResponse
  - `page` PageMetadata, required
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages
  - `content` OrderPagedReadItem[], required: List of orders
    - `id` string, required: Order ID
    - `createdOn` number, required: Creation date of the order, in Unix timestamp format
    - `status` string, required: Order status (valid values are INITIALIZED, PENDING_USER_APPROVAL, PENDING_REMOTE_CREATION, PENDING_MANUAL_RECOVERY, PENDING_ASYNCHRONOUS_CREATION, FREE_TRIAL, ACTIVE, FINISHED, ONE_TIME, CANCELLED, SUSPENDED, FREE_TRIAL_EXPIRED, FREE_TRIAL_CANCELLED, DELETED, FAILED, UPCOMING, PENDING_MIGRATION_ACTIVATION, PENDING_DELAYED_PROVISIONING)
    - `frequency` string, required: Frequency (valid values are MONTHLY, QUARTERLY, SIX_MONTHS, YEARLY, TWO_YEARS, THREE_YEARS, DAILY)
    - `totalFee` string, required: Total fee for the order
    - `editionName` string, required: Edition name
    - `orderCartId` string: Order cart ID
    - `applicationName` string, required: Application name
    - `company` CompanyAssociation, required: A minimum version of a company: includes only the company ID and name
      - `id` string, required: Company ID
      - `name` string, required: Company name

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `content` to the response with the `200` status
  - added the required property `page` to the response with the `200` status

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appReseller/v1/orders/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)