> ## Documentation Index
> Fetch the complete documentation index at: https://cantonfoundation-generated-reference-full-stack-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# POST /v0/wallet/buy-traffic-requests/:tracking_id/status
> Check the status of a buy traffic request with a given tracking id.
Check the status of a buy traffic request with a given tracking id.
```bash cURL theme={null}
curl --request POST \
--url 'https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status' \
--header 'Authorization: Bearer $TOKEN'
```
```python Python theme={null}
import json
import requests
url = "https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status"
headers = {'Authorization': 'Bearer '}
response = requests.request("POST", url, headers=headers)
print(response.text)
```
```javascript JavaScript theme={null}
const response = await fetch('https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status', {
method: 'POST',
headers: {
"Authorization": "Bearer "
},
});
console.log(await response.text());
```
```php PHP theme={null}
'https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
"Authorization: Bearer "
],
]);
$response = curl_exec($curl);
echo $response;
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status", nil)
req.Header.Set("Authorization", "Bearer ")
response, _ := http.DefaultClient.Do(req)
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
```
```java Java theme={null}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var request = HttpRequest.newBuilder()
.uri(URI.create("https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status"))
.header("Authorization", "Bearer ")
.method("POST", HttpRequest.BodyPublishers.noBody())
.build();
var response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
uri = URI('https://example.com/api/validator/v0/wallet/buy-traffic-requests/{tracking_id}/status')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer '
response = Net::HTTP.start(uri.hostname, uri.port) do |http|
http.request(request)
end
puts response.body
```
```json 200 theme={null}
{
"status": ""
}
```
```json 404 theme={null}
{
"error": ""
}
```
## Authorizations
### walletUserAuth
HTTP bearer authentication. Send the token as `Authorization: Bearer <token>`. Bearer format: `JWT`. JWT token as described by the `spliceAppBearerAuth` security scheme. The subject of the token must be ledger API user of the user whose wallet the endpoint affects.
## Path parameters
## Responses
### 200
A request to buy traffic with this tracking id has been submitted before, check the response for details.
application/json
The status of the traffic request created: The request to buy traffic has been created and is waiting for the wallet automation to pick it up. completed: The traffic has been purchased. transaction\_id points to the transaction that purchased traffic. failed: The request to buy traffic has failed permanently and no CC has been transferred. Refer to failure\_reason for details. Use a new tracking\_id if you want to retry buying traffic.
The status of the traffic request created: The request to buy traffic has been created and is waiting for the wallet automation to pick it up. completed: The traffic has been purchased. transaction\_id points to the transaction that purchased traffic. failed: The request to buy traffic has failed permanently and no CC has been transferred. Refer to failure\_reason for details. Use a new tracking\_id if you want to retry buying traffic.
Id of the transaction that purchased traffic.
The status of the traffic request created: The request to buy traffic has been created and is waiting for the wallet automation to pick it up. completed: The traffic has been purchased. transaction\_id points to the transaction that purchased traffic. failed: The request to buy traffic has failed permanently and no CC has been transferred. Refer to failure\_reason for details. Use a new tracking\_id if you want to retry buying traffic.
The reason for the failure of the request to buy traffic. expired: The wallet automation did not process the request in time. rejected: The wallet automation rejected the request, e.g., due to insufficient funds or operational reasons.
Allowed values: expired, rejected.
Human readable description of the rejection reason.
### 404
No request with this tracking id was found.