Another important JSON interaction for customers to learn is how to retrieve the status of an existing advertising application. Since the general procedure requires that applications be approved by the advertising surface owner (SSP) before bidding begins, developers must be able to programmatically check if a request is pending, approved, or denied.

Example: Checking Application and Creative Status

This example represents the response object received when querying the details of a specific campaign request. It is particularly useful for learning how the system tracks moderation across different inventory owners²².

Endpoint: GET /api/v2/agency/<dsp_agency_id>/dsp/request/<request_id>/

Response Body:

{
  "id": 317,
  "name": "Test Campaign 1",
  "status": [
    {
      "id": 10,
      "ssp_agency": 1,
      "ssp_agency_name": "Demo SSP",
      "campaign": 26,
      "status": 1
    }
  ],
  "ads": [
    {
      "id": 512,
      "title": "Summer Sale Video",
      "status": "approved",
      "rejection_reason": null
    }
  ]
}

Why This Example is Important for Learning

• Understanding Multi-SSP Moderation: The status array shows that a single request can have different statuses across multiple inventory owners (SSPs). Each entry includes a status ID, where values like 1 indicate "Pending Audit", 3 indicate "Approved", and 4 indicate "Denied".

• Creative Validation: The ads array provides feedback on the specific promotional materials attached to the request. If a video is rejected, developers can look for a rejection_reason to understand what needs to be fixed before resubmitting.

• Workflow Integration: This response is essential for implementing step 11 of the general procedure: periodically checking the status of applications and promotional materials⁷. Automated systems can use this data to trigger notifications to account managers when a campaign is ready to go live or needs attention⁸⁸⁸⁸.

• Tracking Campaign Associations: Once approved, the campaign field within the status object provides the ID for the "separate campaign entity" that is created to handle the actual bidding and playback.

By mastering this JSON structure, customers can build sophisticated monitoring tools that track the progress of their advertisements from the initial draft to the active bidding phase.