Get Requests

Allowed Scopes: experimental:request:read
Returns card requests for the authenticated company. Only these request types are listed: single_purchase, subscription, multi_use_card, multi_use_card_top_up, multi_use_card_end_date_change and card_load. Other request types, such as purchase-order, invoice, expense, mileage, per diem and travel requests, are not returned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 1
Defaults to 1

Page number

integer
1 to 30
Defaults to 30

Page size

string
enum

Filter by request type.

Allowed:
string
enum

Filter by request state.

string

Filter by requester user ID.

string

Filter by supplier ID.

date
^\d{4}-\d{2}-\d{2}$

Return requests created on or after this date (YYYY-MM-DD, UTC).

date
^\d{4}-\d{2}-\d{2}$

Return requests created on or before this date (YYYY-MM-DD, UTC).

number

Filter by minimum requested amount, in major units. Compared against the request's amount converted to the company's functional currency using stored exchange rates.

number

Filter by maximum requested amount, in major units. Compared against the request's amount converted to the company's functional currency using stored exchange rates.

boolean
Defaults to false

Include the approval object on each returned request. Off by default because resolving the approval chain costs an extra lookup per page.

Headers
string

ID of the company the request acts on. Required with an organisation-level token; not needed with a company-level token.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json