Get file details

Read the details of one file with GET /v1/objects/info: size, content type, expiry, visibility, cache, original name and metadata.

GET /v1/objects/info

cURL

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
  --header 'Authorization: YOUR_API_KEY'

{
  "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" }
  }
}

Authorization · string · required

The API key for your account. You can find this in your account settings.

Object Info returns everything Blob Storage knows about one file without downloading it: size, content type, expiry, visibility, the headers it is served with, the original file name and your metadata. Requires the blob:read scope.

Parameters

object · string · required

The id of the file.

Rate limits

60 requests per minute (RATE_LIMITED, 429).

Response

status · string

“success” if successful, “error” if not.

response · object

Show properties

id · string

The id of the file.

size · number

The size, in bytes.

content_type · string

The Content-Type the file is served with, derived from its extension.

etag · string

The ETag. It changes when the content changes.

created_at · ISO 8601

When the file was written. Changing visibility, expiry or headers rewrites the file and resets this date.

expires_at · ISO 8601 | null

When the file will be deleted, or null.

private · boolean

Whether the file is private.

url · string | null

The public URL, or null for private files.

cache_control · string | null

The Cache-Control header, or null when the CDN default applies.

content_disposition · string | null

The Content-Disposition header, or null.

original_name · string | null

The name of the file as uploaded.

metadata · object

Your metadata, as key and value strings.

cURL

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
  --header 'Authorization: YOUR_API_KEY'

{
  "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" }
  }
}

Errors

Code	HTTP	When
INVALID_OBJECT	400	object is missing, malformed or not yours.
OBJECT_NOT_FOUND	404	The file doesn’t exist.
RATE_LIMITED	429	More than 60 requests in a minute.

Related

• Blob SDK: blob.info()