Listar establecimientos

Retorna todos los establecimientos (sucursales) de la empresa. Usa el id del establecimiento en el campo establecimiento al emitir documentos para identificar qué sucursal emite.

GEThttps://api.facturalo.pe/api/v3/empresas/{uuid}/establecimientos

Parámetros del request

Authorization
header · stringrequerido
Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...

Parámetros del response

data
objectrequerido
Contenedor principal del resultado.
total
numberrequerido
Total de establecimientos registrados para la empresa.
establecimientos
arrayrequerido
Lista de establecimientos.
id
stringrequerido
ID del establecimiento. Úsalo en el campo 'establecimiento' al emitir documentos.
nombre
stringrequerido
Nombre del establecimiento.
direccion
stringrequerido
Dirección del establecimiento.
departamento
stringrequerido
Departamento.
provincia
stringrequerido
Provincia.
distrito
stringrequerido
Distrito.
codigoPostal
stringrequerido
Código postal.
celular
string | nullopcional
Número de celular del establecimiento.
correo
string | nullopcional
Correo electrónico del establecimiento.
logo
string | nullopcional
URL pública del logo en JPEG. null si no tiene logo.
esPrincipal
booleanrequerido
true si es el establecimiento principal de la empresa.
creado
stringrequerido
Fecha de creación en formato YYYY-MM-DD.
Requestjson
// Sin body — GET request
// Authorization: sk_test_...
200 — Respuesta exitosajson
{
  "success": true,
  "message": "Establecimientos obtenidos correctamente.",
  "data": {
    "total": 2,
    "establecimientos": [
      {
        "id": "c1d2e3f4-0000-1111-2222-333344445555",
        "nombre": "SEDE PRINCIPAL",
        "direccion": "Av. Grau 123",
        "departamento": "LAMBAYEQUE",
        "provincia": "LAMBAYEQUE",
        "distrito": "LAMBAYEQUE",
        "codigoPostal": "140301",
        "celular": "979123456",
        "correo": "principal@empresa.com",
        "logo": "https://api.facturalo.pe/storage/images/establishments/c1d2e3f4-0000-1111-2222-333344445555.jpg",
        "esPrincipal": true,
        "creado": "2026-06-01"
      },
      {
        "id": "a9b8c7d6-eeee-ffff-0000-111122223333",
        "nombre": "SUCURSAL NORTE",
        "direccion": "AV. INDUSTRIAL 456",
        "departamento": "LA LIBERTAD",
        "provincia": "TRUJILLO",
        "distrito": "TRUJILLO",
        "codigoPostal": "13001",
        "celular": null,
        "correo": null,
        "logo": null,
        "esPrincipal": false,
        "creado": "2026-06-10"
      }
    ]
  }
}