Private Marketplace Direct (PMP-E)
URL https://apidocs.mediamath.com
developers@mediamath.com developers@mediamath.com
License Apache 2.0
Get Deal
You can read more about deals and deal groups (including adding them through MediaMath Platform), deal ownership, and deal best practices here. You may also find it useful for exploring input values.
curl -i -X GET \
'https://api.mediamath.com/deals/v1.0/deals/{id}?currency_code=string' \
-H 'Authorization: string'{
"data": {
"created_on": "2016-11-22T10:24:21+00:00",
"deal_identifier": "416788299328261311",
"description": "",
"end_datetime": "2999-12-31T00:00:00+00:00",
"entity_type": "deal",
"id": 140591,
"name": "Future | Tech | Standards | DELL",
"owner": {
"id": 170605,
"type": "ADVERTISER"
},
"permissions": {
"advertiser_ids": [
170605
],
"agency_ids": [],
"all_organizations": false,
"organization_ids": []
},
"price": {
"currency_code": "GBP",
"value": "4.0000"
},
"price_method": "CPM",
"price_type": "FLOOR",
"start_datetime": "2016-10-31T11:26:59+00:00",
"status": true,
"sub_supply_source_id": null,
"supply_source_id": 8,
"updated_on": "2016-11-22T10:24:21+00:00"
},
"meta": {
"status": "ok"
}
}Update Deal
You can read more about deals and deal groups (including adding them through T1), deal ownership, and deal best practices here. You may also find it useful for exploring input values.
Note: The owner type and ID cannot be altered once the deal has been created.
Bill recipient when creating a deal
the identifier used within a bid request to reference the deal
When updating deal to type PG, price_type must be set to FIXED and valid start_datetime and end_datetime must be present.
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##
List of entities that are allowed to target this deal, which should be either the owner entity or sub-entities of the owner entity. if a higher-level entity is included, then do not include any lower-level entity that is part of the included higher level entity. for example, if an organization X is listed in this parameter, then automatically all agencies and advertisers that are part of the organization X will be included and listing any such agencies and advertisers part of organization X will cause a validation error.
The deal is a "FLOOR" price deal (bids must be above this floor, and will likely clear above this floor) or "FIXED" price deal (bids must be at this price or above, and will clear at the fixed price)
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##
the id of the publisher if the supply_source_id is set to 83 (BidSwitch)
curl -i -X POST \
'https://api.mediamath.com/deals/v1.0/deals/{id}' \
-H 'Content-Type: application/javascript' \
-H 'Cookie: adama_session=<<sessionid>>' \
-d '[object Object]'{
"data": {
"bill_type": "EXCHANGE",
"created_on": "2019-08-19T14:14:59+00:00",
"deal_identifier": "somethingelselongerstring3",
"deal_type": "STANDARD",
"description": "My First Deal Update",
"end_datetime": "2999-12-31T05:00:00+00:00",
"entity_type": "deal",
"id": 384607,
"name": "Alec",
"owner": {
"id": 464566,
"type": "INTERNAL"
},
"permissions": {
"advertiser_ids": [],
"agency_ids": [],
"all_organizations": true,
"organization_ids": []
},
"price": {
"currency_code": "EUR",
"value": "2.7500"
},
"price_method": "CPM",
"price_type": "FLOOR",
"start_datetime": "2999-03-13T16:39:22+00:00",
"status": true,
"sub_supply_source_id": null,
"supply_source_id": 41,
"updated_on": "2019-08-19T14:58:33+00:00"
},
"meta": {
"status": "ok"
}
}curl -i -X GET \
'https://api.mediamath.com/deals/v1.0/deal_groups?all=0&deal_id=0&export=string&ids=string&owner.organization_id=0&page_limit=0&page_offset=0&q=string&sort_by=string&status=true&strategy_id=0' \
-H 'Authorization: string'No response example