---
title: "Bid Request Tool"
slug: "bid-request-tool"
updated: 2025-12-15T20:58:05Z
published: 2025-12-15T20:58:05Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.tritondigital.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bid Request Tool

Users with the Programmatic Publisher or Ad network role can view programmatic bid requests and responses with **TAP > TAP Settings > Programmatic > Bid Request Tool**. Use this tool when troubleshooting deals that aren’t generating revenue or campaigns that are not running as expected.

> [!NOTE]
> Also see:
> 
> - [Deals](/user/docs/tap-deals)
> - [Deal Audit Logs](/user/docs/deal-audit-logs-tap)
> - [OpenRTB Implementation](/user/docs/openrtb-implementation)
> - [TAP User Roles](/user/docs/user-roles)

![](https://cdn.document360.io/7124b381-0a94-401a-abbd-9df9c4ea5dff/Images/Documentation/Bid-Request-Tool.png)

> [!NOTE]
> The Bid Request Tool is a safe way to see bid requests and responses. It does not affect your bids, it only takes samples of bids for you to inspect.

You create samples with the Bid Request Tool. A *sample*captures bids that match criteria that you specify, such as **Demand Partner**, **Station**, and **Deal ID**. You can also specify how long the sample should be in effect and how many bids to collect. When the sample is complete, you can view and download the results.

## Create a Sample

TAP starts collecting bids when you save the sample. A sample stops collecting bids when it reaches its **TTL**(time to live) or **Number of results**, which ever happens first.

You cannot pause, edit, or delete a sample. TAP automatically archives samples after 30 days.

> [!TIP]
> For quick results, use the default **TTL**and **Number of results**. If a sample doesn’t capture bids, then create a new sample with a longer TTL.

![](https://cdn.document360.io/7124b381-0a94-401a-abbd-9df9c4ea5dff/Images/Documentation/Bid-Request-Tool-Sample.png)

1. Switch to the TAP organization to get bid request samples.
2. Go to **TAP > TAP Settings > Programmatic > Bid Request Tool.**
3. Select **Create new sample**.
4. To capture bid responses or requests, check or uncheck **Bid response** or **Bid request**. You must check at least one.
5. Choose a **Demand Partner**.
6. Optional: In **Station**, enter a station or podcast.
7. In **Description**, enter a useful summary for the sample.
8. Optional: Enter a **Deal ID**.
9. Optional: In **TTL**, enter how many hours you want to capture bids before the sample expires or completes. The default is **1** hour.
10. Optional: In **Number of results**, enter how many bid requests and responses you want to capture. The default is **1** result.
11. To start the sample, select **Create new sample**.

## View or Download a Sample

The list of samples shows details about the sample, including its status.

| Sample status | Description |
| --- | --- |
| **Pending** | The sample is in progress. |
| **Expired** | The sample did not collect any bids because there were no bids that matched the sample’s criteria. Try creating a new sample with a longer **TTL**. |
| **Completed** | The sample has finished capturing bids that matched its criteria. You can view or download its results. |

You can see a completed sample’s results by selecting its options menu.

![](https://cdn.document360.io/7124b381-0a94-401a-abbd-9df9c4ea5dff/Images/Documentation/Bid-Request-Tool-Options.png)

- **Download CSV**: Generate and download a CSV file containing the captured bids.
- **View JSON**: See the captured bids in JSON format.

For information on the fields in a sample’s results, see [OpenRTB Implementation](/user/docs/openrtb-implementation).