> For the complete documentation index, see [llms.txt](https://docs.wetez.io/wetez/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wetez.io/wetez/developer/storage/pin_ls.md).

# pin\_ls

## /api/v0/pin/ls

Lists object pinned to local storage.

### REQUEST

{% tabs %}
{% tab title="Syntax" %}

```bash
curl "https://mainnet-rpc.wetez.io/ipfs/$AdminKey/api/v0/pin/ls?arg=<ipfs-path>&type=all&quiet=<value>&stream=<value>" \
    -X POST
```

{% endtab %}

{% tab title="Example" %}

```bash
curl "https://ipfs.infura.io:5001/api/v0/pin/ls?arg=QmfQ5QAjvg4GtA3wg3adpnDJug8ktA1BxurVqBD8rtgVjM" \
    -X POST
```

{% endtab %}
{% endtabs %}

#### REQUEST PARAMS

* `arg` *\[Required]* - Path to object(s) to be listed.
* `type` *\[Optional]* - The type of pinned keys to list. Can be `direct`, `indirect`, `recursive`, or `all`. The default is `all`.
* `quiet` *\[Optional]* - Write just hashes of objects.
* `stream` *\[Optional]* - Enable streaming of pins as they are discovered.

### RESPONSE

On success, the call to this endpoint returns with 200 and the following body:

#### BODY

```json
{
  "PinLsList": {
    "Keys": {
      "<string>": {
        "Type": "string"
      }
    }
  },
  "PinLsObject": {
    "Cid": "string",
    "Type": "string"
  }
}
```