List Transactions

get

https://api.orderful.com/transactions

Returns your organization's Transactions — inbound and outbound, across every trading relationship — sorted in descending order by their creation date. A maximum of 100 Transactions are returned per page; follow metadata.pagination.links.next to paginate through the rest.

Every item carries ready-built links to the Transaction itself, its acknowledgment, and its message content, so you never need to assemble URLs from IDs.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

prevCursor

string

If results are paginated, this will point to the previous set of results.

nextCursor

string

If results are paginated, this will point to the next set of results.

limit

integer

1 to 100

Defaults to 100

How many Transactions to return per page. Defaults to 100.

direction

array of strings

Return only Transactions your organization received (in) or sent (out).

direction

Allowed:

businessNumber

array of strings

length ≤ 5

The business number(s) to filter by — the identifier the document carries in your business, for example an invoice or purchase order number. You may indicate up to 5 values, each up to 100 characters.

businessNumber

validationStatus

array of strings

The one or more validation status(es) you would like to filter by.

validationStatus

Allowed:

deliveryStatus

array of strings

The one or more delivery status(es) you would like to filter by.

deliveryStatus

Allowed:

acknowledgmentStatus

array of strings

The one or more acknowledgment status(es) you would like to filter by.

acknowledgmentStatus

Allowed:

stream

array of strings

Indicates whether you want results from the test and/or live stream. Note the lowercase values — this differs from the v3 list, which uses TEST/LIVE.

stream

Allowed:

ediTransactionType

array of strings

length ≤ 5

The EDI transaction type(s) to filter by, for example 810_INVOICE. You may indicate up to 5 Transaction Types. When combined with simplifiedTransactionType, a Transaction must match both filters.

ediTransactionType

simplifiedTransactionType

array of strings

Filter by business name instead of EDI transaction type, for example INVOICE to match every invoice type at once. For the full mapping, see Mosaic Schemas.

simplifiedTransactionType

senderId

array of strings

length ≤ 5

The sender ISA ID(s) to filter by, matched against the senderId field. You may indicate up to 5 values.

senderId

receiverId

array of strings

length ≤ 5

The receiver ISA ID(s) to filter by, matched against the receiverId field. You may indicate up to 5 values.

receiverId

createdAtStart

string

Return only Transactions created at or after this ISO 8601 timestamp, for example 2026-05-26T00:00:00.000Z.

createdAtEnd

string

Return only Transactions created at or before this ISO 8601 timestamp, for example 2026-05-27T00:00:00.000Z.

Headers

orderful-api-key

string

required

Your Orderful API key.

orderful-api-version

string

required

Defaults to v4

Specifies the API version to use. This endpoint requires v4; omitting the header returns 404.

Responses

400

A filter is invalid — an unknown enum value, more than 5 values where 5 is the maximum, a limit outside 1–100, or a timestamp that is not ISO 8601.

404

The orderful-api-version: v4 header is missing.

200List of transactions, newest first.