---
updatedAt: 2025-06-08T15:30:55.000Z
agentTools:
  projectIndex: https://es-developers.kommo.com/llms.txt
---

# Obtener una lista de archivos

El método para obtener archivos de la cuenta que cumplan con los filtros especificados. Requiere enviar una solicitud al host del servicio de archivos.

**¿No sabes cuál es el nombre de tu unidad?**

Consulta este [artículo corto](https://es-developers.kommo.com/reference/primeros-pasos) para averiguarlo.

**Limitaciones**

Este método está disponible para integraciones con acceso a archivos.

**Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error**\
Content-Type: application/json.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "files-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{your-drive}.kommo.com",
      "variables": {
        "your-drive": {
          "default": "your-drive"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1.0/files": {
      "get": {
        "summary": "Obtener una lista de archivos",
        "description": "El método para obtener archivos de la cuenta que cumplan con los filtros especificados. Requiere enviar una solicitud al host del servicio de archivos.",
        "operationId": "obtener-lista-de-archivos",
        "parameters": [
          {
            "name": "filter[uuid]",
            "in": "query",
            "description": "Arreglo de UUIDs de archivos, separados por comas",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "filter[name]",
            "in": "query",
            "description": "Nombre del archivo",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter[extensions][]",
            "in": "query",
            "description": "Extensión del archivo",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter[term]",
            "in": "query",
            "description": "Una subcadena en el nombre de un archivo o en el nombre de una de las entidades relacionadas",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter[source_id]",
            "in": "query",
            "description": "ID de la fuente desde la cual se obtuvo el archivo",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[deleted]",
            "in": "query",
            "description": "filter[deleted]",
            "schema": {
              "type": "string",
              "format": "json"
            }
          },
          {
            "name": "filter[size][unit]",
            "in": "query",
            "description": "Cantidad de bytes por unidad de tamaño de archivo (1 byte por defecto)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "filter[size][from]",
            "in": "query",
            "description": "Tamaño mínimo de archivo",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[size][to]",
            "in": "query",
            "description": "Tamaño máximo de archivo",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[date][type]",
            "in": "query",
            "description": "Tipo de evento por el cual filtrar. Valores posibles: created_at, updated_at",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter[date][date_preset]",
            "in": "query",
            "description": "Preajuste para un rango de tiempo. Valores posibles: ​ day, tomorrow, yesterday, week, previous_week, next_week, month, next_month, previous_month, quarter, previous_quarter, next_quarter, last_3_days, next_3_days, last_6_month, year",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter[date][from]",
            "in": "query",
            "description": "Hora (Unix Timestamp) después de la cual ocurrió el evento",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[date][to]",
            "in": "query",
            "description": "Hora (Unix Timestamp) antes de la cual ocurrió el evento",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[created_by][]",
            "in": "query",
            "description": "Creador del archivo. Valores posibles: -1 – cliente, 0 – robot, {id} – usuario interno",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[updated_by][]",
            "in": "query",
            "description": "Usuario que actualizó el archivo por última vez. Valores posibles: -1 – cliente, 0 – robot, {id} – usuario interno",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Solicitud exitosa": {
                    "value": "{\n  \"_count\": 25,\n  \"_embedded\": {\n    \"files\": [\n      {\n        \"_links\": {\n          \"download\": {\n            \"href\": \"https://drive-c.kommo.com/download/93a737f9-637e32rdf-5163-bbb4-4ff8a4f9c698/d38e8536-19eb-4144-bf53-f088b133b19e/example-phone-widget-3.zip\"\n          },\n          \"download_version\": {\n            \"href\": \"https://drive-c.kommo.com/download/93a737f9-2787c8-5163-bbb4-4ff8a4f9c698/d38e8536-19eb-4144-bf53-f088b133b19e/466442c2-eb48-4729-858e-25432ca01604/example-phone-widget-3.zip\"\n          },\n          \"self\": {\n            \"href\": \"https://drive-c.kommo.com/v1.0/files/d38e8536-edi7d379-4144-bf53-f088b133b19e\"\n          }\n        },\n        \"created_at\": 1671871033,\n        \"created_by\": { \"type\": \"internal\", \"id\": 7758337 },\n        \"deleted_at\": null,\n        \"deleted_by\": null,\n        \"has_multiple_versions\": false,\n        \"is_trashed\": false,\n        \"metadata\": { \"extension\": \"jpg\", \"mime_type\": \"image/jpeg\" },\n        \"name\": \"8Z5PQ3D7wbS6Doz-svQ0zYdWXeTq8HqfSQzjM-aDY2cI5uM3wcRZ0dD8nLV8TUcX\",\n        \"previews\": null,\n        \"sanitized_name\": \"8Z5PQ3D7wbS6Doz-svQ0zYdWXeTq8HqfSQzjM-aDY2cI5uM3wcRZ0dD8nLV8TUcX\",\n        \"size\": 38635,\n        \"source_id\": null,\n        \"type\": \"image\",\n        \"updated_at\": 1671871033,\n        \"updated_by\": { \"type\": \"internal\", \"id\": 7758337 },\n        \"uuid\": \"26ec7266-d953-433b-8bc5-737eb70da87a\",\n        \"version_uuid\": \"0244c437-1637-4cdf-887a-e574f55eb114\"\n      },\n      {\n         \"_links\": {\n          \"download\": {\n            \"href\": \"https://drive-c.kommo.com/download/93a737f9-bd8f-5163-hg83-4ff8dejwqf43c698/d38e8536-19eb-4144-bf53-f088b133b19e/example-phone-widget-3.zip\"\n          },\n          \"download_version\": {\n            \"href\": \"https://drive-c.kommo.com/download/93a737f9-bd8f-1538-bbb4-4ff23799c698/d38e8536-19eb-4144-bf53-f088b133b19e/466442c2-eb48-4729-858e-25432ca01604/example-phone-widget-3.zip\"\n          },\n          \"self\": {\n            \"href\": \"https://drive-c.kommo.com/v1.0/files/d38ht674-np38-4144-bf53-dj88b133b19e\"\n          }\n        },\n        \"created_at\": 1671814907,\n        \"created_by\": { \"type\": \"internal\", \"id\": 2647957 },\n        \"deleted_at\": null,\n        \"deleted_by\": null,\n        \"has_multiple_versions\": false,\n        \"is_trashed\": false,\n        \"metadata\": { \"extension\": \"png\", \"mime_type\": \"image/png\" },\n        \"name\": \"_96\",\n        \"previews\": null,\n        \"sanitized_name\": \"-96\",\n        \"size\": 5230,\n        \"source_id\": null,\n        \"type\": \"image\",\n        \"updated_at\": 1671814907,\n        \"updated_by\": { \"type\": \"internal\", \"id\": 2647957 },\n        \"uuid\": \"9403badc-5690-4c7d-a999-be09f8c57566\",\n        \"version_uuid\": \"2a93e2a2-7c09-4f0d-b8ee-f0228e890307\"\n      },\n      ...\n    ]\n  },\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://drive-c.kommo.com/v1.0/files?limit=50&page=1\"\n    }\n  }\n}"
                  }
                }
              }
            }
          },
          "204": {
            "description": "204",
            "content": {
              "application/json": {
                "examples": {
                  "No se encontraron archivos": {
                    "value": "No content"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Datos incorrectos enviados": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Fallo en la autenticación": {
                    "value": "{\n  \"title\": \"Unauthorized\",\n  \"type\": \"https://httpstatus.es/401\",\n  \"status\": 401,\n  \"detail\": \"Nombre de usuario o contraseña incorrectos\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "example": "Unauthorized"
                    },
                    "type": {
                      "type": "string",
                      "example": "https://httpstatus.es/401"
                    },
                    "status": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "detail": {
                      "type": "string",
                      "example": "Nombre de usuario o contraseña incorrectos"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "No tienes los derechos suficientes para llamar a este método": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```