Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/NemonInvocash/verifactu-php/llms.txt

Use this file to discover all available pages before exploring further.

verifactuPHP exposes five listing methods that map directly to VeriFactuAPI’s GET endpoints: listarEmisores, listarEnviosAEAT, listarRegistrosAlta, listarListas, and listarWebhooks. Each method follows the same pattern — call it with no arguments to retrieve all records, or pass an integer ID to fetch a single record by its API-assigned identifier. The exception is listarListas, which accepts string parameters to filter by list name and value.

​
Emisores

Retrieve the issuers registered under your VeriFactuAPI account: 
// All registered emisores
$allEmisores = $client->listarEmisores();

// A single emisor by its API ID
$oneEmisor = $client->listarEmisores(1);
These calls map to GET /api/emisor and GET /api/emisor/{id} respectively. See Managing Emisores for how to create and register emisores.

​
Envíos AEAT

Retrieve AEAT submission records to inspect the status of invoices that have been sent to Spain’s tax authority: 
// All AEAT submissions
$allEnvios = $client->listarEnviosAEAT();

// A specific submission by its API ID
$oneEnvio = $client->listarEnviosAEAT(44);
These calls map to GET /api/envios-aeat and GET /api/envios-aeat/{id}. Use these records to check whether a submission was accepted or rejected by AEAT.

​
Registros de Alta

Retrieve invoice registration records previously submitted via altaRegistroAlta(): 
// All alta registration records
$allRegistros = $client->listarRegistrosAlta();

// A specific record by its API ID
$oneRegistro = $client->listarRegistrosAlta(44);
These calls map to GET /api/alta-registro-facturacion and GET /api/alta-registro-facturacion/{id}. The returned ID can be used directly with bajaRegistro() to cancel a record. See Cancelling Invoices for details.

​
Listas (Reference Lists)

VeriFactuAPI defines a set of reference lists (L1, L2, L3, etc.) that map string codes to integer IDs. Many invoice fields — such as tipoFactura, tipoRectificativa, and impuesto — accept values from these lists. Use listarListas() to inspect available values: 
// All available lists
$allListas = $client->listarListas();

// All values in a specific list
$listL2 = $client->listarListas('l2');

// A single value within a list
$value = $client->listarListas('l1', '02');
When you need only the integer ID of a specific list value — for example to store it or pass it to another API call — use idValorLista(): 
// Returns the integer ID for the value '02' in list 'l1'
$id = $client->idValorLista('l1', '02');
These calls map to GET /api/listas, GET /api/listas/{nombre}, and GET /api/listas/{nombre}/{valor}.
Use idValorLista() when you need to convert a string list code to its integer ID for storage or for passing to other SDK methods. For most invoice fields you can pass either form directly — verifactuPHP accepts both the integer ID and the string code interchangeably.

​
Webhooks

Retrieve webhook endpoints registered under your VeriFactuAPI account: 
// All registered webhooks
$allWebhooks = $client->listarWebhooks();

// A specific webhook by its API ID
$oneWebhook = $client->listarWebhooks(1);
These calls map to GET /api/webhook and GET /api/webhook/{id}. See Webhooks for how to create webhooks and associate them with emisores.
All listing methods return the full API response array as decoded JSON. Individual records are found under the data.items key in the response. Consult the VeriFactuAPI documentation for the complete response schema for each endpoint.

Build docs developers (and LLMs) love

Get started for freeTalk to us