Listar empresas

Retorna todas las empresas asociadas al token de usuario autenticado. Incluye tokens y webhooks configurados por entorno.

GEThttps://api.facturalo.pe/api/v3/empresas

Query

Campo

Descripción

Authorization

header · stringrequerido

Token de usuario (user_sk_...). No se acepta token de empresa.Ej: user_sk_...

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Contenedor principal del resultado.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloCuentaClient } from "@facturalo-pe/node";

const cuenta = new FacturaloCuentaClient({ token: process.env.FACTURALO_USER_TOKEN! });

const result = await cuenta.empresas.listar();
console.log(result.empresas);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Empresas obtenidas correctamente.",
  "data": {
    "total": 1,
    "empresas": [
      {
        "id": "afcfac05-b5c2-45c4-90d9-7e6f03c9e863",
        "ruc": "20614694557",
        "nombre": "CONSULTIA DIGITAL S.A.C.",
        "direccion": "AV. PRINCIPAL 123, PISO 4",
        "departamento": "LAMBAYEQUE",
        "provincia": "LAMBAYEQUE",
        "distrito": "LAMBAYEQUE",
        "codigoPostal": "140301",
        "produccion": false,
        "claves": {
          "demo": {
            "token": "sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "webhookUrl": "https://mi-sistema.com/webhooks/facturalo/demo",
            "webhookSecret": "whsec_test_xxxxxxxxxxxxxxxxxxx"
          },
          "prod": {
            "token": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "webhookUrl": "https://mi-sistema.com/webhooks/facturalo/prod",
            "webhookSecret": "whsec_live_xxxxxxxxxxxxxxxxxxx"
          }
        },
        "creada": "2026-06-13"
      }
    ]
  }
}