---
title: "List all purchase orders"
method: GET
path: "/billing/v1/orders"
tags: ["PurchaseOrder"]
---

# List all purchase orders

`GET /billing/v1/orders`

## Request

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

List all purchase orders

## Query parameters

- `startDateFrom` number
- `startDateTo` number
- `status` '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'
- `currency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN'
- `type` 'NEW' | 'MIGRATION' | 'ADOPTION' | 'FREE_TRIAL_ACTIVATION' | 'TERMINATION_FEE' | 'END_OF_CONTRACT_MIGRATION' | 'REFUND' | 'CREDIT' | 'ONE_TIME_FEE' | 'ADDITIONAL_FEE' | 'END_OF_DISCOUNT_MIGRATION' | 'METERED_USAGE'
- `frequency` 'ONE_TIME' | 'MONTHLY' | 'QUARTERLY' | 'SIX_MONTHS' | 'YEARLY' | 'TWO_YEARS' | 'THREE_YEARS' | 'DAILY'
- `orderReferenceCode` string
- `applicationIds` number
- `fromCreationDate` number
- `toCreationDate` number
- `page` integer
- `referenceCode` string
- `size` integer
- `sortField` 'DATE' | 'ORDER_ID' | 'TOTAL'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

OK

- OrderListingWS, nullable: Resource links
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `_embedded` object, nullable
  - `company` LinkWS, nullable
    - `href` string
    - `id` string
  - `currency` string, nullable: Currency.
  - `endDate` number, nullable: Order end date.
  - `endOfDiscountDate` number, nullable: Discount end date.
  - `frequency` string, nullable: Frequency.
  - `id` number, nullable: ID.
  - `parentSubscriptionId` number, nullable: Parent subscription ID of an add-on subscription
  - `serviceStartDate` number, nullable: Service start date for the order
  - `nextBillingDate` number, nullable: Next billing date for the order
  - `referenceCode` string, nullable: Reference code
  - `salesSupportUser` LinkWS, nullable
    - `href` string
    - `id` string
  - `salesSupportCompany` LinkWS, nullable
    - `href` string
    - `id` string
  - `startDate` number, nullable: Order start date
  - `status` string, nullable: Order status
  - `totalPrice` number, nullable: Total price for the order
  - `type` string, nullable: Type.
  - `user` LinkWS, nullable
    - `href` string
    - `id` string
  - `paymentPlan` LinkWS, nullable
    - `href` string
    - `id` string

## Other responses

- `404`: Not Found

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/billing/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)