What are Creative Approval Requests (CARs)?
Creative Approval Requests are a critical part of your screen network management workflow. When advertisers want to run their creatives on your screens, they submit a CAR containing the creative asset (image or video), advertiser information, and campaign details. As a screen network operator, you review these submissions and decide whether to approve or reject them based on your content standards and business requirements.CAR Lifecycle
Every Creative Approval Request follows a four-stage lifecycle:- Pending: A new CAR arrives in your queue with status
pending. The advertiser has submitted a creative for review. - Review: You examine the creative asset, advertiser information, targeting details, and campaign context.
- Decision: You either approve the creative to make it eligible for delivery, or reject it with specific reasons.
- Active: Approved creatives with active campaigns become candidates for ad delivery on your screens.
CAR Object
A Creative Approval Request contains the following properties:| Field | Type | Description |
|---|---|---|
| id | string | Unique CAR identifier (e.g., car_Xy7Kp2mN9qR4) |
| status | string | Current status: pending, approved, or rejected |
| advertiser_name | string | Name of the advertiser submitting the creative |
| campaign_name | string | Name of the advertising campaign |
| creative | object | The creative asset object (see below) |
| rejection_reasons | array | null | Array of rejection reason codes if rejected, otherwise null |
| custom_message | string | null | Custom message provided during rejection, if applicable |
| created_at | string | ISO 8601 timestamp when CAR was created |
| updated_at | string | ISO 8601 timestamp when CAR was last modified |
Creative Sub-Object
Thecreative object contains details about the media asset:
| Field | Type | Description |
|---|---|---|
| url | string | URL to the creative media file (image or video) |
| width | integer | Width of the creative in pixels |
| height | integer | Height of the creative in pixels |
| duration | integer | Duration in seconds (0 for static images) |
| mime_type | string | MIME type of the asset (e.g., video/mp4, image/jpeg) |
Example CAR Object
Active Creatives
Thecars_active endpoint returns a filtered list of approved CARs whose campaigns are forecasted to deliver to your screens soon. This is useful for pre-caching creative assets to your content delivery infrastructure before ads are scheduled to run.
Use this endpoint periodically to:
- Download and cache video/image assets locally
- Validate creative quality before delivery
- Prepare your screens for upcoming ad campaigns
- Monitor active advertising campaigns in your network