---
title: Consultar un Documento por Número
description: Esta invocación consulta uno o más registros por el número completo del documento electrónico, el cual está conformado por el Tipo de Documento, el establecimiento, el punto, el número y la serie (éste último opcional) Es muy útil para saber…
url: "https://facturasend.com.py/documentacion/consultar-un-documento-por-numero/"
updated: "2025-04-16"
category: "3-API de FacturaSend"
---

# Consultar un Documento por Número

Esta invocación consulta uno o más registros por el número completo del documento electrónico, el cual está conformado por el Tipo de Documento, el establecimiento, el punto, el número y la serie (éste último opcional)

Es muy útil para saber cuales documentos están relacionados con dicho número, caso se haya perdido la referencia al CDC del documento electrónico.

Tenga en cuenta que por un mismo número pueden retornar varios registros, debido a que antes de una aprobación pudieron existir varios rechazos, del mismo documento, pero talvez con otro CDC, por ejemplo.

### Endpoint (URL)

**GET**https://api.facturasend.com.py/<tenantId>/de/numero/<tipoDocumento>/<establecimiento>/<punto>/<numero>

**GET**https://api.facturasend.com.py/<tenantId>/de/numero/<tipoDocumento>/<establecimiento>/<punto>/<numero>/<serie>

### Header (Encabezado)

Requiere el envío del los siguientes atributos en el encabezado

| Campo | Valor |
| --- | --- |
| Authorization | Bearer api_key_**reemplazar_api_key** |

### Parámetros (BODY)

No posee

### Parámetros (Query Param)

No posee

### Ejemplo de llamadas

- [shell](#tab-shell)
- [javascript](#tab-javascript)

```
curl 
  -X 
  GET "https://api.facturasend.com.py/<tenantId>/de/numero/1/001/001/1007331"
  -H "Authorization: Bearer api_key_<reemplazar_api_key>"
```

```
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

const headers = {
  `Authorization` : `Bearer api_key_<reemplazar_api_key>`
};

axios.get(`https://api.facturasend.com.py/<tenantId>/de/numero/1/001/001/1007331`,
  {headers}
)
.then( respuesta => {
  console.log(respuesta);
});
```

### Respuesta de la Petición

La respuesta de la petición será la siguiente:

```
{
    "success": true,
    "deList": [
        {
            "id": 2741,
            "fecha": "2024-08-09T16:32:00.891Z",
            "cdc": "01800695631001001100733112024072613221119684",
            "situacion": 4,
            "lote_id": 1666,
            "lote_estado": 3,
            "info_codigo": "0100",
            "info_descripcion": "Error Inesperado(PKI).",
            "fecha_proceso": "2024-08-09T12:31:49-04:00"
        }
    ]
}
```

### Recomendaciones

- No aplica

### Validaciones

- No aplica