---
title: "List accessible instances"
method: GET
path: "/v2/instances"
tags: ["Instance Level"]
---

# List accessible instances

`GET /v2/instances`

## Request

- Base URL: `https://reporting.api.later.com`
- URL: `https://reporting.api.later.com/v2/instances`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/later/apis/later-influence-reporting-api/docs/v2/instances/get.ts> (a function with typed inputs; its response is checked against the schema)

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` number
- `nextCursor` string, nullable

## Response `200`

List of instance IDs accessible by the API credentials

- object
  - `data` InstancesListResponseDto, required
    - `instanceIds` string[], required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: One or more query parameters failed validation (`ANL_00400`)
- `401`: Authentication failed — the JWT is missing, malformed, invalid, or expired (`ANL_00401`). Request a new token via `POST /oauth/token` before retrying.
- `403`: Authorization failed — the JWT is valid but the requested scope is not accessible with this token (`ANL_00403`). Typically one or more `instanceIds` are not bound to the client.
- `500`: An unexpected error occurred while processing the request (`ANL_00500`). The request was not processed and the credentials are not implicated — retry with exponential backoff.

---

[API](https://skmtc.dev/later/apis/later-influence-reporting-api.md) - [All operations](https://skmtc.dev/later/apis/later-influence-reporting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/later/apis/later-influence-reporting-api/revisions/690357ea985d?raw)