---
title: "List of destinations"
method: GET
path: "/api/v3/destinations"
tags: ["Destinations"]
---

# List of destinations

`GET /api/v3/destinations`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/destinations`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `dts_session_id`
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/destinations/get.ts> (a function with typed inputs; its response is checked against the schema)

List destinations with short info. Paginated response is ordered by the name field.

## Response `200`

Get a list of Destinations

- PaginatedDestinationList[]
  - `count` integer: Number of destinations
  - `next` string: URL to the next page
  - `previous` string: URL to the previous page
  - `results` Destination[]
    - `name` string: string identifier of destination
    - `title` string: Destination title
    - `info` string: Destination info
    - `icons` object
      - `res_300x200` string: URL to the 300x200 icon
      - `res_40x40` string: URL to the 40x40 icon
      - `res_20x20` string: URL to the 20x20 icon

## Other responses

- `401`: Forbidden

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)