List All CARs

GET /vendor//cars - Get all Creative Approval Requests.

GET /vendor/{org_token}/cars

Returns all Creative Approval Requests (CARs) for your organization. Use this to build approval workflows in your own dashboard, allowing stakeholders to review creatives without logging into the Screen Manager.

Path parameters

Parameter	Type	Required	Description
org_token	string	Yes	Your organization token (find it here)

Example request

curl -X GET "https://api.framen.com/vendor/Org_9WeJxcVrRnM/cars"

The CAR object

Field	Type	Description
car_id	string	Unique identifier for the Creative Approval Request
created_on	string	Timestamp when the CAR was created
status	string	Current status of the approval request
advertiser_name	string	Name of the advertiser
cities	array	Target cities for the campaign
countries	array	Target countries for the campaign
rejection_reasons	array	Reasons for rejection, if applicable
custom_message	string	Custom message attached to the CAR
creative	object	The creative media attached to this CAR

The Creative object

The creative object is equivalent to the ad object in the Get Spot response.

Field	Type	Description
id	string	Creative ID
title	string	Creative name
mimeType	string	Content type (e.g., video/mp4, image/jpeg)
height	int	Content height in pixels
width	int	Content width in pixels
duration	int	Playback duration in milliseconds
size	int	File size in bytes
url	string	URL to download or preview the creative

Example response

[
  {
    "car_id": "car_abc123",
    "created_on": "2026-03-15T10:30:00Z",
    "status": "PENDING",
    "advertiser_name": "Acme Corp",
    "cities": ["Berlin", "Munich"],
    "countries": ["DEU"],
    "rejection_reasons": [],
    "custom_message": "",
    "creative": {
      "id": "Itm_cgK3bmLgWMC",
      "title": "Spring Campaign 2026",
      "mimeType": "video/mp4",
      "height": 1080,
      "width": 1920,
      "duration": 15000,
      "size": 4521984,
      "url": "https://d3kdzyvtj6vooy.cloudfront.net/creative-opt.mp4"
    }
  }
]

Response

Returns an array of CAR objects.