Get Account

Once a Veem account has been opened, you can fetch the account's information using the account id that you received from the Open Account endpoint. The endpoint is as follows:

GET https://sandbox-api.veem.com/veem/v1.2/account/{accountId}

Note: If coming directly from the Open Account flow, use the value from the id field and not from the userId field

Headers

There are 2 headers necessary for the use of this endpoint:

X-request-id: This is a number unique to the current API request, and follows the UUID format. Reusing this header without changing the value will result in a 500 (Internal Server Error) status. An example X-request-id is as follows:

Authorization: This header holds the bearer token required to use Veem's public API. Failure to use a valid bearer token will result in a 404 (Not Found) status. An example of a valid token is as follows:

Response Payload

When using the endpoint, one can expect to receive a response following the format below:

{
    "id": 374999,
    "email": "[email protected]",
    "clientId": "APITesting-98c22708",
    "clientSecret": "d7f4f648-2102-4e0a-9108-7a5e94d7dfa7",
    "token": "d51948db-6da6-499e-9af5-bb48767145f5"
    "accountSetUpStatus": "READY",
    "verificationStatus": "Unverified",
}

The following table will provide extra information on some of these parameters:

Response Parameter	Explanation
id	This is the ID provided with the Veem account
email	Email associated with the veem account
accountSetUpStatus	When an account is ready to send payments, the field will be "READY", otherwise it will be "MISSING_INFORMATION". Note that an account could be READY, but first requires verification before it is able to send payments
verificationStatus	Starts as "Unverified", and will change to "Verified" once the account has been verified by Veem's verification team

To get account status you can also use Webhook, check this page