Listing files

Legacy: This page documents Filebase's IPFS tier. For new deployments, use the S3-compatible object storage tier with the s3.filebase.io endpoint.

Console

In the Filebase Console, click into an IPFS bucket to see all pinned files with their CIDs.

S3 API

aws --endpoint https://s3.filebase.com s3 ls s3://my-ipfs-bucket/

Or in JSON form:

aws --endpoint https://s3.filebase.com s3api list-objects-v2 \
  --bucket my-ipfs-bucket

Each object's CID is exposed as the x-amz-meta-cid metadata header — fetch it via head-object:

aws --endpoint https://s3.filebase.com s3api head-object \
  --bucket my-ipfs-bucket --key photo.jpg

Pinning Service API

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.filebase.io/v1/ipfs/pins

Returns a paginated list of pins with name, CID, and status.

What's next

• Pinning files
• Deleting files