> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Blob Object Info

> Consulta los detalles de un archivo con GET /v1/objects/info: tamaño, tipo de contenido, expiración, visibilidad, caché, nombre original y metadatos.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clave de API de tu cuenta. Puedes encontrarla en la [configuración de tu cuenta](https://squarecloud.app/es/account/security).
</ParamField>

Object Info devuelve todo lo que Blob Storage sabe sobre un archivo sin descargarlo: tamaño, tipo de contenido, expiración, visibilidad, las cabeceras con las que se sirve, el nombre de archivo original y tus metadatos. Requiere el scope `blob:read`.

<ParamField query="object" type="string" required>
  El id del archivo.
</ParamField>

### Límites de tasa

<Note>60 solicitudes por minuto (`RATE_LIMITED`, 429).</Note>

### Respuesta

<ResponseField name="status" type="string">
  "success" si tuvo éxito, "error" si no.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Alternar objeto">
    <ResponseField name="id" type="string">
      El id del archivo.
    </ResponseField>

    <ResponseField name="size" type="number">
      El tamaño, en bytes.
    </ResponseField>

    <ResponseField name="content_type" type="string">
      El `Content-Type` con el que se sirve el archivo, derivado de su extensión.
    </ResponseField>

    <ResponseField name="etag" type="string">
      El ETag. Cambia cuando cambia el contenido.
    </ResponseField>

    <ResponseField name="created_at" type="ISO 8601">
      Cuándo se escribió el archivo. Cambiar la visibilidad, la expiración o las cabeceras reescribe el archivo y reinicia esta fecha.
    </ResponseField>

    <ResponseField name="expires_at" type="ISO 8601 | null">
      Cuándo se eliminará el archivo, o `null`.
    </ResponseField>

    <ResponseField name="private" type="boolean">
      Si el archivo es privado.
    </ResponseField>

    <ResponseField name="url" type="string | null">
      La URL pública, o `null` para los archivos privados.
    </ResponseField>

    <ResponseField name="cache_control" type="string | null">
      La cabecera `Cache-Control`, o `null` cuando se aplica el valor por defecto de la CDN.
    </ResponseField>

    <ResponseField name="content_disposition" type="string | null">
      La cabecera `Content-Disposition`, o `null`.
    </ResponseField>

    <ResponseField name="original_name" type="string | null">
      El nombre del archivo tal como se subió.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      Tus metadatos, como pares de strings clave y valor.
    </ResponseField>

    <ResponseField name="legacy" type="boolean">
      `true` para los archivos heredados, almacenados antes de la actualización de septiembre de 2026.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "id": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "size": 416230,
      "content_type": "image/png",
      "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"",
      "created_at": "2026-09-25T12:00:00.000Z",
      "expires_at": null,
      "private": false,
      "url": "https://blob.squarecloud.dev/pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
      "cache_control": "public, max-age=31536000, immutable",
      "content_disposition": null,
      "original_name": "logo.png",
      "metadata": { "campaign": "spring" },
      "legacy": false
    }
  }
  ```
</ResponseExample>

### Errores

| Código             | HTTP | Cuándo                                         |
| ------------------ | ---- | ---------------------------------------------- |
| `INVALID_OBJECT`   | 400  | `object` falta, está mal formado o no es tuyo. |
| `OBJECT_NOT_FOUND` | 404  | El archivo no existe.                          |
| `RATE_LIMITED`     | 429  | Más de 60 solicitudes en un minuto.            |