---
title: "Get an object's pinned metadata"
method: GET
path: "/worker/pinned/{key}"
tags: ["worker"]
---

# Get an object's pinned metadata

`GET /worker/pinned/{key}`

Returns the raw metadata of an object in a form suitable for downloading it directly from hosts using external tools, without going through renterd.

## Path parameters

- `key` string, required

## Query parameters

- `bucket` string, required — The name of the bucket.

## Response `200`

Successfully retrieved the object's pinned metadata

- PinnedObject — The raw metadata of an object, suitable for downloading it directly from hosts using external tools.
  - `key` string — The key of the object
  - `mimeType` string — The MIME type of the object
  - `encryptionKey` string — The key used to encrypt the object's slabs
  - `slabs` PinnedSlab[] — The slabs that make up the object
    - `encryptionKey` string — The key used to encrypt the slab's sectors
    - `minShards` integer — The number of data shards needed to reconstruct the slab
    - `sectors` PinnedSector[] — The sectors that make up the slab
      - `root` string — The Merkle root of the sector
      - `hostKey` string — The public key of the host storing the sector
    - `offset` integer — The offset of the object's data within the slab
    - `length` integer — The length of the object's data within the slab

## Other responses

- `400` — Missing bucket or key parameter
- `404` — Object not found

---

[API](https://skmtc.net/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.net/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/revisions/184a3d5207da/schema)