BidRequest.regs

A Regs object listing the legal and regulatory signals that apply, such as COPPA, GDPR, US Privacy, and GPP. Present since 2.2, where the object was called Regulations.

CurrentobjectOptionalSince 2.2

Field facts

Path: regs
Object: BidRequest
Type: object
Requirement: Optional
Added: OpenRTB 2.2
Spec section: 3.2.1

How it is used

Bidders read it before using any personal data in the request. Several of its fields moved out of regs.ext in 2.6, so check that the version you declare matches the paths you send.

Example

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

{
  "id": "req-1",
  "regs": {
    "coppa": 0,
    "gdpr": 0,
    "gpp": "DBABLA~BAAAAAAAQA",
    "gpp_sid": [
      7
    ]
  }
}

Version history

Added in OpenRTB 2.2, 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.2	object	No	No
2.3 to 2.3.1	object	No	No
2.4 to 2.5	object	No	No
2.6-202210 to 2.6-202606	object	No	No

Related fields

Other BidRequest fields

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