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

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

# HeadObject

Available in Classic and VPC

View the metadata of a stored object.

## Requests

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

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

### Request headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Optional | 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 |
| `If-Match` | String | Optional | ETag condition header - For more information, see [RFC2616](https://www.ietf.org/rfc/rfc2616.txt) |
| `If-None-Match` | String | Optional | ETag condition header - For more information, see [RFC2616](https://www.ietf.org/rfc/rfc2616.txt) |
| `If-Modified-Since` | String | Optional | Last-Modified condition header - For more information, see [RFC2616](https://www.ietf.org/rfc/rfc2616.txt) |
| `If-Unmodified-Since` | String | Optional | Last-Modified condition header - For more information, see [RFC2616](https://www.ietf.org/rfc/rfc2616.txt) |

### 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) |
| `container` | String | Required | Name of the container where the target object will be stored |
| `object` | String | Required | Target object name |

### Request example

The following is a sample request.

```
curl -L -I 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Newest: true'
```

## 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-Object-Meta-{name}` | String | - | Object metadata - `{name}` part is the metadata's key - Header value is the metadata value |
| `Cache-Control` | String | - | Caching rules for requests and responses |
| `ETag` | String | - | ETag header value |
| `Last-Modified` | String | - | Most recent modification time of the object (UTC) |
| `X-Timestamp` | String | - | Response time for the request (Unix timestamp) |
| `Content-Disposition` | String | - | Browser's response handling method |
| `Content-Encoding` | String | - | Object's encoding method |
| `X-Delete-At` | Integer | - | Scheduled deletion time when automatic deletion of objects is enabled (Unix timestamp) |
| `X-Object-Manifest` | String | - | Response for large objects (SLOs) - It displays the part's storage path |
| `X-Static-Large-Object` | Boolean | - | Whether it's a large object (SLO) - `true` \| `false` - `true`: The object is the manifest of a large object |
| `Accept-Ranges` | String | - | Whether the server honors a partial scope request from a client |
| `X-Trans-Id` | String | - | Transaction ID of the request |
| `X-Openstack-Request-Id` | String | - | Transaction ID of the request - Identical to `X-Trans-Id` |
| `Date` | String | - | Response time for the request (UTC) |

### Response status codes

The following describes the response status codes.

| HTTP status code | Code | Message | Description |
| --- | --- | --- | --- |
| 200 | - | OK | Request succeeded |

### Response example

The following is a sample response.

```
HTTP/1.1 200 OK
Content-Length: 10485760
Accept-Ranges: bytes
Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
Etag: f1c9645dbc14efddc7d8a322685f26eb
X-Timestamp: 1537170219.48936
Content-Type: application/x-www-form-urlencoded
X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
Date: Mon, 17 Sep 2018 08:49:21 GMT
```