ar.io Logoar.io Documentation
Testnet Sandbox

Accessing Data

The gateway at ar-io.dev indexes your upload optimistically — usually within seconds — then serves and queries it.

Fetching your data

  • Exact bytes: GET https://ar-io.dev/raw/<id> returns the data item's exact bytes, unmodified, with no redirect.
  • Rendered / path-aware: GET https://ar-io.dev/<id> serves the content and, for manifests, resolves paths (e.g. /<manifest-id>/index.html). For browser security the gateway 302-redirects each item to its own sandbox subdomainhttps://<base32(id)>.ar-io.dev/<id> — so each item is isolated on its own origin. Follow redirects (curl -L; browsers do it automatically).

Querying with GraphQL

POST https://ar-io.dev/graphql — query your data by id, tags, or owner as soon as it's indexed:

query {
  transactions(first: 1, owners: ["<your-address>"]) {
    edges { node { id tags { name value } } }
  }
}

Data response headers

On a data fetch (/raw/<id> or the sandbox /<id>):

HeaderMeaning
x-ar-io-data-idThe data item id served
x-ar-io-verifiedfalse here — optimistic sandbox data, not weave-verified
x-ar-io-trustedtrue — served from the trusted sandbox bundler
x-ar-io-stablefalse — the tx is not in a stable (mainnet) block (it never will be)
x-ar-io-digest / content-digest / etagsha-256 of the bytes (integrity / caching)
x-ar-io-hops, x-cacheGateway hop count; cache HIT/MISS
x-arweave-owner-address, x-arweave-tag-*The data item's owner and ANS-104 tag metadata

Seeing x-ar-io-verified: false is expected and correct on this sandbox — the data isn't on mainnet Arweave. Don't treat it as an error.

ArNS resolution headers

On an ArNS resolution (https://<name>.ar-io.dev):

HeaderMeaning
x-arns-name / x-arns-basenameThe resolved name
x-arns-resolved-idThe target data id the name points at
x-arns-recordThe record served (@ = apex, else the undername)
x-arns-ttl-secondsResolution TTL (e.g. 3600)
x-arns-ant-id / x-arns-ant-program-idThe backing ANT and the devnet ANT program
x-arns-undername-limit, x-arns-record-indexUndername capacity and record index

Next steps

How is this guide?