Get Pixels By Account

Returns a cursor-paginated list of pixels associated with a given account. Includes retargeting, conversion, and smart pixels. Results can be filtered by advertiser or pixel type. Results are ordered: retargeting pixels first (sorted by id), then conversion pixels (sorted by id), then smart pixels (sorted by id).

Endpoint

GET

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

Path Parameters

Name	Data Type	Required	Notes
accountId	integer	yes	The account ID the pixel is associated with

Query Parameters

Name	Data Type	Required	Default	Notes
advertiser_id	integer	no		Filter results to a single advertiser ID
type	ENUM string	no		Filter by pixel type. Valid values: `retargeting`, `conversion`, `smart`
limit	integer	no	50	Maximum number of results per page (max: 100)
cursor	string	no		Opaque pagination cursor. Pass the `next_cursor` value from a previous response to get the next page

Sample Request

GET https://lifeapi.pulsepoint.com/RestApi/v2/account/323455/pixels?advertiser_id=1234&type=retargeting&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 pixel objects
data.data.id	integer	Unique identifier for the pixel
data.data.name	string	Name of the pixel
data.data.type	string	Pixel type. One of: `retargeting`, `conversion`, `smart`
data.data.active	boolean	Whether the pixel is active
data.data.advertiser_id	integer	Advertiser ID associated with the pixel
data.data.account_id	integer	Account ID associated with the pixel
data.pagination	object	Pagination metadata
data.pagination.limit	integer	The page size used for this response
data.pagination.total	integer	Total number of pixels 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": [
      {
        "id": 123456,
        "name": "Rachel Pixel",
        "type": "retargeting",
        "active": true,
        "advertiser_id": 1234,
        "account_id": 323455
      },
      {
        "id": 123457,
        "name": "Rachel Pixel 2",
        "type": "conversion",
        "active": true,
        "advertiser_id": 1234,
        "account_id": 323455
      }
    ],
    "pagination": {
      "limit": 50,
      "total": 127,
      "has_more": true,
      "next_cursor": "eyJpZCI6MTIzNDU3fQ==",
      "next_cursor_url": "/RestApi/v2/account/323455/pixels?cursor=eyJpZCI6MTIzNDU3fQ==&limit=50"
    }
  }
}

Errors

HTTP Status	Error	Description
400	Validation Error	Invalid query parameters. `type` must be one of: `retargeting`, `conversion`, `smart`
401	Unauthorized	Invalid or expired access token
403	Forbidden	You do not have permission to access this account, or the advertiser ID does not belong to this account
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Unexpected server error