v1.0

Listar clientes

GEThttps://api.pasarela.hi-g.io/v1/customers

Devuelve los clientes de la empresa, del más nuevo al más antiguo, con un resumen de sus depósitos acreditados (stats). total es el número de clientes que cumplen el filtro, no el de la página.

Ver el ejemplo y probar ↓

Parámetros de consulta

limitintegerPor defecto: 50

Cuántos registros devolver. Entre 1 y 200.

offsetintegerPor defecto: 0

Cuántos registros saltar. Mínimo 0.

searchstring

Texto a buscar dentro de external_id, la dirección de depósito o metadata. Máximo 200 caracteres. No distingue mayúsculas.

Cabeceras

x-api-keystringobligatorio

Clave de API de la empresa. Se crea y se revoca desde el panel.

Respuestas

Lenguaje

Credenciales

x-api-key

Cabecera

Petición cURL

1curl --request GET \2     --url 'https://api.pasarela.hi-g.io/v1/customers' \3     --header 'accept: application/json' \4     --header 'x-api-key: sk_test_…'

Consulta de solo lectura.

Respuesta

Elige un ejemplo:

application/json

{
  "customers": [
    {
      "id": "3d8ed2f2-72d4-4c27-b606-a53b5a4db086",
      "external_id": "TARJETA-000123",
      "address": "0xeB1322F1C80462602A728Ca005f1026709A738ba",
      "chain_id": 421614,
      "network": "Arbitrum Sepolia",
      "tokens": [
        {
          "symbol": "USDT",
          "address": "0xdc190461C20DE36fFB305b0190985B4023D7D183",
          "decimals": 6
        },
        {
          "symbol": "USDC",
          "address": "0x928C3C521F85790c4B9b8c37251f4e22186610aE",
          "decimals": 8
        }
      ],
      "pay_url": "https://api.pasarela.hi-g.io/pay/3d8ed2f2-72d4-4c27-b606-a53b5a4db086",
      "qr_url": "https://api.pasarela.hi-g.io/pay/3d8ed2f2-72d4-4c27-b606-a53b5a4db086/qr.svg",
      "metadata": {
        "nombre": "Rosa Quispe"
      },
      "created_at": "2026-10-13T14:58:41.463Z",
      "stats": {
        "deposits": 2,
        "volume": "153.101981",
        "last_deposit_at": "2026-10-13T15:04:12.310Z"
      }
    }
  ],
  "total": 1
}

Obtener cliente