Organizations
Campaigns API (3.0.1807)
MediaMath Campaign Management API
Download OpenAPI description
Overview
Languages
Servers
Live Server
https://api.mediamath.com/api/v3.0
Request
Get a list of vendors. The data fetched for each vendor depends on the values of query params. For example, if you use query parameter full all properties are fetched.
Security
Auth0(Required scopes:
offline_access
manage:services
)Query
Number of elements in the collection to retrieve
Example: page_limit=100
Index of the first element in the collection to retrieve
Example: page_offset=0
The field to sort by. You can use any field name in ascending or descending order. For ascending order, use the field name directly, e.g., id. For descending order, prefix the field name with a hyphen (-), e.g., -id.
Example: sort_by=id, -id, name, -name
Query search for filtering. This parameter can be used to filter results based on various fields. Supported operators:
==- numeric equality or case-sensitive string identity,==(1,2,3)- IN query (only works for integers),!=- numeric inequality or case-sensitive string non-identity,=:- case-insensitive match, allows substring using * wildcards,<- less than,<=- less than or equal to,>- greater than,>=- greater than or equal to. Examples:q=name=:{search}*to find all results with names starting with {search}.q=status==trueto find all active entities.q=id>=1000to find all entities with id greater than or equal to 1000.q=id==(1,2,3)to find specific entities by ID.q=created_on>1999-02-02orq=created_on>1999-02-02T00:00:00Zto find entities created later than date.q=id>5&status==trueto find all active entities with id greater than 5.
To return all fields, set the value to *. For example, full=* will include all properties.
Example: full=*
- Live Serverhttps://api.mediamath.com/api/v3.0/vendors
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.mediamath.com/api/v3.0/vendors?page_limit=100&page_offset=0&sort_by=id%2C+-id%2C+name%2C+-name&q=string&full=*&detect_domains=true' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
- vendor_collection
- vendor_collection_full
{ "data": [ { … } ], "meta": { "status": "success", "count": 10, "total_count": 100, "offset": 0, "next_page": "string", "prev_page": "string" } }
- Live Serverhttps://api.mediamath.com/api/v3.0/vendors/{vendor_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.mediamath.com/api/v3.0/vendors/{vendor_id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
{ "data": { "id": 0, "version": 0, "name": "string", "adx_approved": true, "adx_declaration_required": true, "adx_vendor_identifier": "string", "mm_contract_available": true, "rate_card_price": 999999999.9999, "rate_card_type": "CPM", "wholesale_price": 999999999.9999, "is_eligible": true, "created_on": "2019-08-24T14:15:22Z", "updated_on": "2019-08-24T14:15:22Z", "description": "string", "vendor_type": "AD_SERVER", "code": "string", "adx_ssl_approved": true, "adx_video_ssl_approved": true, "adx_video_approved": true, "auto_tag_display": true, "provider_tax": 999999.999999, "set_by": "string" }, "meta": { "status": "success" } }