Skip to main content
GET
/
api
/
ipfs
/
stat
Stat IPFS object
curl --request GET \
  --url https://nexus.gerowallet.io/api/ipfs/stat \
  --header 'Authorization: Bearer <token>'
{
  "cid": "<string>",
  "size": 123,
  "cumulativeSize": 123,
  "type": "<string>",
  "blocks": 123
}
Returns metadata for an IPFS object without downloading it: its cid, size, cumulativeSize (total DAG size in bytes), type (file or dir), and blocks. Useful to check size/type before fetching, e.g. NFT media.
Requires the IPFS add-on (X-Api-Key). Node-only — there is no Blockfrost fallback; if the self-hosted node is unavailable this returns 503.
Example
curl "https://nexus.gerowallet.io/api/ipfs/stat?path=QmV7xw3QtGgqWR3PXtJSJdFKkW4ZhELmBwJS6edhVyKFVL" \
  -H "X-Api-Key: $NEXUS_API_KEY"

Authorizations

​
Authorization
string
header
required

JWT Token Authentication

Query Parameters

​
path
string
required
Maximum string length: 500

Response

200 - application/json

OK

​
cid
string
​
size
integer<int64>
​
cumulativeSize
integer<int64>
​
type
string
​
blocks
integer<int64>