# Retrieve all Orders

**GET /orders**

Returns a list of all Orders associated with the authenticated User's Account. Reserved to Users with the `Admin`, `Purchaser` or `Owner` role.



## Servers
- Production: https://zim.api.zimconnections.com (Production)
- Sandbox: https://zim.api.dev.zimconnections.com (Sandbox)


## Authentication methods
- Oauth2 & App identifier


## Parameters




## Responses
### 200
Orders fetched successfully

#### Body: application/json (array[object])
- **id** (string)
  The Order's ID

- **status** (string)
  Statuses:
    * `PENDING_APPROVAL` - The Order is awaiting approval from an Admin / Purchaser / Owner
    * `PENDING_PAYMENT` - The Order is awaiting payment from the User
    * `PROCESSING` - The Order is being processed by the network and should soon be fulfilled
    * `FULFILLED` - The Order has been fulfilled and the associated Subscription / eSIM is ready
    * `CANCELLED` - The Order has been cancelled by the User
    * `FAILED` - The Order has failed — see `failureReason` for details
    * `REPLACED` - The Order has been superseded by a newer one
    * `IN_BASKET` - The Order is currently sitting in the User's basket

- **accountID** (string)
  The Account ID linked to the Order

- **planID** (string)
  The Plan ID linked to the Order

- **userID** (string)
  The User ID for which the Order was generated

- **type** (string)
  Types:
    * `ONE_OFF` - The Order is a one-off purchase
    * `TOP_UP` - The Order tops up an existing Subscription
    * `RECURRING` - The Order is part of a recurring Subscription

- **paymentID** (string)
  The Payment ID linked to the Order, when applicable

- **paymentReference** (string)
  The external payment reference

- **notifyRecipient** (boolean)
  If `true`, the end User has been (or will be) notified about this Order

- **failureReason** (string)
  Set when `status` is `FAILED` — explains why the Order could not be fulfilled

- **plan** (object)

- **subscription** (object)

- **createdAt** (string(date-time))

- **updatedAt** (string(date-time))



[Powered by Bump.sh](https://bump.sh)