APappdirect
AppResellerOrder

List orders

Changed on

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

get/appReseller/v1/orders

Request

Query parameters

context'RESELLER, RESELLER_MANAGER' required

Supported billing contexts

numberinteger

Page number

sizeinteger

Number of results per page

sortstring

Sort field and order. For ascending sort order, use the '+[FieldName]' format. For descending order, use the '-[FieldName]' format.

userIdstring

For RESELLER, the customer's user ID; for RESELLER_MANAGER, the Reseller's user ID

resellerCompanyIdstring required

Reseller's company ID. Required only for the RESELLER_MANAGER context.

customerCompanyIdstring required

User's company ID. Required only for the RESELLER context.

createdOnstring

Date filter, defined by upper or lower inclusive or exclusive limits, in Unix timestamp format. Acceptable values are: gte([timestamp]) - 'greater than or equal to'; gt([timestamp]) - 'greater than'; lte([timestamp]) - 'less than or equal to'; or lt([timestamp]) - 'less than.'

statusstring

Order status (valid status 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)

paidStatus'PAID, FREE'

Status of the subscription related to the payment of this order

pendingboolean

Indicates whether order has pending events

searchTextstring

Search text

Response

Success

Example response

{
  "content": [
    {
      "id": "1234",
      "createdOn": 1529083173000,
      "status": "ACTIVE",
      "frequency": "One Time",
      "totalFee": "USD350.00",
      "applicationName": "AUTO_DISCOUNTS_APP",
      "editionName": "Edition",
      "orderCardId": "4567",
      "company": {
        "id": "698555fc-bc65-4163-9fee-16308edec41b",
        "name": "Company A"
      }
    },
    {
      "id": "4567",
      "createdOn": 1529083173000,
      "status": "PENDING MANUAL RECOVERY",
      "frequency": "One Time",
      "totalFee": "USD350.00",
      "applicationName": "AUTO_DISCOUNTS_APP",
      "editionName": "Edition",
      "orderCardId": "4567",
      "company": {
        "id": "386626c0-53e2-4515-8450-4a720bb5d029",
        "name": "Company B"
      }
    }
  ],
  "page": {
    "size": 10,
    "totalElements": 2,
    "totalPages": 1,
    "number": 1
  }
}

Changes

  • 1fc240f06971Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status