List accessible instances

​

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

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

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

    Maximum number of items to return per page. Choose any value on the first request, then keep it unchanged on every subsequent request that passes a nextCursor from this endpoint. To change the page size, start a new walk by omitting nextCursor.

  • nextCursor
    Type: string | null

    Opaque cursor returned by the previous page. Omit on the first request. Cursors are tied to the query parameters of the request that produced them; to paginate, keep every parameter identical across requests and only vary nextCursor. To change filters, sort, or limit, start a new walk by omitting nextCursor.

Responses
  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for get/v2/instances
curl 'https://reporting.api.later.com/v2/instances?limit=50&nextCursor=null' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "instanceIds": [
      "instance_abc",
      "instance_def"
    ]
  },
  "nextCursor": "eyJ2ZXJzaW9uIjoxfQ"
}

List of instance IDs accessible by the API credentials