Skip to content

Account

Retrieve your account

Returns the store the API key belongs to and the environment of the key.

GET/v1/account

Any valid API key may call this endpoint, whatever its scopes.

Any valid key can call it, whatever its scopes: it is the simplest way to check that a key works.

curl https://api.rais.app/v1/account \
  -H "Authorization: Bearer rais_sk_test_..."
Response200
{
  "object": "account",
  "id": "7d0b6a3e-1c52-4f8e-9a44-2b6e8f1d0c35",
  "name": "Boutique Alger",
  "livemode": false,
  "live_enabled": false,
  "currency": "DZD",
  "payment_page": "rais"
}

Request

This endpoint takes no parameters.

Response

200Your store.

Returns the Account object.

Errors

StatusCodeExample message
401invalid_api_keyInvalid API key provided.
403insufficient_scopeThis API key does not have the 'payments:write' permission.
403account_disabledThis store is suspended or disabled.
403live_mode_not_enabledComplete business verification to take live payments.
429rate_limit_exceededToo many requests. Slow down and retry after the delay in the Retry-After header.
500internal_errorSomething went wrong on our side. Quote the request id to support.

Every error has the same envelope. See Errors.