Ir al contenido

Who am I and what can this key do

GET/tenant/meProbar

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET
/tenant/me
curl --request GET \
--url http://localhost:3000/v1/tenant/me \
--header 'x-api-key: <x-api-key>'

No scope required: what it returns is the context of the key itself. It is the first thing to call when integrating, to confirm the mode (test/live) and the scopes are the ones you expect.

Contexto de la key

Media typeapplication/json
object
tenantId
string
name
string
mode
string
Allowed values: test live
environment

Entorno de la CUENTA (no de la key). sandbox = cuenta separada para probar: nunca tiene keys live. Una key test de una cuenta production comparte la contabilidad de la cuenta real.

string
Allowed values: sandbox production
scopes
Array<string>
apiKeyId
string
isPlatform

false en una key de cliente

boolean
apiVersion

La versión de la API de tu cuenta (PUT /tenant/api-version).

string
Example
{
"tenantId": "3f1a0c22-9b41-4a77-8f0e-6d2c5b7a1e34",
"name": "Fintech Ejemplo",
"mode": "live",
"environment": "production",
"scopes": [
"quotes:write",
"beneficiaries:read",
"beneficiaries:write",
"payments:read",
"payments:write",
"treasury:read",
"events:read",
"events:write"
],
"apiKeyId": "5c9d2b70-1f44-4c8e-9a3b-2e7f0d5a6b18",
"isPlatform": false,
"apiVersion": "2026-11-03"
}