Get Requests

get

https://public-api.spendesk.com/v1/requests

Allowed Scopes: experimental:request:read
Returns requests for the authenticated company.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

integer

required

≥ 1

Defaults to 1

Page number

pageSize

integer

required

1 to 30

Defaults to 30

Page size

type

string

enum

Filter by request type.

Allowed:

state

string

enum

Filter by request state.

requesterId

string

Filter by requester user ID.

supplierId

string

Filter by supplier ID.

createdAfter

string

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

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

createdBefore

string

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

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

minAmount

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.

maxAmount

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.

withApproval

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.

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Default Response

400Bad request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests

500Internal Server Error