Skip to main content
GET
List orders
This endpoint is paginated and supports cursor based pagination. Each response includes a next_cursor and previous_cursor which can be used to fetch the next and previous pages of results. The orders returned only contain a subset of the fields that are returned for a single order. To fetch the full details of an order use the single order get endpoint. This endpoint can return both complete and incomplete orders. The types of these responses differ, you should use the status field to determine which type of response you are receiving.
  • Completed orders will have a status of COMPLETED or FAILED and have a full response body.
  • Incomplete orders will have a status of PROCESSING and have a partial response body.

Authorizations

X-Api-Key
string
header
required

Your API key. See the API key page on details of how to generate and store your keys.

Headers

X-Api-Version
enum<string>
default:2024-02-05

The dated version of the API, if not specified a default is used. See API versioning for more information. The dated version of the Runa API. Send it on every request: a client that omits it silently follows whatever the server default happens to be.

Available options:
2024-02-05

Query Parameters

limit
integer
default:100

Number of orders per page, 1 to 500.

Required range: 1 <= x <= 500
before
string

A cursor for use in pagination to return the previous set of results. The before and after cursors are mutually exclusive (you can't use them at the same time). You can get a value from the pagination.cursors.before field in the response. See pagination for more information.

Example:

"A-123"

after
string

A cursor for use in pagination to return the next set of results. The before and after cursors are mutually exclusive (you can't use them at the same time). You can get a value from the pagination.cursors.after field in the response. See pagination for more information.

Example:

"A-789"

Response

OK

items
(Order summary · object | Processing order · object)[]
required

The list of orders in the page.

Used for orders that have completed. This class is typically used when returning a list of orders to the client.

pagination
Pagination · object
required

Metadata of the result page.