Retrieve an account movement
Check an account movement when you know its AccountMovementId. Use this endpoint to review a pending request before approval, investigate a transfer or check whether processing has completed.
Endpoints
| Environment | Endpoint |
|---|---|
| Staging | GET https://staging-api.vitessepsp.com/api/accountmovements/{accountMovementId} |
| Production – UK Hub | GET https://api.vitessepsp.com/api/accountmovements/{accountMovementId} |
| Production – US Hub | GET https://api.us.vitesse.io/api/accountmovements/{accountMovementId} |
Replace {accountMovementId} with the movement’s AccountMovementId.
For help choosing an environment, see Environment.
Access requirements
Configure the following access:
| OAuth scope | Identity client role |
|---|---|
API | AccountMovements.Lookup |
For more information about scopes, see Authentication. For information about the access granted by specific roles, see Identity client roles.
Send the request
This example uses Staging to retrieve movement 98321:
curl --request GET \
--url 'https://staging-api.vitessepsp.com/api/accountmovements/98321' \
--header 'Authorization: Bearer <access-token>' \
--header 'Accept: application/json'Replace 98321 with your movement’s identifier and <access-token> with a valid access token containing the API scope.
Expected response
A successful request returns 200 OK with the movement details.
Use the response to:
- Check the debit and credit accounts, amounts, exchange rate and fee.
- Match the movement to your records using its references.
- Check
Statusto determine whether the request is pending, approved, completed, cancelled or expired. - Check
ExpiresOnbefore approving a pending request.
An Approved status does not confirm completion. Check for Completed to confirm that Vitesse has completed the movement.
Troubleshoot the request
If the request fails, use the returned HTTP status code to identify the likely cause and corrective action.
If Vitesse returns 404 Not Found, check the movement identifier and the identity client’s access. If you have not previously used account movements, contact Support to check whether the feature is enabled for your organisation.
For error response formats, additional HTTP status codes and error-handling guidance, see Error responses.
Next steps
If the account movement is pending and you want to proceed, approve it before ExpiresOn. Otherwise, you can cancel a Pending account movement. Use Approve or cancel an account movement. To view multiple movements, use List account movements.
Updated 18 days ago