TEtectonic
Orders

Retrieve orders

Changed on

Retrieves orders.

get/order

Request

Query parameters

status'paid' | 'awaiting_payment'

Filter by order status.

test'only' | 'hide'

Filter by test order visibility.

  • only - Show only test orders.
  • hide - Exclude test orders.
seasonstring

Filter by season slug. Use all to show all seasons.

deleted'only' | 'included' | 'none'

Filter by deletion mode.

  • only - Show only deleted resources.
  • included - Include deleted resources.
  • none - Exclude deleted resources.
pagenumber

Specify the page number to return.

per_pagenumber

Limit the number of items returned to between 1 and 100.

If you provide a value outside this range, you will receive a 400 response.

order'created_at' | 'invoice_number' | 'payment_method' | 'payment_status' | 'season' | 'total'

Sort by a supported order field.

dir'asc' | 'desc'

Sort in ascending or descending order.

Headers

Accept'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml' required

Defines the response type.

x-api-languagestring[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Response

Orders retrieved.

current_pageinteger

Number of the page returned by this response. The first page is 1.

first_page_urlstring

URL of the first page in the result set. Relative when the requested page is beyond the last page.

frominteger nullable

Position of the first record on this page within the full result set. The first record is at position 1. null when the requested page is beyond the last page.

last_pageinteger

Number of the last page. Equals the total number of pages.

last_page_urlstring

URL of the last page in the result set. Relative when the requested page is beyond the last page.

next_page_urlstring

URL of the next page in the result set.

Empty string when the current page is the last page.

pathstring

Canonical URL of the endpoint, without query parameters.

per_pageinteger

Maximum number of records returned per page.

prev_page_urlstring

URL of the previous page in the result set.

Empty string when the current page is the first page.

tointeger nullable

Position of the last record on this page within the full result set. null when the requested page is beyond the last page.

totalinteger

Total number of records across all pages.

Example response

{
  "current_page": 1,
  "data": [
    {
      "address": "12 Example Street",
      "city": "London",
      "comments": "",
      "company": "Example Productions Ltd",
      "country": "United Kingdom",
      "created_at": "2026-01-15T09:00:00Z",
      "currency": "GBP",
      "discount": 0,
      "discount_code": "",
      "e_invoice_status": "none",
      "invoice_number": "INV-001234",
      "ip_address": "203.0.113.42",
      "items": "<ul><li>Standard entry &times; 1 &mdash; &pound;50.00</li></ul>",
      "items_array": [
        {
          "amount": "£50.00",
          "description": "Standard entry",
          "discount": "£0.00",
          "entry": {
            "slug": "AbCdEfGh",
            "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
            "title": "Sustainable Cities Initiative"
          },
          "item_type": "entry",
          "name": "Standard entry",
          "price": {
            "slug": "IjKlMnOp",
            "link": "https://api.au.cr4ce.com/price/IjKlMnOp",
            "title": {
              "en_GB": "Standard entry"
            }
          },
          "quantity": 1
        }
      ],
      "member_number": "",
      "payment_method": "card",
      "payment_status": "paid",
      "postcode": "EC1A 1BB",
      "processing_fee": 1.5,
      "processing_fee_rate": 3,
      "region": "",
      "season": {
        "slug": "QrStUvWx",
        "link": "https://api.au.cr4ce.com/season/QrStUvWx",
        "name": {
          "en_GB": "2025"
        }
      },
      "slug": "YzAbCdEf",
      "state": "",
      "subtotal": 50,
      "tax": 10,
      "tax_rate": 20,
      "tax_rate_details": {
        "country": "GB",
        "link": "https://api.au.cr4ce.com/tax/GhIjKlMn",
        "name": "VAT",
        "rate": 20,
        "region": null,
        "slug": "GhIjKlMn",
        "term": "VAT"
      },
      "tax_term": "VAT",
      "total": 61.5,
      "transaction_date": "2026-01-15T09:01:00Z",
      "transaction_provider": "stripe",
      "transaction_reference": "REDACTED",
      "transaction_status": "succeeded",
      "user": {
        "slug": "OpQrStUv",
        "link": "https://api.au.cr4ce.com/user/OpQrStUv",
        "name": "Jane Smith",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane.smith@example.com"
      },
      "vat_number": "GB123456789"
    }
  ],
  "first_page_url": "https://api.au.cr4ce.com/order?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "https://api.au.cr4ce.com/order?page=1",
  "next_page_url": "",
  "path": "https://api.au.cr4ce.com/order",
  "per_page": 10,
  "prev_page_url": "",
  "to": 1,
  "total": 1
}

Changes

  • v2e2511e46f9f2Revision changes
    • breaking

      for the query request parameter page, the type changed from string to number

    • breaking

      for the query request parameter per_page, the type changed from string to number

    • info

      the response's property default value 10 was added for the status (media type: application/json)

    • info

      the response's property default value 10 was added for the status (media type: application/xml)

  • v2a269ebb35abfRevision changes
    • breaking

      the response property / became nullable for the status (media type: application/json)

    • breaking

      the response property / became nullable for the status (media type: application/xml)

    • breaking

      the response property / became nullable for the status (media type: application/json)

    • breaking

      the response property / became nullable for the status (media type: application/xml)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/json)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/xml)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/json)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/xml)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/json)

    • breaking

      the / response's property format changed from uri to no format for status (media type: application/xml)