Ir al contenido
Facturalo

Clientes o proveedores con saldo

Saldo por cliente (lado `cobrar`) o proveedor (lado `pagar`), con lo vencido y la última operación. Un saldo negativo es saldo a favor.

GEThttps://api.facturalo.pe/api/v3/cobranza/{lado}/contrapartes

Query

Campo
Descripción
lado
stringrequerido
cobrar (clientes: lo que te deben) o pagar (proveedores: lo que debes). Va en la ruta.Ej: cobrar
q
stringopcional
Busca por nombre o documento.
moneda
stringopcional
PEN (default) o USD.
todas
booleanopcional
1 incluye también a quienes ya no deben nada.

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request
$ # Node 18+ fetch
const response = await fetch("https://api.facturalo.pe/api/v3/cobranza/cobrar/contrapartes", {
  method: "GET",
  headers: {
    "Authorization": "sk_test_…"
  }
});

const data = await response.json();
console.log(data);
HTTP directo · funciona con cualquier cliente HTTP
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "data": [
    {
      "tipoDocumento": "6",
      "numeroDocumento": "20100070970",
      "nombre": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A.",
      "saldo": 9,
      "vencido": 0,
      "ultimaOperacion": "2026-11-10"
    }
  ]
}