The BidTheatre Developer Hub

Welcome to the BidTheatre developer hub. You'll find comprehensive guides and documentation to help you start working with BidTheatre as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Authentication Request

Before you can access any API resources you will need to authenticate yourself by providing your username and password to an authentication endpoint. If successful, the endpoint will return an authorization token, which needs to be provided in all subsequent API calls. The token can be used to access resources from all networks in line with your users access level.

curl -b cookies -c cookies -H "Content-Type: application/json" -d'{"username": "your_username", "password":"your_password"}' -X POST ""
    "apiVersion": 2,
    "code": 200,
    "method": "POST",
    "auth": {
        "role": "campaign_manager",
        "refreshTokenTtl": 604800,
        "fullName": "Your Name",
        "refreshTokenCount": 0,
        "ttl": 3600,
        "email": "[email protected]",
        "token": "2326CED835497C89B9D9BB6E44A293D3514D722F",
        "username": "your_username",
        "refreshToken": "8666B60EF5C908B6302F7E5D405FB50BA7ED75B0"


The token is valid for one (1) hour before it expires.

If a new login attempt is made when a valid token is still available the old token will be reused. To force the generation of an new token, set the forceNewToken to true as indicated below.

curl -b cookies -c cookies -H "Content-Type: application/json" -d'{"username": "your_username", "password":"your_password", "forceNewToken":true}' -X POST ""

Updated 2 years ago

Authentication Request

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.