---
title: "List pinned objects"
method: GET
path: "/ipfs/pin/list"
tags: ["IPFS » Pins"]
---

# List pinned objects

`GET /ipfs/pin/list`

List objects pinned to local storage

<p>
  <span class="hosted">Hosted</span> Endpoint only available for hosted variant.
</p>

## Query parameters

- `count` integer
- `page` integer
- `order` 'asc' | 'desc'

## Response `200`

Returns pinned objects

- object[]
  - `time_created` integer, required — Creation time of the IPFS object on our backends
  - `time_pinned` integer, required — Pin time of the IPFS object on our backends
  - `ipfs_hash` string, required — IPFS hash of the pinned object
  - `size` string, required — Size of the object in Bytes
  - `state` 'queued' | 'pinned' | 'unpinned' | 'failed' | 'gc', required — State of the pinned object, which is `queued` when we are retriving object. If this is successful the state is changed to `pinned` or `failed` if not. The state `gc` means the pinned item has been garbage collected due to account being over storage quota or after it has been moved to `unpinned` state by removing the object pin.
  - `filecoin` boolean, required — Whether filecoin was used to pin the resource.

## Other responses

- `400` — Bad request
- `403` — Authentication secret is missing or invalid
- `404` — Component not found
- `418` — IP has been auto-banned for extensive sending of requests after usage limit has been reached
- `429` — Usage limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation.md) · [All operations](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/txpipe/blockfrost-io-api-documentation/revisions/4a2f67b16876/schema)