Requests

Check on the status of pending API requests.

Get Request Status

GET https://api.nfty.dev/v1/requests/:request_id

This API call will retrieve the current status of the blockchain transaction from a previous API call. For example, creating a collection, minting an NFT, or initiating a transfer all return a request_id that you can use to see when the blockchain transaction is completed. If you prefer, you can also use the Webhook Events instead of polling with this API call.

Path Parameters

Name	Type	Description
request_id	string	Pass in a request_id that was returned from a previous API call. Whenever you get a request_id back from an API call, it means the request is being processed by a transaction on the blockchain and will not complete right away. Use this API to determine whether the blockchain transaction is completed or still pending/processing.

Headers

Name	Type	Description
Authorization	string	Your authentication token

200 Possible status values: pending, processing, completed, failed (If this request is related to creating a new NFT token, then the nft_collection and nft_token_id are also returned)

{"request_id":"53e5079d941f14db8a24a8e8647e93071fdff93de9e424796010549fd3e573aa",
 "status":"completed",
 "nft_collection":"0x90de09166cd8ae30dc2bfe25be0f5bd486851cd7",
 "nft_token_id":1}

Example Request:

curl --request GET \
     --url https://api.nfty.dev/v1/requests/12c81219efed57b38068fc3fe3fcdbb9e4f41041f5d1fe8ea8b830dd3bd19586 \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer c4Vftx4kGiFYqpjM/3p4o5pgkmuthLWUNpXNlrig8EjlnSTeVgde4kEBdI1Uc1RFqWJBBRxkOmZ/QcHQXdQNjQ=='

Example Response:

{"request_id":"12c81219efed57b38068fc3fe3fcdbb9e4f41041f5d1fe8ea8b830dd3bd19586",
 "status":"completed",
 "nft_collection":"0x90de09166cd8ae30dc2bfe25be0f5bd486851cd7",
 "nft_token_id":1}