Get Creatives By Account

Retrieve a paginated list of creatives associated with a specific advertiser within an account.

Endpoint

GET

https://lifeapi.pulsepoint.com/RestApi/v2/account/{accountId}/creatives

Path Parameters

Name	Data Type	Required	Notes
accountId	integer	yes	The account ID to retrieve creatives for

Query Parameters

Name	Data Type	Required	Default	Notes
advertiser_id	integer	yes		The advertiser ID to filter creatives by
limit	integer	no	50	Number of results to return per page. Maximum: 100
cursor	string	no		Opaque pagination cursor returned from a previous response. Pass the `next_cursor` value here to retrieve the next page of results

Sample Request

GET https://lifeapi.pulsepoint.com/RestApi/v2/account/456/creatives?advertiser_id=789&limit=50

Response Field List

Name	Data Type	Notes
success	boolean	Returns true on a successful request
message	string	Human-readable result message
requestId	string	Unique identifier for the request
data	object	Wrapper containing results and pagination
data.data	array of objects	List of creative objects returned for the advertiser
data.data.crtid	integer	The creative ID
data.data.addesc	string	The creative name or description
data.data.landingPageDomain	string	The landing page domain associated with the creative
data.data.notes	string	Any notes about the creative
data.data.archived	boolean	Whether the creative is archived
data.data.enabled	boolean	Whether the creative is enabled
data.data.advertiserId	integer	The advertiser ID the creative belongs to
data.data.accountId	integer	The account ID the creative belongs to
data.data.height	string	The creative height in pixels
data.data.width	string	The creative width in pixels
data.data.createdOn	string	Timestamp of when the creative was created. Format: ISO 8601
data.pagination	object	Pagination metadata
data.pagination.limit	integer	The page size used for this response
data.pagination.total	integer	Total number of creatives matching the query
data.pagination.has_more	boolean	Whether additional pages of results exist
data.pagination.next_cursor	string	Opaque cursor to pass as the `cursor` query parameter to retrieve the next page
data.pagination.next_cursor_url	string	Full URL for the next page of results

Sample Response

{
  "success": true,
  "message": "Operation completed successfully",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "data": [
      {
        "crtid": 123456,
        "addesc": "Summer Sale Banner",
        "landingPageDomain": "example.com",
        "notes": "",
        "archived": false,
        "enabled": true,
        "advertiserId": 789,
        "accountId": 456,
        "height": "250",
        "width": "300",
        "createdOn": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "limit": 50,
      "total": 1250,
      "has_more": true,
      "next_cursor": "eyJpZCI6MTIzNDU2fQ",
      "next_cursor_url": "/RestApi/v2/account/456/creatives?advertiser_id=789&cursor=eyJpZCI6MTIzNDU2fQ&limit=50"
    }
  }
}

Errors

HTTP Status	Error	Description
400	Bad Request	Missing or invalid request parameters. `advertiser_id` is required
401	Unauthorized	Invalid or expired access token
403	Forbidden	You do not have permission to access this account
404	Not Found	No advertiser found for the given `advertiser_id`
422	Unprocessable Entity	Business rule violation — e.g., invalid cursor value or `limit` outside the 1–100 range
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error