# Listar carpetas de trabajo

Fuente: /work-folders/work-folders-list/

Para listar las carpetas de trabajo disponibles debemos de consumir el siguiente endpoint , por defecto se crea una carpeta llamada mis documentos:

**Método:**  GET `https://api.digitafirma.com/v1/companies`

| Campo | Tipo | Descripción |
| :- | :- | :- |
| role | `Enum` | Filtrado de carpetas de trabajo mediante rol. ("ROLE\_OWNER" "ROLE\_INVITED") |
| pageable | `Object` | Parametro de paginación. |
| `pageable.page` | `integer` | Número de página. (>= 0) |
| `pageable.size` | `integer` | Tamaño de la página. (>= 1) |
| `pageable.sort` | `string` | Ordenamiento de la página. |

Ejemplo de respuesta:

**Response (200 OK)**

```json
{
    "data": [
        {
            "type": "companies",
            "id": "ac110005-9d0c-1243-819d-0c3b71220000",
            "attributes": {
                "logo": "",
                "name": "CARPETA 1",
                "role": "Propietario",
                "rfc": null,
                "created_at": "2026-03-20T11:11:55.44162",
                "updated_at": "2026-04-17T09:43:39.612891",
                "roleKey": "owner"
            },
            "links": {
                "self": "/companies/ac110005-9d0c-1243-819d-0c3b71220000"
            }
        }
    ],
    "meta": [
        {
            "page": {
                "total": 1,
                "initialItem": 0,
                "totalItems": 1
            }
        }
    ],
    "links": {
        "self": "/companies"
    }
}
```