BidRequest.test

Test mode flag: 0, the default, means a live auction, and 1 means the auction is a test and not billable. Added in 2.3.

CurrentintegerOptionalSince 2.3

Field facts

Path: test
Object: BidRequest
Type: integer
Default: 0
Requirement: Optional
Added: OpenRTB 2.3
Spec section: 3.2.1

How it is used

Use it for integration testing against production endpoints. Bidders should not count test auctions toward spend, pacing, or frequency caps, and senders must make sure the flag never stays on in live traffic.

Allowed values

0, 1.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "test": 1
}

Common mistakes

Leaving test at 1 after an integration goes live, so every auction is treated as unbillable.
Sending test traffic to production bidders with test at 0, which can produce real wins and real billing.

Version history

Added in OpenRTB 2.3, and present in the latest snapshot. The table shows how each version's spec text types the field.

Versions	Type in the spec	Required	Deprecated
2.3 to 2.6-202606	integer, default 0	No	No

Related fields

BidRequest.id

Other BidRequest fields

For a walkthrough of the whole object, read Bid request anatomy.