---
title: "Render previews of an existing ad"
method: GET
path: "/v1/ads/{adId}/preview"
tags: ["Ad Creatives"]
---

# Render previews of an existing ad

`GET /v1/ads/{adId}/preview`

Renders an EXISTING ad per placement via Meta's `/{ad_id}/previews`. Each preview is an HTML
`<iframe>` snippet embeddable directly. Unknown `formats` values return Meta's 400 verbatim.

## Path parameters

- `adId` string, required

## Query parameters

- `formats` string

## Response `200`

Rendered previews

- object
  - `adId` string
  - `previews` object[]
    - `format` string
    - `html` string, nullable — Meta's <iframe> snippet; null when Meta returned no preview for the format.

## Other responses

- `400` — Invalid input, or Meta rejected the ad_format — message carries Meta's error
- `401` — Unauthorized
- `404` — Ad not found
- `429` — Meta rate limit reached
- `501` — Only supported on Meta (facebook/instagram)

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)