List accessible instances

​

Returns the paginated list of instance IDs accessible by your API credentials.

Use this endpoint to discover which instances are available before querying performance data.

Pagination

Results are paginated. Use pageSize (default: 50, max: 100) and pageNumber (1-indexed) to navigate pages. The response includes a pagination object with page, pageSize, totalPages, and totalItems.

Query Parameters
  • pageSize
    Type: number
    min:  
    1
    max:  
    100

    Number of items per page.

  • pageNumber
    Type: number
    min:  
    1
    max:  
    500

    Page number (1-indexed).

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/v2/instances
curl 'https://reporting.api.later.com/v2/instances?pageSize=50&pageNumber=1' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "instanceIds": [
      "instance_abc",
      "instance_def"
    ]
  },
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "totalItems": 2,
    "totalPages": 1
  }
}

List of instance IDs accessible by the API credentials