ar.io DocumentationData
Core data retrieval operations for accessing transaction and data item content. Supports manifest resolution, range requests, caching, and verification status. These endpoints serve as the primary interface for retrieving data from the Permaweb.
Get transaction or data item content
Get the content of a specified transaction or data item. Supports manifest path resolution, range requests, and returns various informational headers about data verification and caching status.
For ANS-104 data items, offset headers are returned to help navigate bundle hierarchies:
- Root offset headers (X-AR-IO-Root-Data-Item-Offset, X-AR-IO-Root-Data-Offset) provide byte offsets from the start of the root L1 transaction
- Parent offset headers provide byte offsets from the start of the immediate parent bundle's payload
- Offset relationships: rootDataItemOffset = rootParentOffset + offset, rootDataOffset = rootParentOffset + dataOffset
Path Parameters
^[0-9a-zA-Z_-]{43}$Header Parameters
Byte range(s) to retrieve
^bytes=\d*-\d*(?:,\d*-\d*)*$Response Body
curl -X GET "https://turbo-gateway.com/string" \ -H "Range: bytes=0-1023"Get transaction or data item headers
Get the headers for a specified transaction or data item without the content. Returns the same headers as the GET request.
Path Parameters
^[0-9a-zA-Z_-]{43}$Header Parameters
Byte range(s) to check
^bytes=\d*-\d*(?:,\d*-\d*)*$Response Body
curl -X HEAD "https://turbo-gateway.com/string" \ -H "Range: bytes=0-1023"Get raw transaction data
Get the raw content of a specified transaction without manifest resolution.
For ANS-104 data items, offset headers are returned to help navigate bundle hierarchies:
- Root offset headers (X-AR-IO-Root-Data-Item-Offset, X-AR-IO-Root-Data-Offset) provide byte offsets from the start of the root L1 transaction
- Parent offset headers provide byte offsets from the start of the immediate parent bundle's payload
- Offset relationships: rootDataItemOffset = rootParentOffset + offset, rootDataOffset = rootParentOffset + dataOffset
Path Parameters
^[0-9a-zA-Z_-]{43}$Header Parameters
Byte range(s) to retrieve
^bytes=\d*-\d*(?:,\d*-\d*)*$Response Body
curl -X GET "https://turbo-gateway.com/raw/string" \ -H "Range: bytes=0-1023"Get raw transaction data headers
Get the headers for raw transaction data without manifest resolution
Path Parameters
^[0-9a-zA-Z_-]{43}$Header Parameters
Byte range(s) to check
^bytes=\d*-\d*(?:,\d*-\d*)*$Response Body
curl -X HEAD "https://turbo-gateway.com/raw/string" \ -H "Range: bytes=0-1023"How is this guide?