List account movements

Find account movement requests to review transfers, identify requests awaiting approval or investigate activity during a particular period.

Use the returned AccountMovementId to retrieve a movement or approve or cancel a pending request.

Endpoints

EnvironmentMethod and URL
StagingGET https://staging-api.vitessepsp.com/api/accountmovements
Production – UK HubGET https://api.vitessepsp.com/api/accountmovements
Production – US HubGET https://api.us.vitesse.io/api/accountmovements

For help choosing an environment, see Environment.

Access requirements

Configure the following access:

OAuth scopeIdentity client role
APIAccountMovements.Lookup

For more information about scopes, see Authentication. For information about the access granted by specific roles, see Identity client roles.

Query parameters

Use these parameters to set the result count and, optionally, filter movements by maximum ID, date range, or entry ID range.

ParameterWhen to use it
CountSet the maximum number of movements to return. The default is 25; the accepted range is 1 to 100.
MaxIdFilter by a maximum movement ID.
StartDateSet the start of a date range. Use with EndDate.
EndDateSet the end of a date range. Use with StartDate.
StartEntryIdSet the first entry ID in a range. Use with EndEntryId.
EndEntryIdSet the last entry ID in a range. Use with StartEntryId.

Provide both bounds for a date or entry ID range. Use at most one of MaxId, a date range, or an entry ID range.

Send the request

This example uses Staging:

curl --request GET \
  --url 'https://staging-api.vitessepsp.com/api/accountmovements' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Accept: application/json'

Replace <access-token> with a valid access token that contains the required scope, and any example values with your own details.

Filter the results

Use the following query parameters to narrow the results:

Query parameterUse
request.startDateInclude movements created on or after this date and time.
request.endDateInclude movements created on or before this date and time.
request.startEntryIdInclude movements within an entry ID range, starting at this value.
request.endEntryIdInclude movements within an entry ID range, ending at this value.

This example requests up to 100 movements created between 09:00 and 17:00 UTC on 6 October 2026:

curl --request GET \
  --url 'https://staging-api.vitessepsp.com/api/accountmovements?request.startDate=2026-10-06T09%3A00%3A00Z&request.endDate=2026-10-06T17%3A00%3A00Z&request.count=100' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Accept: application/json'

For date and time conventions, see Data formats.

Set the page size

The endpoint returns movements in pages. Use request.count to request up to 100 movements per page.

The specification also provides request.maxId for paging by identifier. Following the next-page URL avoids constructing the paging query yourself.

For all query parameters, see List account movements in the API Reference.

Expected response

A successful request returns 200 OK. The AccountMovements array contains the movement requests returned for the page.

Check each movement’s Status to identify pending requests or completed transfers. Use its references to match the movement to your records.

Retrieve further pages

A single response might not contain every movement matching your request.

If the Links array includes a Next Page URL, request that URL with your access token in the Authorization header. Continue following next-page links until the response no longer provides one.

Troubleshoot the request

If the request fails, use the returned HTTP status code to identify the likely cause and corrective action.

If Vitesse returns 200 OK with an empty AccountMovements array, check your filters or remove them to broaden the search.

If you supply a date or entry ID range, check that the start does not exceed the end.

For error response formats, additional HTTP status codes and error-handling guidance, see Error responses.

Next steps

To view an account movement’s details, use Retrieve an account movement. To create an account movement, use Create an account movement. To approve or cancel it, use Approve or cancel an account movement​.