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

Parámetros del request

Authorization
header · stringrequerido
Token de usuario (user_sk_...). No se acepta token de empresa.Ej: user_sk_...

Parámetros del response

data
objectrequerido
Contenedor principal del resultado.
total
numberrequerido
Cantidad total de empresas asociadas al usuario.
empresas
arrayrequerido
Lista de empresas.
id
stringrequerido
ID de la empresa.
ruc
stringrequerido
RUC de la empresa (11 dígitos).
nombre
stringrequerido
Razón social registrada en SUNAT.
direccion
stringrequerido
Dirección fiscal.
departamento
stringrequerido
Departamento.
provincia
stringrequerido
Provincia.
distrito
stringrequerido
Distrito.
codigoPostal
stringrequerido
Código postal.
produccion
booleanrequerido
true si el entorno de producción está habilitado.
claves
objectrequerido
Tokens y webhooks por entorno.
demo
objectrequerido
Credenciales del entorno de pruebas.
token
stringrequerido
Token de autenticación demo. Prefijo: "sk_test_".
webhookUrl
string | nullopcional
URL del webhook demo configurada. null si no se ha configurado.
webhookSecret
stringrequerido
Secreto para verificar la firma del webhook demo. Prefijo: "whsec_test_".
prod
objectrequerido
Credenciales del entorno de producción.
token
stringrequerido
Token de autenticación producción. Prefijo: "sk_live_".
webhookUrl
string | nullopcional
URL del webhook producción configurada. null si no se ha configurado.
webhookSecret
stringrequerido
Secreto para verificar la firma del webhook producción. Prefijo: "whsec_live_".
creada
stringrequerido
Fecha de creación de la empresa en formato YYYY-MM-DD.
Requestjson
// Sin body — GET request
// Authorization: user_sk_...
200 — Respuesta exitosajson
{
  "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"
      }
    ]
  }
}