Note
If there are no deals, or all deals are filtered out by query criteria, status code 200 will be returned with an empty deal list in the response.
| Error Code | Message | Description |
|---|---|---|
| 200 | OK | Upon a successful GET, PUT, or DELETE request. |
| 201 | Created | Upon a successful POST request. |
| 401 | Unauthorized | Incorrect, missing, or invalid access credentials. |
| 404 | Not Found | The resource you requested is not available. |
| 405 | Method Not Allowed | A request was made of a resource using a request method not supported by that resource; for example, using GET on a method which requires data to be sent by POST, or using PUT on a read-only resource. |
| 408 | Request Timeout | Timeout when processing this request, usually caused by concurrent requests of exclusive access to certain resources. We recommend retrying the request when you receive this status. |
| 422 | Unprocessable Entity | Invalid resource. This error happens when the request body is invalid, or the created/updated resource is invalid. |
| 500 | Internal Server Error | API system error. Contact your DSP account team. |
| 4000 | The account id is invalid | The account ID refers to your particular seat ID. |
| 4020 | Deal ID does not exist | The correct seat ID needs to be assigned. |
Error Handling
POST /deal_assignments Assign a Creative to a Deal
| Error Code | Message | Description |
|---|---|---|
| 404 | The Deal ID doesn’t exist in the seller network or the Deal is part of a Shared External Deal ID, please contact with your seller to use the correct Deal ID for this deal. | The DSP tries to create a deal assignment with Shared External Deal ID enabled, but instead submits the External Deal ID in the request. |
| 422 | User does not have permission to assign this creative to a PMP deal for this particular network. Please reach out to your account team to enable this. | The publisher does not have the pre-approval network function enabled. |
| 422 | User does not have permission to assign this creative to this particular PMP deal. | The DSP assigned ads to a particular deal that does not have the pre-approval permission enabled. |
| 422 | User does not have permission to assign this creative to all PMP deals. | The DSP does not have the PMP deal Demand Creative API permission. |
| 422 | User does not have permission to assign this creative to all PG deals. | The DSP does not have the PG deal Demand Creative API permission. |
DELETE /deal_assignments Delete a Creative's Deal Assignments
| Error Code | Message | Description |
|---|---|---|
| 404 | The Deal ID doesn’t exist in the seller network or the Deal is part of a Shared External Deal ID, please contact with your seller to use the correct Deal ID for this deal. | The DSP tries to delete a deal assignment with Shared External Deal ID enabled, but instead submits the External Deal ID in the request. |