---
title: "List Shares"
method: GET
path: "/v1/accounts/{{account_id}}/videos/{{video_id}}/shares"
tags: ["Media Sharing"]
---

# List Shares

`GET /v1/accounts/{{account_id}}/videos/{{video_id}}/shares`

Lists the existing shares for an account - this is a Master account operation - do this before sharing to insure that you are not re-sharing to an affiliate, which would overwrite any affiliate metadata changes

## Path parameters

- `account_id` string, required
- `video_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Response `200`

200

- VideoShare[]
  - `affiliate_id` string, required — the id of the affiliate account the video is shared to
  - `affiliate_video_id` string, required — the id of the shared video in the affiliate account
  - `shared_at` string — when the video was shared
  - `status` string — the status of the sharing - either PROCESSING, COMPLETE, or FAILED
  - `updated_at` string — the video was last updated in the affiliate account
  - `video_id` string, required — the video id

## Other responses

- `401` — UNAUTHORIZED: Authentication failed; check to make sure your client credentials were correct for the access token
- `403` — NOT_AVAILABLE: The resource you are requesting is unavailable - this may be a temporary condition while some kind of processing of the video is in progress, but if the message persists, contact
- `404` — RESOURCE_NOT_FOUND: Resource not found
- `429` — TOO_MANY_REQUESTS: You are submitting too many simultaneous requests or too many requests per second
- `500` — UNKNOWN: Issue in Brightcove system; try again later. TIMEOUT: Server likely too busy; try again later.

---

[API](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference.md) · [All operations](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightcovelearning/brightcove-cms-api-reference/revisions/1b6182a4560a/schema)