Skip to main content
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

ParameterTypeRequiredDescription
org_tokenstringYesYour organization token (find it here)

​
Example request

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

​
The CAR object

FieldTypeDescription
car_idstringUnique identifier for the Creative Approval Request
created_onstringTimestamp when the CAR was created
statusstringCurrent status of the approval request
advertiser_namestringName of the advertiser
citiesarrayTarget cities for the campaign
countriesarrayTarget countries for the campaign
rejection_reasonsarrayReasons for rejection, if applicable
custom_messagestringCustom message attached to the CAR
creativeobjectThe creative media attached to this CAR

​
The Creative object

The creative object is equivalent to the ad object in the Get Spot response.
FieldTypeDescription
idstringCreative ID
titlestringCreative name
mimeTypestringContent type (e.g., video/mp4, image/jpeg)
heightintContent height in pixels
widthintContent width in pixels
durationintPlayback duration in milliseconds
sizeintFile size in bytes
urlstringURL 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.