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

# List destinations

`GET /destinations`

## Request

- Base URL: `https://api.deploy.social/v1`
- URL: `https://api.deploy.social/v1/destinations`
- Auth: HTTP bearer

The social accounts connected to your workspace. Only `active` ones can be posted to; the others need reconnecting in Deploy first.

## Response `200`

Your destinations.

- DestinationList
  - `data` Destination[], required
    - `id` string, required: The destination's id. Starts with `dest_`.
    - `platform` string, required
    - `handle` string, required
    - `display_name` string, nullable, required
    - `avatar_url` string, nullable, required
    - `status` string, required: `active` can be posted to. `reconnect_required` needs someone to reconnect it in Deploy first. `disconnected` was disconnected in Deploy. New values may be added.
    - `status_reason` string, nullable, required: Why it isn't `active`, when it isn't.
    - `media_limits` MediaLimits, required: What a video has to fit to post here.
      - `max_duration_sec` number, required
      - `min_duration_sec` number, nullable, required: The shortest video accepted, in seconds. `null` means no minimum.
      - `max_file_size_mb` number, required
      - `aspect_ratios` string[], required: The shapes that look best here.
      - `aspect_range` object, nullable, required: Width divided by height must fall in this range. `null` means any shape is accepted.
        - `min` number, required
        - `max` number, required
      - `requires_portrait` boolean, required: Only vertical video is accepted.
      - `min_resolution` object, nullable, required: The smallest frame accepted: width and height must both reach these. `null` means no minimum.
        - `width` number, required
        - `height` number, required
      - `containers` string[], required

## Other responses

- `401`: The API key is missing, wrong, revoked or expired: `missing_api_key`, `invalid_api_key`, `api_key_revoked`, `api_key_expired`.
- `403`: The key can't do this: `insufficient_scope` (a read-only key), `plan_required`, `usage_limit_exceeded` (this month's videos are used up), `access_revoked` (its creator left the workspace), `workspace_archived`.
- `429`: Slow down and wait `Retry-After` seconds. Either this key has used its requests for the minute (Standard: 60 reads and 20 writes, Studio: 120 and 30), or, when publishing or scheduling, the plan's API posts for the day are used (detail code `daily_post_limit`; Standard: 30 a day across your account, Studio: 100 a day per workspace; `Retry-After` runs to midnight UTC). Posts made in the app never count.
- `500`: Something broke on our side. Retry, and contact us with the request id if it keeps happening.
- `503`: We can't take the request right now. Retry shortly.

---

[API](https://skmtc.dev/deploy/apis/deploy-social-api.md) · [All operations](https://skmtc.dev/deploy/apis/deploy-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deploy/apis/deploy-social-api/revisions/7ed97bdd207f?raw)