Skip to main content
GET
/
vendor
/
{org_token}
/
cars
/
{car_id}
Get a creative
curl --request GET \
  --url https://api.framen.com/vendor/{org_token}/cars/{car_id}

Documentation Index

Fetch the complete documentation index at: https://docs.framen.com/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve a single Creative Approval Request by its ID. Use this to fetch detailed information about a specific creative submission.
org_token
string
required
Your organization token (e.g., Org_4KmTqZnWpLx).
car_id
string
required
The CAR identifier (e.g., car_Xy7Kp2mN9qR4).

Response

Returns a single CAR object with complete details including the creative asset information, current status, and timestamp.
FieldTypeDescription
car_idstringUnique CAR identifier
statusstringCurrent status: pending, approved, or rejected
advertiser_namestringName of the advertiser
citiesarrayArray of targeted city names
countriesarrayArray of targeted country codes
itemobjectCreative asset object (see Overview for full schema)
rejection_reasonsarray | nullRejection reasons if rejected, otherwise null
custom_messagestring | nullCustom rejection message if provided
created_onstringISO 8601 creation timestamp

Example Request

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

Example Response

{
  "car_id": "car_Xy7Kp2mN9qR4",
  "status": "pending",
  "advertiser_name": "Acme Corporation",
  "cities": ["Berlin", "Munich"],
  "countries": ["DEU"],
  "item": {
    "url": "https://assets.example.com/creatives/acme-summer-2026.mp4",
    "title": "Acme Summer Campaign",
    "width": 1920,
    "height": 1080,
    "duration": 15,
    "mimeType": "video/mp4",
    "size": 2456789,
    "md5": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
  },
  "rejection_reasons": null,
  "custom_message": null,
  "created_on": "2026-03-28T14:30:00Z"
}

Error Responses

StatusDescription
404CAR not found or invalid car_id
Last modified on April 17, 2026