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

EnvironmentEndpoint
StagingGET https://staging-api.vitessepsp.com/api/accountmovements/{accountMovementId}
Production – UK HubGET https://api.vitessepsp.com/api/accountmovements/{accountMovementId}
Production – US HubGET 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 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.

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 Status to determine whether the request is pending, approved, completed, cancelled or expired.
  • Check ExpiresOn before 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.