Listar carpetas
Busca carpetas mediante filtros y paginación.
/folderURL base: https://business.digito.do/api/v2.
Ejemplos
Configura DIGITO_API_TOKEN en el servidor. Sustituye los IDs y archivos de ejemplo por los de tu equipo. TypeScript usa fetch y FormData de Node.js.
curl --fail-with-body \
--request GET \
--url 'https://business.digito.do/api/v2/folder?page=1&perPage=10&type=DOCUMENT' \
--header "Authorization: $DIGITO_API_TOKEN"Autenticación
Envía el token de la API en el encabezado Authorization. El acceso corresponde al equipo y a los permisos del token. Conserva el token en tu servidor.
Authorization: api_TU_TOKENAntes de cada acción de firma, el firmante debe autenticarse de nuevo con Digito ID. Una sesión previa de Business, un token de destinatario o un token de la API no sustituye este requisito.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Restricciones |
|---|---|---|---|---|
query | Consulta | string | No | Texto de búsqueda. Sin restricciones adicionales en este nivel. |
page | Consulta | number | No | Número de página; comienza en 1. Mínimo: 1 |
perPage | Consulta | number | No | Cantidad de elementos por página. Mínimo: 1. Máximo: 100 |
parentId | Consulta | string | No | Sin restricciones adicionales en este nivel. |
type | Consulta | string | No | Valores: "DOCUMENT", "TEMPLATE" |
Cuerpo de la solicitud
Esta operación no declara cuerpo de solicitud.
Respuesta de éxito
Este objeto sintético ilustra la estructura completa de una respuesta 200. Los identificadores, fechas, estados y tokens son datos de ejemplo.
{
"data": [
{
"id": "carpeta_de_ejemplo",
"name": "Contratos",
"userId": 1,
"teamId": 1,
"parentId": null,
"pinned": true,
"createdAt": "2026-10-06T12:00:00.000Z",
"updatedAt": "2026-10-06T12:00:00.000Z",
"visibility": "EVERYONE",
"type": "DOCUMENT"
}
],
"count": 1,
"currentPage": 1,
"perPage": 10,
"totalPages": 1
}Respuestas y errores
| Estado | Descripción | Contenido y esquema |
|---|---|---|
200 | Respuesta correcta. | application/json |
400 | Datos de entrada inválidos. | application/json |
401 | No se proporcionó autorización. | application/json |
403 | Permisos insuficientes. | application/json |
404 | Recurso no encontrado. | application/json |
500 | Error interno del servidor. | application/json |
Los esquemas enlazados incluyen propiedades anidadas, campos obligatorios, variantes, enumeraciones, nulabilidad y restricciones. Consulta errores y reintentos para manejar respuestas no exitosas.
Identificador de operación: folder-findFolders.