Atlas

Operations related to the Atlas global namespace.

Get attachment by hash

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/v2/attachments/{hash}

Get an attachment by its hash. Attachments are content stored in the Atlas network.

The attachment hash is a 40-character hex string (SHA-1 hash).

Path parameters

hashstringRequired

Hex-encoded SHA-1 hash of the attachment (40 characters)

Pattern: ^[0-9a-f]{40}$

Responses

200

The attachment content

application/json

400

Bad request

text/plain

stringOptional

404

Not found

text/plain

get

/v2/attachments/{hash}

HTTPcURLJavaScriptPython

GET /v2/attachments/{hash} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "attachment": "Ynl0ZXM="
}

Get attachment inventory

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/v2/attachments/inv

Get inventory of attachments for a given index block hash and page range. This returns a bitfield indicating which attachments are available.

Query parameters

index_block_hashstringRequired

Hex-encoded index block hash (64 characters)

Pattern: ^[0-9a-f]{64}$

pages_indexesstringRequired

Comma-separated list of page indexes to query.

• Maximum 8 pages per request
• Each index must be 0-4294967295 (u32 range)
• Values outside u32 range return 400 Bad Request

Example: 1,2,3Pattern: ^[0-9]{1,10}(,[0-9]{1,10}){0,7}$

Responses

200

Attachment inventory bitfield

application/json

400

Bad request

text/plain

stringOptional

404

Not found

text/plain

get

/v2/attachments/inv

HTTPcURLJavaScriptPython

GET /v2/attachments/inv?index_block_hash=text&pages_indexes=1%2C2%2C3 HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "block_id": "0123456789abcdef0123456789abcdef0123456789abcdef",
  "pages": [
    {
      "index": 1,
      "inventory": [
        255,
        0,
        255,
        0
      ]
    },
    {
      "index": 2,
      "inventory": [
        0,
        255,
        0,
        255
      ]
    }
  ]
}