Retrieve a list of expenses
Get all your expenses, or use the query parameters to filter the results.
The expenses are sorted by the expense_date
value in reverse chronological order, and they're paginated.
The maximum number of expenses returned per page is specified by the count
parameter.
To get the next page of results, make a new request and use the expense_date
value from the last item of the previous page as the value for the to
parameter.
The API returns a maximum of 500 expenses per request.
To be compliant with PSD2 SCA regulations, businesses on the Revolut Business Freelancer plans can only access information older than 90 days within 5 minutes of the first authorisation.
This feature is not available in Sandbox.
To use the Expenses API, please contact Revolut API Support.
For more information, see the guides: Retrieve expenses and receipts.
Access Token
Each Business API request must contain an authorization header in the following format to make a call: Bearer <your_access_token>
.
The access token will be obtained the first time you set up your application and has an expiration of 40 minutes.
During setup, a refresh_token
will also be obtained which allows to obtain a new access_token
.
Never share your client-assertion JWT (JSON web token), access_token
and refresh_token
with anyone, as these can be used to access your banking data and initiate transactions.
Access tokens can be issued with four security scopes and require a JWT (JSON Web Token) signature to be obtained:
READ
: Permissions forGET
operations.WRITE
: Permissions to update counterparties, webhooks, and issue payment drafts.PAY
: Permissions to initiate or cancel transactions and currency exchanges.READ_SENSITIVE_CARD_DATA
: Permissions to retrieve sensitive card details.cautionIf you enable the
READ_SENSITIVE_CARD_DATA
scope for your access token, you must set up IP whitelisting. Failing to do so will prevent you from accessing any Business API endpoint.IP whitelisting means that you must specify an IP or a set of IPs which will be the only IPs from which requests to the API will be accepted. To do so:
- In the Revolut Business app, select the corresponding API certificate.
- In Production IP whitelist, provide the IP(s) which should be whitelisted, and save.
To configure your JWT and obtain the refresh and first access tokens, complete the following steps:
Request
Response
List of expenses