> ## 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

> Lies mit GET /v1/objects/info die Details einer Datei: Größe, Content-Type, Ablauf, Sichtbarkeit, Cache, ursprünglicher Name und Metadaten.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

Object Info gibt alles zurück, was Blob Storage über eine Datei weiß, ohne sie herunterzuladen: Größe, Content-Type, Ablauf, Sichtbarkeit, die Header, mit denen sie ausgeliefert wird, den ursprünglichen Dateinamen und deine Metadaten. Erfordert den Scope `blob:read`.

<ParamField query="object" type="string" required>
  Die id der Datei.
</ParamField>

### Rate Limits

<Note>60 Requests pro Minute (`RATE_LIMITED`, 429).</Note>

### Antwort

<ResponseField name="status" type="string">
  "success" bei Erfolg, "error" bei Misserfolg.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Objekt umschalten">
    <ResponseField name="id" type="string">
      Die id der Datei.
    </ResponseField>

    <ResponseField name="size" type="number">
      Die Größe in Bytes.
    </ResponseField>

    <ResponseField name="content_type" type="string">
      Der `Content-Type`, mit dem die Datei ausgeliefert wird, bestimmt aus ihrer Endung.
    </ResponseField>

    <ResponseField name="etag" type="string">
      Das ETag. Es ändert sich, wenn sich der Inhalt ändert.
    </ResponseField>

    <ResponseField name="created_at" type="ISO 8601">
      Wann die Datei geschrieben wurde. Das Ändern von Sichtbarkeit, Ablauf oder Headern schreibt die Datei neu und setzt dieses Datum zurück.
    </ResponseField>

    <ResponseField name="expires_at" type="ISO 8601 | null">
      Wann die Datei gelöscht wird, oder `null`.
    </ResponseField>

    <ResponseField name="private" type="boolean">
      Ob die Datei privat ist.
    </ResponseField>

    <ResponseField name="url" type="string | null">
      Die öffentliche URL oder `null` bei privaten Dateien.
    </ResponseField>

    <ResponseField name="cache_control" type="string | null">
      Der Header `Cache-Control` oder `null`, wenn der CDN-Standard gilt.
    </ResponseField>

    <ResponseField name="content_disposition" type="string | null">
      Der Header `Content-Disposition` oder `null`.
    </ResponseField>

    <ResponseField name="original_name" type="string | null">
      Der Name der Datei, wie sie hochgeladen wurde.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      Deine Metadaten, als Schlüssel-Wert-Strings.
    </ResponseField>

    <ResponseField name="legacy" type="boolean">
      `true` für Legacy-Dateien, gespeichert vor dem Update im September 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>

### Fehler

| Code               | HTTP | Wann                                                  |
| ------------------ | ---- | ----------------------------------------------------- |
| `INVALID_OBJECT`   | 400  | `object` fehlt, ist fehlerhaft oder gehört nicht dir. |
| `OBJECT_NOT_FOUND` | 404  | Die Datei existiert nicht.                            |
| `RATE_LIMITED`     | 429  | Mehr als 60 Requests in einer Minute.                 |