R2 Developers
R2 Connect API

Account

Identifies which business the key belongs to, its currency and which scopes it holds.

GET/accountno scope required

Requires no scopes. Use it when your integration starts, to know who you are talking to and adjust what you will request based on scopes.

Response#

FieldTypeDescription
idstringBusiness identifier.
namestringTrade name.
verticalstringhospitality, gastronomy or experience.
currencystringBusiness currency in ISO 4217 format, for example MXN.
api_versionstringAPI version in use.
scopesarrayScopes held by this key.
key_prefixstringVisible key prefix, useful to identify it in your logs without exposing it.

Example#

bash
curl -H "Authorization: Bearer TU_LLAVE" "https://api.r2-os.com/api/connect/v1/account"
json
{
  "data": {
    "id": "k97fa2c8de1b04",
    "name": "Hotel Bahía del Sol",
    "vertical": "hospitality",
    "currency": "MXN",
    "api_version": "v1",
    "scopes": ["read:reservations", "read:payments"],
    "key_prefix": "r2k_a1b2c3d4"
  }
}