To check if your ad has been approved and is ready to enter the auction, you use a GET request. This is Step 11 in the general procedure: "Checking the status of advertising materials."

Checking the Ad Approval Status

You will query the specific Ad ID (e.g., 1024) that you received in the previous step.

Endpoint Structure: GET https://api.dooh.one/api/v2/agency/{YOUR_AGENCY_ID}/dsp/ad/{AD_ID}/

Example Command (cURL)

curl -i -X GET \
  -H 'x-authorization: Bearer <access_token>' \
  -H 'x-adexchange-role: dsp' \
  'https://api.dooh.one/api/v2/agency/2/dsp/ad/1024/'

Understanding the Response

The system will return the current state of your creative. There are three main statuses to look for:

1. Approved (Ready to Play)

If the screen owner has reviewed and accepted your content, you will see:

{
  "id": 1024,
  "status": "approved",
  "audit_comment": "Content meets all guidelines.",
  "updated_at": "2024-05-20T16:00:00Z"
}

2. Pending Audit (Still Waiting)

The ad has been uploaded but has not been reviewed by the moderator yet.

{
  "id": 1024,
  "status": "pending_audit"
}

3. Rejected (Action Required)

If the content is rejected, the audit_comment is vital as it tells you why (e.g., incorrect resolution, prohibited content).

{
  "id": 1024,
  "status": "rejected",
  "audit_comment": "Video contains prohibited flashing lights for this venue.",
  "rejected_at": "2024-05-20T15:45:00Z"
}

Pro-Tips for Developers

• Polling Logic: Don't check the status every second. Moderation is often a manual process. Checking once every few hours or once a day is standard.

• The "Approved" Trigger: Once an ad is approved, and assuming your campaign balance is positive and the campaign is active, the system will automatically start placing bids on your behalf.

• Multiple Ads: If you have multiple ads in one campaign, you can query the campaign endpoint to see the status of all ads at once.