# Requests

## Get Request Status

<mark style="color:blue;">`GET`</mark> `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 |

{% tabs %}
{% tab title="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}
```

{% endtab %}
{% endtabs %}

#### 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}
```