OppiziDeveloper
API ReferenceAudiences & Designs

List your designs

GET
/client/designs

Your own flyer and mail-piece designs. Filter by format or status, search by name, and sort.

name is the file name the design was uploaded under, and that is what search matches. Use a design's id with Choose the creative.

Authorization

ClientBearer
AuthorizationBearer <token>

Client-scoped key as a Bearer JWT; always pinned to your own client.

In: header

Query Parameters

search?string

Design-name/text search.

status?string

Filter by design status.

Response Body

application/json

curl -X GET "https://example.com/client/designs"
{  "success": true,  "data": {    "designs": [      {        "id": "812",        "name": "spring-postcard-v2.pdf",        "clientId": "450",        "format": "POSTCARD_6X9",        "status": "READY",        "thumbnailUrl": "https://…/thumb.png"      }    ],    "pagination": {      "currentPage": 1,      "totalPages": 1,      "totalItems": 1    }  }}
Empty
Empty
Empty
Empty
Empty