Orders

get

Authorizations

Query parameters

fromstringOptional

Earliest date/time to return. Suggested format YYYY-MM-DDTHH:MM:SSZ, e.g. 2018-01-01T00:00:00Z. System time zone is UTC.

tostringOptional

Latest date/time to return. See 'from' above for format.

canvas_user_idstringOptional

Return only orders for the specified Canvas user ID

completedstringOptional

When set, only return orders that were completed successfully

Responses

Responseobject

get

HTTPcURLJavaScriptPython

GET /api/v1/orders HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Accept: */*

200

Listing orders

{
  "orders": [
    {
      "id": 2,
      "full_id": "2",
      "catalog_id": 41,
      "catalog": {
        "id": 41,
        "name": "Domain Account 49"
      },
      "user": {
        "id": 1,
        "name": "Saul Goodman",
        "email": "[e-mail]"
      },
      "listings": [
        {
          "id": 33,
          "canvas_course_id": 18,
          "title": "Course 32",
          "amount": "100.0",
          "discounted_amount": "90.0",
          "catalog_id": 41
        }
      ],
      "promotions": [
        {
          "id": 5,
          "listing_id": 33,
          "code": "PROMO5",
          "amount": "-10.0"
        }
      ],
      "payments": [
        {
          "reference_id": "123",
          "status": "success",
          "amount": "90.0"
        }
      ],
      "total": "90.0",
      "currency": "USD",
      "purchased_at": "2025/03/28 13:11:24 +0000",
      "created_at": "2025/03/28 13:11:24 +0000"
    }
  ]
}

get

Authorizations

Path parameters

idintegerRequired

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/orders/{id} HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Accept: */*

200

Getting a specific order

{
  "order": {
    "id": 3,
    "full_id": "3",
    "catalog_id": 42,
    "catalog": {
      "id": 42,
      "name": "Domain Account 50"
    },
    "user": {
      "id": 1,
      "name": "Saul Goodman",
      "email": "[e-mail]"
    },
    "listings": [
      {
        "id": 34,
        "canvas_course_id": 19,
        "title": "Course 33",
        "amount": "100.0",
        "discounted_amount": "90.0",
        "catalog_id": 42
      }
    ],
    "promotions": [
      {
        "id": 6,
        "listing_id": 34,
        "code": "PROMO6",
        "amount": "-10.0"
      }
    ],
    "payments": [
      {
        "reference_id": "123",
        "status": "success",
        "amount": "90.0"
      }
    ],
    "total": "90.0",
    "currency": "USD",
    "purchased_at": "2025/03/28 13:11:24 +0000",
    "created_at": "2025/03/28 13:11:24 +0000"
  }
}