Pagination

Pagination

API that return collections will return resources in paginated format. Pagination is performed even if no more than one page of data exists.

• API requests use a query string argument to specify the pagination parameter
• limit parameter MUST be used to specify the maximum number of resources to return per page
• Client SHOULD NOT use limit value to determine whether additional pages of resources exist
• Client SHOULD use next to determine if additional pages exist

Limit Parameter

Name
limit

Pattern

GET {url}/{version}/orgs/{orgId}/{resource_type}?limit={value}

Path Example

GET {url}/v1/orgs/9467895078742654934/notifications?limit=3

Pagination Properties

Name
pagination.cursors
pagination.cursors.after
pagination.next

The following API support pagination:

Resource	Service
Brand	Get
Brand Asset	Get
Feedback	Get
Notifications	Get
Location Asset	Get
Showcase	Get
Showcase Creative	Get

Cursor-based Pagination

Cursor-based pagination uses an opaque, ephemeral cursor that is used with the after query string arguments to retrieve the next pages of data. The value of the cursor is an internal object ID and is not the ID of the object exposed to the client.

Pagination is forward-only for every resource that supports it. There is no before or previous cursor for retrieving a prior page.

Example Pagination

Path

GET {url}/v1/orgs/9467895078742654934/notifications?limit=3

Four notification resources exist in total. The initial response only returns the first three resources because of the limit. The second page will exclude after and next because no more resource are available.

Example Response Body (raw JSON)

{
  "data": [
    {
      "orgId": "9467895078742654934",
      "id": "9467895078742654924",
      "createdDate": "2026-10-10T17:32:05.00Z",
      "type": "VALIDATION_FAILURE",
      "feedbackUrl": "/v1/orgs/9467895078742654934/feedback?ql=id==9467895078742654900",
      "resourceDetails": {
        "resourceType": "LOCATION",
        "resourceId": "9467895078742654976",
        "etag": "5c8db178-ddd4-11ec-8a61-f78830620abb",
        "state": "REJECTED"
      }
    },
    {
      "orgId": "9467895078742654934",
      "id": "9467895078742654914",
      "createdDate": "2026-10-09T14:12:46.00Z",
      "type": "VALIDATION_FAILURE",
      "feedbackUrl": "/v1/orgs/9467895078742654934/feedback?ql=id==9467895078742654918",
      "resourceDetails": {
        "resourceType": "LOCATION",
        "resourceId": "9467895078742654918",
        "etag": "75b7339a-ddd4-11ec-8e49-af60e95b5e14",
        "state": "REJECTED"
      }
    },
    {
      "orgId": "9467895078742654934",
      "id": "9467895078742654913",
      "createdDate": "2026-10-09T15:02:16.00Z",
      "type": "VALIDATION_FAILURE",
      "feedbackUrl": "/v1/orgs/9467895078742654934/feedback?ql=id==9467895078742654999",
      "resourceDetails": {
        "resourceType": "IMAGE",
        "resourceId": "9467895078742654976",
        "etag": "4e895868-0dc5-11ed-861d-0242ac120002",
        "state": "REJECTED"
      }
    }
  ],
  "pagination": {
    "cursors": {
      "after": "2f54a61d9b495487"
    },
    "next": "/v1/orgs/9467895078742654934/notifications?limit=3&after=2f54a61d9b495487"
  }
}

The client follows pagination.next to retrieve the second page. The response contains the fourth, remaining notification resource and excludes pagination.cursors and pagination.next because no further pages of data exist.

Path (Second Page)

GET {url}/v1/orgs/9467895078742654934/notifications?limit=3&after=2f54a61d9b495487

Example Response Body (raw JSON, Second Page)

{
  "data": [
    {
      "orgId": "9467895078742654934",
      "id": "9467895078742654902",
      "createdDate": "2026-10-08T11:47:31.00Z",
      "type": "VALIDATION_FAILURE",
      "feedbackUrl": "/v1/orgs/9467895078742654934/feedback?ql=id==9467895078742654903",
      "resourceDetails": {
        "resourceType": "LOCATION",
        "resourceId": "9467895078742654903",
        "etag": "8a1c2f4e-ddd4-11ec-9f22-af60e95b5e14",
        "state": "REJECTED"
      }
    }
  ],
  "pagination": {}
}