curl --request GET \
--url https://api.pinata.cloud/data/pinList \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pinata.cloud/data/pinList"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pinata.cloud/data/pinList', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pinata.cloud/data/pinList",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pinata.cloud/data/pinList"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pinata.cloud/data/pinList")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pinata.cloud/data/pinList")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"rows": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ipfs_pin_hash": "<string>",
"size": 123,
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_pinned": "2023-11-07T05:31:56Z",
"date_unpinned": "2023-11-07T05:31:56Z",
"metadata": {
"name": "<string>",
"keyvalues": {}
},
"regions": [
{
"regionId": "<string>",
"currentReplicationCount": 123,
"desiredReplicationCount": 123
}
],
"mime_type": "<string>",
"number_of_files": 123
}
]
}List Files
List all the files on your Pinata account
curl --request GET \
--url https://api.pinata.cloud/data/pinList \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pinata.cloud/data/pinList"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pinata.cloud/data/pinList', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pinata.cloud/data/pinList",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pinata.cloud/data/pinList"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pinata.cloud/data/pinList")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pinata.cloud/data/pinList")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"rows": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ipfs_pin_hash": "<string>",
"size": 123,
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_pinned": "2023-11-07T05:31:56Z",
"date_unpinned": "2023-11-07T05:31:56Z",
"metadata": {
"name": "<string>",
"keyvalues": {}
},
"regions": [
{
"regionId": "<string>",
"currentReplicationCount": 123,
"desiredReplicationCount": 123
}
],
"mime_type": "<string>",
"number_of_files": 123
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
false
CID of file you are searching for
Filters by group id if applicable
ISO_8601 format date to filter by start date for when file was pinned
ISO_8601 format date to filter by end date for when file was pinned
ISO_8601 format date to filter by start date for when file was unpinned
ISO_8601 format date to filter by end date for when file was unpinned
Minimum size in bytes of files to return
Maximum size in bytes of files to return
Options are "all", "pinned", or "unpinned"
Maximum number of files to return. Default is 10, max is 1000
Use to paginate through files, default is 0
See metadata querying section below
Response
Response
Show child attributes
Show child attributes