---
title: "List sound effects licenses"
method: GET
path: "/v2/sfx/licenses"
tags: ["sound_effects"]
---

# List sound effects licenses

`GET /v2/sfx/licenses`

This endpoint lists existing licenses.

## Query parameters

- `sfx_id` string
- `license` string
- `page` integer
- `per_page` integer
- `sort` 'newest' | 'oldest'
- `username` string
- `start_date` string, date-time
- `end_date` string, date-time
- `license_id` string
- `download_availability` 'all' | 'downloadable' | 'non_downloadable'
- `team_history` boolean

## Response `200`

OK

- object — List of download events
  - `data` object[] — Download events
    - `audio` object — Information about the downloaded media
      - `format` object — Information about the format of a download
        - `format` string — The format of the downloaded media
        - `size` string — The size of the downloaded media
      - `id` string, required — ID of the download history media details
    - `download_time` string, date-time, required — Date the media was downloaded the first time
    - `id` string, required — ID of the download
    - `image` object — Information about the downloaded media
      - `format` object — Information about the format of a download
        - `format` string — The format of the downloaded media
        - `size` string — The size of the downloaded media
      - `id` string, required — ID of the download history media details
    - `is_downloadable` boolean — Specifies if the media is downloadable via its respective downloads endpoint
    - `license` string, required — The name of the license of this download
    - `metadata` object — The metadata that was passed in the original licensing request
    - `subscription_id` string — ID of the subscription used to perform this download
    - `user` object — Information about a user
      - `username` string, required — The name of the user who downloaded the item
    - `video` object — Information about the downloaded media
      - `format` object — Information about the format of a download
        - `format` string — The format of the downloaded media
        - `size` string — The size of the downloaded media
      - `id` string, required — ID of the download history media details
    - `revshare` object — Pricing information for revenue-sharing transactions
      - `purchase_amount` string, required — The amount charged for the license
      - `purchase_currency` string, required — The currency the amount was charged in
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Server-generated message, if any
  - `page` integer — The current page of results
  - `per_page` integer — The number of results per page
  - `total_count` integer — The total number of results across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)