Consulta GRE Lista

Lista las Guías de Remisión Electrónicas de un periodo, con filtros y agregación automática de páginas.

Consideraciones

Debe indicarse periodo o el rango fecha_desde + fecha_hasta. Agrega automáticamente todas las páginas del rango, hasta un tope de seguridad.
No disponible en el plan gratuito. Consume 1 consulta de tu plan.

POST https://api.apiperu.dev/gre/lista Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Body

Name	Type	Description
ruc*	string	RUC del emisor (titular de la Clave SOL).
usuario*	string	Usuario SOL.
clave*	string	Clave SOL.
tipo_gre*	string	`09` (remitente) o `31` (transportista).
periodo	string	Mes completo a listar, formato `AAAA-MM`. Alternativa a fecha_desde/fecha_hasta.
fecha_desde	string	Fecha de emisión desde (AAAA-MM-DD). Alternativa a periodo.
fecha_hasta	string	Fecha de emisión hasta (AAAA-MM-DD). Alternativa a periodo.
estado	string	Código de estado SUNAT del comprobante. Vacío devuelve todos los estados.
ruc_receptor	string	Filtra por RUC del receptor de la guía.
serie	string	Filtra por serie de la guía.
numero	integer	Filtra por número de la guía.

Ejemplo de solicitud

Copiar

curl -X POST https://api.apiperu.dev/gre/lista \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20601234567","usuario":"USUARIO","clave":"CLAVE","tipo_gre":"09","periodo":"2026-07","fecha_desde":"...","fecha_hasta":"...","estado":"...","ruc_receptor":"...","serie":"T001","numero":123}'

Copiar

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.apiperu.dev/gre/lista',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'ruc' => '20601234567',
        'usuario' => 'USUARIO',
        'clave' => 'CLAVE',
        'tipo_gre' => '09',
        'periodo' => '2026-07',
        'fecha_desde' => '...',
        'fecha_hasta' => '...',
        'estado' => '...',
        'ruc_receptor' => '...',
        'serie' => 'T001',
        'numero' => 123,
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Copiar

const response = await fetch('https://api.apiperu.dev/gre/lista', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ruc: '20601234567',
    usuario: 'USUARIO',
    clave: 'CLAVE',
    tipo_gre: '09',
    periodo: '2026-07',
    fecha_desde: '...',
    fecha_hasta: '...',
    estado: '...',
    ruc_receptor: '...',
    serie: 'T001',
    numero: 123,
  }),
});

const data = await response.json();
console.log(data);

Copiar

import requests

response = requests.post(
    'https://api.apiperu.dev/gre/lista',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'ruc': '20601234567',
        'usuario': 'USUARIO',
        'clave': 'CLAVE',
        'tipo_gre': '09',
        'periodo': '2026-07',
        'fecha_desde': '...',
        'fecha_hasta': '...',
        'estado': '...',
        'ruc_receptor': '...',
        'serie': 'T001',
        'numero': 123,
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "ruc_emisor": "20601234567",
        "ruc_receptor": "10067888460",
        "tipo": "09",
        "tipo_desc": "Remitente",
        "serie": "T001",
        "numero": 858,
        "fecha_emision": "2026-07-22 07:36:00",
        "estado": "01",
        "estado_desc": "Emitido",
        "sub_estado": null,
        "sub_estado_desc": null
      }
    ],
    "total": 1
  }
}