Datos

Endpoints de solo lectura para mostrar los usuarios, roles y actividad de tu app en tu propio backend o panel de administración. Solo devuelven datos de la app dueña del token.

Envía un token de acceso en cada petición: Authorization: Bearer <accessToken>. Las listas están paginadas y los errores siguen el formato común.

GET/api/app

Obtener la app

Devuelve el dominio de tu app y la configuración del widget de login que definiste en el Dashboard: textos en cada idioma, proveedores de login, módulos y sus parámetros. Si no la has personalizado, recibes la configuración por defecto.

Petición

GET

/api/app

curl https://wss.block-auth.io/api/app \
  -H 'Authorization: Bearer your_access_token'

Respuesta

{
  "success": true,
  "message": {
    "domain": "your-app.com",
    "config": {
      "content": {
        "title": { "en": "…", "es": "…" }
      },
      "google": { "enabled": true }
    },
    "modules": {
      "kyc": { "enabled": false, "mode": "none" }
    },
    "params": {}
  }
}

GET/api/user

Obtener un usuario

Devuelve el perfil de un usuario que ha iniciado sesión en tu app, con sus roles.

Los datos personales (nombre, documento, email, teléfono, dirección postal, datos de nacimiento…) son null salvo que tu app los solicite en el Dashboard y el usuario haya aceptado compartirlos.

Parámetros

Name
address
Type
string
Description
La dirección del usuario, tal como la recibiste en el login.

Errores

L1 User not found si la dirección no existe y User not signed yet si nunca ha iniciado sesión en tu app.

Petición

GET

/api/user

curl 'https://wss.block-auth.io/api/user?address=0x7F85…46D8' \
  -H 'Authorization: Bearer your_access_token'

Respuesta

{
  "success": true,
  "message": {
    "items": [
      {
        "address": "0x7F85…46D8",
        "did": "0x7F85…46D8",
        "alias": "alice",
        "firstname": null,
        "email": "alice@example.com",
        "roles": [
          { "slug": "acme-x7k2p9", "name": "Admin" }
        ]
      }
    ]
  }
}

GET/api/users

Listar usuarios

Usuarios que han iniciado sesión en tu app, del más reciente al más antiguo.

Parámetros

Name
page
Type
number
Description
Página que quieres, desde 1. Por defecto 1.
Name
limit
Type
number
Description
Resultados por página, de 1 a 100. Por defecto 100.
Name
search
Type
string
Description
Parte de una dirección.
Name
fromServices
Type
string
Description
Solo usuarios que iniciaron sesión con estos métodos, separados por comas: blockauth, google, microsoft, metamask, phantom.

Cada elemento

Name
id
Type
number
Description
ID del usuario en tu app.
Name
user_address
Type
string
Description
La dirección del usuario.
Name
user_first_used_at
Type
string
Description
Primer login en tu app (UTC).
Name
user_last_used_at
Type
string
Description
Último login en tu app (UTC).
Name
user_total_txns
Type
number
Description
Número de operaciones del usuario en tu app.
Name
user_services_names
Type
array
Description
Métodos de login que ha usado el usuario.
Name
roles
Type
array
Description
Los roles del usuario, como { slug, name }.

Petición

GET

/api/users

curl 'https://wss.block-auth.io/api/users?page=1&limit=20&fromServices=blockauth,google' \
  -H 'Authorization: Bearer your_access_token'

Respuesta

{
  "success": true,
  "message": {
    "pages": 1,
    "total": 1,
    "items": [
      {
        "id": 42,
        "user_address": "0x7F85…46D8",
        "app_name": "Mi app",
        "user_total_txns": 12,
        "user_first_used_at": "2026-09-02T10:14:00.000Z",
        "user_last_used_at": "2026-11-10T08:31:00.000Z",
        "user_services_names": ["blockauth"],
        "roles": [
          { "app_user_id": 42, "rol_id": 3, "slug": "acme-x7k2p9", "name": "Admin" }
        ]
      }
    ]
  }
}

GET/api/roles

Listar roles

Los roles que creaste en el Dashboard para tus usuarios. Usa el slug en tu código: el name es solo para mostrar. Consulta Roles para usarlos en tu interfaz.

Parámetros

Name
page
Type
number
Description
Página que quieres, desde 1. Por defecto 1.
Name
limit
Type
number
Description
Resultados por página, de 1 a 100. Por defecto 100.
Name
search
Type
string
Description
Parte del nombre, el slug o la descripción.

Petición

GET

/api/roles

curl 'https://wss.block-auth.io/api/roles?page=1&limit=100' \
  -H 'Authorization: Bearer your_access_token'

Respuesta

{
  "success": true,
  "message": {
    "pages": 1,
    "total": 1,
    "items": [
      {
        "id": 3,
        "slug": "acme-x7k2p9",
        "name": "Admin",
        "description": "Acceso total",
        "public": 0
      }
    ]
  }
}

GET/api/logs

Listar actividad

Logins, logouts y otras operaciones de tus usuarios en tu app, de la más reciente a la más antigua, con su estado en la cadena de Block-Auth.

Parámetros

Name
page
Type
number
Description
Página que quieres, desde 1. Por defecto 1.
Name
limit
Type
number
Description
Resultados por página, de 1 a 100. Por defecto 100.
Name
methods[]
Type
string
Description
Solo estas operaciones, por ejemplo signin o signout. Repite el parámetro para varios valores.
Name
states[]
Type
string
Description
Solo estos estados: initial, pending, approved, cancelled. Repite el parámetro para varios valores.
Name
fromServices
Type
string
Description
Solo estos métodos de login, separados por comas.

Cada elemento

Name
id
Type
number
Description
ID de la entrada.
Name
method
Type
string
Description
La operación, por ejemplo signin.
Name
state
Type
string
Description
initial, pending, approved or cancelled.
Name
hash
Type
string
Description
Hash de la transacción en la cadena de Block-Auth, si la hay. Búscalo en el Explorer.
Name
fromService
Type
string
Description
Método de login usado, por ejemplo blockauth.
Name
created_at
Type
string
Description
Cuándo ocurrió (UTC).

Petición

GET

/api/logs

curl -g 'https://wss.block-auth.io/api/logs?page=1&limit=20&methods[]=signin&states[]=approved' \
  -H 'Authorization: Bearer your_access_token'

Respuesta

{
  "success": true,
  "message": {
    "pages": 1,
    "total": 1,
    "items": [
      {
        "id": 981,
        "method": "signin",
        "state": "approved",
        "hash": "0x5c1e…a07b",
        "block_number": 120345,
        "fromService": "blockauth",
        "app_name": "Mi app",
        "app_domain": "your-app.com",
        "created_at": "2026-11-10T08:31:00.000Z"
      }
    ]
  }
}