---
title: "HeadAccount"
slug: "storage-archivestorage-headaccount"
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
canonical: "api.ncloud-docs.com/storage-archivestorage-headaccount"
---

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

# HeadAccount

Available in Classic and VPC

View the metadata for an account.

## Requests

The following describes the request format for the endpoint. The request format is as follows.

| Method | URI |
| --- | --- |
| HEAD | /v1/AUTH_{project_id} |

### Request headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Required | Value of the issued token |
| `X-Newest` | Boolean | Optional | Set whether to respond with information from the most recent replica - `true` \| `false` - `true`: Query all replicas and respond with information from the most recent replica - If the header is omitted, respond with the fastest information available |

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `project_id` | String | Required | Project ID - For more information on how to check the project ID, see [Archive Storage overview](/docs/en/storage-archivestorage#%EC%9D%B8%EC%A6%9D) |

### Request example

The following is a sample request.

```
curl -X HEAD "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
```

## Responses

The following describes the response format.

### Response headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Content-Type` | String | - | MIME type of the response result |
| `Content-Length` | String | - | Length of the response result (bytes) |
| `X-Account-Container-Count` | Integer | - | Total number of containers (buckets) in the account |
| `X-Account-Object-Count` | Integer | - | Total number of objects in the account |
| `X-Account-Bytes-Used` | Integer | - | Total capacity size used by the account (bytes) |
| `X-Timestamp` | Integer | - | Creation time of the account (Unix timestamp) |
| `X-Account-Storage-Policy-name-Container-Count` | Integer | - | Total number of containers (buckets) in the storage policy corresponding to `name` in the header name |
| `X-Account-Storage-Policy-name-Object-Count` | Integer | - | Total number of objects in the storage policy corresponding to `name` in the header name |
| `X-Account-Storage-Policy-name-Bytes-Used` | Integer | - | Total capacity size (bytes) of the storage policy corresponding to `name` in the header name |
| `X-Account-Meta-name` | String | Optional | Account metadata - The `name` part of the header name acts as a key for metadata |
| `X-Account-Meta-Temp-URL-Key` | String | Optional | Secret key value for the temporary URL |
| `X-Account-Meta-Temp-URL-Key-2` | String | Optional | Second secret key value for the temporary URL |
| `Accept-Ranges` | String | - | Range types allowed by the account |
| `x-account-project-domain-id` | String | - | Domain ID required to use the API |
| `X-Trans-Id` | String | - | Transaction ID of the request |
| `X-Openstack-Request-Id` | String | - | Transaction ID of the request - Identical to X-Trans-Id |
| `X-Account-Meta-Quota-Bytes` | String | Optional | Capacity limit value of the account (bytes) |
| `Date` | String | - | Response time of the request (UTC) |

### Response example

The following is a sample response.

```
HTTP/1.1 204 No Content
Content-Length: 0
Accept-Ranges: bytes
X-Account-Meta-Book: ncloud-test-book
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 420024
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
X-Account-Object-Count: 2
x-account-project-domain-id: default
X-Trans-Id: tx9001d378488c4e5dbc64a-005b975d96
X-Openstack-Request-Id: tx9001d378488c4e5dbc64a-005b975d96
Date: Tue, 11 Sep 2018 06:15:50 GMT
```