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

> Read the per-prefix rules of your Blob Storage account with GET /v1/account/settings.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Get Settings returns the rules saved with [Update Settings](/en/blob-reference/endpoint/settings-put). Each rule applies to the files under its prefix: default visibility, expiry and cache, size and type limits, and automatic deletion. Requires the `blob:read` scope.

### Response

<ResponseField name="status" type="string">
  "success" if successful, "error" if not.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Toggle object">
    <ResponseField name="rules" type="array">
      The rules, as saved. See [Update Settings](/en/blob-reference/endpoint/settings-put) for each field.

      <Expandable title="Toggle object">
        <ResponseField name="prefix" type="string">
          The prefix the rule applies to, ending in `/`.
        </ResponseField>

        <ResponseField name="private" type="boolean">
          Default visibility.
        </ResponseField>

        <ResponseField name="expire" type="string">
          Default expiry.
        </ResponseField>

        <ResponseField name="max_size" type="number">
          Maximum file size, in bytes.
        </ResponseField>

        <ResponseField name="extensions" type="string[]">
          Accepted extensions.
        </ResponseField>

        <ResponseField name="cache_control" type="string">
          Default cache.
        </ResponseField>

        <ResponseField name="delete_after_days" type="number">
          Days after which files are deleted.
        </ResponseField>

        <ResponseField name="created_at" type="ISO 8601">
          When the rule was saved.
        </ResponseField>

        <ResponseField name="active_from" type="ISO 8601">
          When automatic deletion starts to act (24 hours after `created_at`). Present only with `delete_after_days`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/account/settings' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "rules": [
        {
          "prefix": "invoices/",
          "private": true,
          "extensions": ["pdf"],
          "created_at": "2026-09-25T12:00:00.000Z"
        },
        {
          "prefix": "tmp/",
          "delete_after_days": 7,
          "created_at": "2026-09-25T12:00:00.000Z",
          "active_from": "2026-09-26T12:00:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>