Block transactions

GET /blocks/:hash_or_number/txs

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.

Return the transactions within the block.

Request

Path Parameters

hash_or_number 64-character case-sensitive hexadecimal string or block number. required
Hash of the requested block.
Example: 4873401

Query Parameters

count integer

Possible values: >= 1 and <= 100

Default value: 100

The number of results displayed on one page.

page integer

Possible values: >= 1 and <= 21474836

Default value: 1

The page number for listing the results.

order string

Possible values: [asc, desc]

Default value: asc

Ordered by tx index in the block. The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

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

---

Return the contents of the block

application/json

Schema

Example (from schema)

---

Schema

• Array [
• string

  Hash of the transaction

• ]

[
  "8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b",
  "4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036",
  "52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f",
  "e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"
]

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 /blocks/:hash_or_number/txs

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_or_number — path required

count — query

page — query

order — query

---ascdesc

curl / cURL

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

python / requests

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

go / native

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

nodejs / axios

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

ruby / Net::HTTP

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

csharp / RestSharp

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

php / cURL

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

java / OkHttp

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

powershell / RestMethod

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