Retrieve the status of a transaction by its hash.
POSThttps://minatokens.com/api/v1//transaction/status
The tx-status
endpoint allows you to check the current status of a transaction on the Mina blockchain by providing the transaction hash. It returns whether the transaction has been applied, failed, or is still pending.
Request
- application/json
Bodyrequired
The transaction hash to check the status of.
Responses
- 200
- 400
- 401
- 403
- 429
- 500
- 503
Successfully retrieved transaction status.
- application/json
- Schema
- Example (auto)
- txStatusSuccess
Schema
The transaction hash.
The status of the transaction.
Possible values: [pending
, applied
, failed
, unknown
]
The transaction hash.
details object
{
"hash": "string",
"status": "pending",
"error": "string",
"details": {
"blockHeight": 0,
"stateHash": "string",
"blockStatus": "string",
"timestamp": 0,
"txHash": "string",
"txStatus": "string"
}
}
Example of a successful tx-status response
{
"hash": "5JuEaWqCkiizzjA3mjrva5hjYeohiGKQFcffUdZxrEJM4xDirhK1",
"status": "applied"
}
Bad request - invalid input parameters.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Unauthorized - user not authenticated.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Forbidden - user doesn't have permission.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Too many requests.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Internal server error - something went wrong during the request.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Service unavailable - blockchain or other external service is down.
- application/json
- Schema
- Example (auto)
Schema
Error message detailing the issue.
{
"error": "string"
}
Authorization: x-api-key
name: x-api-keytype: apiKeyin: headerdescription: API key for authorization. Get your API key at https://minatokens.com/api
- curl
- javascript
- nodejs
- python
- rust
- ocaml
- go
- java
- powershell
- CURL
curl -L 'https://minatokens.com/api/v1/transaction/status' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'x-api-key: <x-api-key>' \
-d '{
"hash": "string"
}'