Skip to main content
POST
/
get-proposals
Get proposals from your agent
curl --request POST \
  --url https://outcome-agent.yourcompany.com/get-proposals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaignId": "camp_123",
  "seatId": "seat_456"
}
'
{
  "proposals": [
    {
      "proposalId": "premium-vcpm-display",
      "execution": "Target premium inventory at $2.50 vCPM with 85% viewability",
      "budgetCapacity": 50000,
      "pricing": {
        "method": "revshare",
        "rate": 0.15,
        "unit": "cpm",
        "currency": "USD"
      },
      "sku": "premium-vcpm",
      "customFieldsRequired": [
        {
          "fieldName": "targetVCPM",
          "fieldType": "number",
          "description": "Target vCPM in USD"
        }
      ],
      "additional_info": {
        "property_list": [
          "prop1",
          "prop2"
        ],
        "custom_data": "value"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
campaignId
string
required

Campaign ID

Example:

"camp_123"

​
seatId
string
required

Seat/account ID for this request

Example:

"seat_456"

​
budgetRange
object

Budget range for campaign planning (buyer typically won't reveal full budget)

​
startDate
string<date-time>

Campaign start date in UTC (ISO 8601 format)

Example:

"2025-01-01T00:00:00Z"

​
endDate
string<date-time>

Campaign end date in UTC (ISO 8601 format)

Example:

"2025-01-31T23:59:59Z"

​
channels
enum<string>[]

Advertising channels (from ADCP specification)

Available options:
display,
video,
native,
audio,
connected_tv
Example:
["display", "video"]
​
countries
string[]

ISO 3166-1 alpha-2 country codes

Example:
["US", "CA"]
​
brief
string

Campaign brief text

Example:

"Launch campaign for new product..."

​
products
object[]

Optional product objects to include in proposals (full product details, not just IDs)

​
propertyListIds
integer<int64>[]

Optional property list IDs for targeting (references Scope3 property lists)

Example:
[123, 456]

Response

Proposals from your agent

​
proposals
object[]

List of proposals you can provide (empty array if none)