Skip to main content
HEAD
You need READ permission on the object to retrieve its metadata.

Head Object

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you’re only interested in an object’s metadata or want to check if an object exists.

Base URL

Parameters

objectKey
required
The key of the object to retrieve metadata for

Headers

If-Match
Return the metadata only if the ETag matches
If-Modified-Since
Return the metadata only if the object has been modified since the specified time

Request Examples

Response Example

Authorizations

Authorization
string
header
required

AWS Signature Version 4

Path Parameters

objectKey
string
required

Key of the object

Response

200

Object metadata retrieved successfully