Data Usage




This endpoint returns the total combined size for all content that you've pinned through Pinata.




pinata_api_key: (put your personal pinata api key here)

pinata_secret_api_key: (put your personal pinata secret api key here)


Authorization: Bearer (put your pinata JWT here)

Request Parameters

There are no request parameters for this endpoint.


The response for this call will include the following values:

  • pin_count - The number of pins you currently have pinned with Pinata

  • pin_size_total - The total size of all unique content you have pinned with Pinata (expressed in bytes).

  • pin_size_with_replications_total - The total size of all content you have pinned with Pinata. This value is derived by multiplying the size of each piece of unique content by the number of times that content is replicated.

This value will be expressed in bytes.

Postman Example

JavaScript With Axios Example

In the javascript example below, we pass in our API keys from elsewhere (hopefully in a secure way).

const axios = require('axios');
export const userPinList = (pinataApiKey, pinataSecretApiKey) => {
const url = ``;
return axios
.get(url, {
headers: {
pinata_api_key: pinataApiKey,
pinata_secret_api_key: pinataSecretApiKey
.then(function (response) {
//handle response here
.catch(function (error) {
//handle error here

We want your feedback!

Have a suggestion? Have a complaint? Confused about something in the documentation? Just want to say hi?

We want to make Pinata the best product available. That involves listening to our users and addressing their needs.

Send us an email at [email protected] and we'll see how we can help.