Transaction metadata

GET /txs/:hash/metadata

Authorization

name: project_idtype: apiKeyin: headerdescription: There are multiple token types available based on network you choose
when creating a Blockfrost a project, for a list of token types
see available networks.

Obtain the transaction metadata.

Request

Path Parameters

hash 64-character case-sensitive hexadecimal string. required
Hash of the requested transaction
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Responses

• 200
• 400
• 403
• 404
• 418
• 429
• 500

---

Obtain metadata information associated with a specific transaction.

application/json

Schema

Example (from schema)

---

Schema

• Array [
label string required

Metadata label

json_metadata objectrequired
Content of the metadata
oneOf
MOD1
---
string
• ]

[
  {
    "label": "1967",
    "json_metadata": {
      "metadata": "https://nut.link/metadata.json",
      "hash": "6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af"
    }
  },
  {
    "label": "1968",
    "json_metadata": {
      "ADAUSD": [
        {
          "value": "0.10409800535729975",
          "source": "ergoOracles"
        }
      ]
    }
  }
]

Bad request

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 400,
  "error": "Bad Request",
  "message": "Backend did not understand your request."
}

Authentication secret is missing or invalid

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 403,
  "error": "Forbidden",
  "message": "Invalid project token."
}

Component not found

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

IP has been auto-banned for extensive sending of requests after usage limit has been reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 418,
  "error": "Requested Banned",
  "message": "IP has been auto-banned for flooding."
}

Usage limit reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 429,
  "error": "Project Over Limit",
  "message": "Usage is over limit."
}

Internal Server Error

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 500,
  "error": "Internal Server Error",
  "message": "An unexpected response was received from the backend."
}

GET /txs/:hash/metadata

Authorization

name: project_idtype: apiKeyin: headerdescription: There are multiple token types available based on network you choose
when creating a Blockfrost a project, for a list of token types
see available networks.

Request

Base URL

https://cardano-mainnet.blockfrost.io/api/v0

project_id

hash — path required

curl / cURL

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

python / requests

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

go / native

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

nodejs / axios

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

ruby / Net::HTTP

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

csharp / RestSharp

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

php / cURL

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

java / OkHttp

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'

powershell / RestMethod

curl -L -X GET 'https://cardano-mainnet.blockfrost.io/api/v0/txs/:hash/metadata' \
-H 'Accept: application/json' \
-H 'project_id: <API_KEY_VALUE>'