---
title: "Get details about pinned object"
method: GET
path: "/ipfs/pin/list/{IPFS_path}"
tags: ["IPFS » Pins"]
---

# Get details about pinned object

`GET /ipfs/pin/list/{IPFS_path}`

Get information about locally pinned IPFS object

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

## Path parameters

- `IPFS_path` string, required — The path to the IPFS object

## Response `200`

Returns the pins pinned

- object
  - `time_created` integer, required — Time of the creation of the IPFS object on our backends
  - `time_pinned` integer, required — Time of the pin 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. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`. When the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`. If the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise. When object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection. State `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota.
  - `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)