---
title: "Get all remix contests"
method: GET
path: "/events/remix-contests"
tags: ["events"]
---

# Get all remix contests

`GET /events/remix-contests`

Get remix contest events ordered with currently-active contests first (by soonest-ending), followed by ended contests (most-recently-ended first). Active contests are those whose end_date is null or in the future.

## Query parameters

- `offset` integer
- `limit` integer
- `status` 'active' | 'ended' | 'all'
- `user_id` string

## Response `200`

Success

- RemixContestsResponse
  - `data` Event[]
    - `event_id` string, required
    - `event_type` 'remix_contest' | 'live_event' | 'new_release', required
    - `user_id` string, required
    - `entity_type` 'track' | 'collection' | 'user'
    - `entity_id` string
    - `end_date` string
    - `is_deleted` boolean
    - `created_at` string, required
    - `updated_at` string, required
    - `event_data` object, required
    - `permalink` string — Canonical contest permalink derived from event_routes.
  - `related` RemixContestsRelated
    - `users` User[]
      - `album_count` integer, required
      - `artist_pick_track_id` string
      - `artist_coin_badge` object, required
        - `mint` string
        - `logo_uri` string
        - `banner_image_url` string
        - `ticker` string — The coin symbol/ticker
      - `coin_flair_mint` string
      - `bio` string
      - `cover_photo` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `followee_count` integer, required
      - `follower_count` integer, required
      - `handle` string, required
      - `id` string, required
      - `is_verified` boolean, required
      - `twitter_handle` string
      - `instagram_handle` string
      - `tiktok_handle` string
      - `verified_with_twitter` boolean, required
      - `verified_with_instagram` boolean, required
      - `verified_with_tiktok` boolean, required
      - `website` string
      - `donation` string
      - `location` string
      - `name` string, required
      - `playlist_count` integer, required
      - `profile_picture` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `repost_count` integer, required
      - `track_count` integer, required
      - `is_deactivated` boolean, required
      - `is_available` boolean, required
      - `erc_wallet` string, required
      - `spl_wallet` string, required
      - `spl_usdc_wallet` string, required
      - `spl_usdc_payout_wallet` string
      - `supporter_count` integer, required
      - `supporting_count` integer, required
      - `total_audio_balance` integer, required
      - `wallet` string, required — The user's Ethereum wallet address for their account
      - `balance` string, required
      - `associated_wallets_balance` string, required
      - `total_balance` string, required
      - `waudio_balance` string, required
      - `associated_sol_wallets_balance` string, required
      - `blocknumber` integer, required
      - `created_at` string, required
      - `is_storage_v2` boolean, required
      - `creator_node_endpoint` string
      - `current_user_followee_follow_count` integer, required
      - `does_current_user_follow` boolean, required
      - `does_current_user_subscribe` boolean, required
      - `does_follow_current_user` boolean, required
      - `handle_lc` string, required
      - `updated_at` string, required
      - `cover_photo_sizes` string
      - `cover_photo_cids` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `cover_photo_legacy` string
      - `profile_picture_sizes` string
      - `profile_picture_cids` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `profile_picture_legacy` string
      - `has_collectibles` boolean, required
      - `playlist_library` PlaylistLibrary
        - `contents` object[]
      - `allow_ai_attribution` boolean, required
      - `profile_type` string
    - `tracks` Track[]
      - `artwork` TrackArtwork, required
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `description` string
      - `genre` string, required
      - `id` string, required
      - `track_cid` string
      - `preview_cid` string
      - `orig_file_cid` string
      - `orig_filename` string
      - `is_original_available` boolean, required
      - `mood` string
      - `release_date` string, date
      - `remix_of` RemixParent, required
        - `tracks` Remix[]
          - `parent_track_id` string, required
          - `user` User, required
            - `album_count` integer, required
            - `artist_pick_track_id` string
            - `artist_coin_badge` object, required
              - …
            - `coin_flair_mint` string
            - `bio` string
            - `cover_photo` CoverPhoto
              - …
            - `followee_count` integer, required
            - `follower_count` integer, required
            - `handle` string, required
            - `id` string, required
            - `is_verified` boolean, required
            - `twitter_handle` string
            - `instagram_handle` string
            - `tiktok_handle` string
            - `verified_with_twitter` boolean, required
            - `verified_with_instagram` boolean, required
            - `verified_with_tiktok` boolean, required
            - `website` string
            - `donation` string
            - `location` string
            - `name` string, required
            - `playlist_count` integer, required
            - `profile_picture` ProfilePicture
              - …
            - `repost_count` integer, required
            - `track_count` integer, required
            - `is_deactivated` boolean, required
            - `is_available` boolean, required
            - `erc_wallet` string, required
            - `spl_wallet` string, required
            - `spl_usdc_wallet` string, required
            - `spl_usdc_payout_wallet` string
            - `supporter_count` integer, required
            - `supporting_count` integer, required
            - `total_audio_balance` integer, required
            - `wallet` string, required — The user's Ethereum wallet address for their account
            - `balance` string, required
            - `associated_wallets_balance` string, required
            - `total_balance` string, required
            - `waudio_balance` string, required
            - `associated_sol_wallets_balance` string, required
            - `blocknumber` integer, required
            - `created_at` string, required
            - `is_storage_v2` boolean, required
            - `creator_node_endpoint` string
            - `current_user_followee_follow_count` integer, required
            - `does_current_user_follow` boolean, required
            - `does_current_user_subscribe` boolean, required
            - `does_follow_current_user` boolean, required
            - `handle_lc` string, required
            - `updated_at` string, required
            - `cover_photo_sizes` string
            - `cover_photo_cids` CoverPhoto
              - …
            - `cover_photo_legacy` string
            - `profile_picture_sizes` string
            - `profile_picture_cids` ProfilePicture
              - …
            - `profile_picture_legacy` string
            - `has_collectibles` boolean, required
            - `playlist_library` PlaylistLibrary
              - …
            - `allow_ai_attribution` boolean, required
            - `profile_type` string
          - `has_remix_author_reposted` boolean, required
          - `has_remix_author_saved` boolean, required
      - `repost_count` integer, required
      - `favorite_count` integer, required
      - `comment_count` integer, required
      - `tags` string
      - `title` string, required
      - `user` User, required
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `collaborators` User[] — Accepted collaborator artists on the track.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `pending_collaborators` User[] — Pending collaborator invites; only present on the owner's own tracks.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `duration` integer, required
      - `is_downloadable` boolean, required
      - `play_count` integer, required
      - `permalink` string, required
      - `is_streamable` boolean
      - `ddex_app` string
      - `playlists_containing_track` integer[]
      - `pinned_comment_id` integer
      - `album_backlink` AlbumBacklink
        - `playlist_id` integer, required
        - `playlist_name` string, required
        - `permalink` string, required
      - `access` Access, required
        - `stream` boolean, required
        - `download` boolean, required
      - `blocknumber` integer, required — The blocknumber this track was last updated
      - `create_date` string
      - `cover_art_sizes` string, required
      - `cover_art_cids` CoverArt
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `created_at` string, required
      - `credits_splits` string
      - `isrc` string
      - `license` string
      - `iswc` string
      - `field_visibility` FieldVisibility, required
        - `mood` boolean, required
        - `tags` boolean, required
        - `genre` boolean, required
        - `share` boolean, required
        - `play_count` boolean, required
        - `remixes` boolean, required
      - `followee_reposts` Repost[], required
        - `repost_item_id` string, required
        - `repost_type` string, required
        - `user_id` string, required
      - `has_current_user_reposted` boolean, required
      - `is_scheduled_release` boolean, required
      - `is_unlisted` boolean, required
      - `has_current_user_saved` boolean, required
      - `followee_favorites` Favorite[], required
        - `favorite_item_id` string, required
        - `favorite_type` string, required
        - `user_id` string, required
        - `created_at` string, required
      - `route_id` string, required
      - `stem_of` StemParent
        - `category` string, required
        - `parent_track_id` integer, required
      - `track_segments` TrackSegment[], required
        - `duration` number, required
        - `multihash` string, required
      - `updated_at` string, required
      - `user_id` string, required
      - `is_delete` boolean, required
      - `cover_art` string
      - `is_available` boolean, required
      - `ai_attribution_user_id` integer
      - `allowed_api_keys` string[]
      - `audio_upload_id` string
      - `preview_start_seconds` number
      - `bpm` number
      - `is_custom_bpm` boolean
      - `musical_key` string
      - `is_custom_musical_key` boolean
      - `audio_analysis_error_count` integer
      - `comments_disabled` boolean
      - `ddex_release_ids` object
      - `artists` object[]
      - `resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `indirect_resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `rights_controller` DdexRightsController — DDEX rights controller
        - `name` string, required
        - `roles` string[], required
        - `rights_share_unknown` string — Optional
      - `copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `producer_copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `parental_warning_type` string, nullable
      - `is_stream_gated` boolean, required — Whether or not the owner has restricted streaming behind an access gate
      - `access_authorities` string[], nullable — Wallet addresses that can sign to authorize stream access (programmable distribution). When empty or omitted, the track is public and validator/creator nodes can serve it.
      - `stream_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `is_download_gated` boolean, required — Whether or not the owner has restricted downloading behind an access gate
      - `download_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `cover_original_song_title` string
      - `cover_original_artist` string
      - `is_owned_by_user` boolean, required — Indicates whether the track is owned by the user for MRI sake
      - `stream` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `download` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `preview` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
    - `entry_counts` object — Per-contest entry counts keyed by the contest's parent track id (hashid). Lets the discovery UI render entry counts without issuing an extra `/tracks/{id}/remixes?limit=0` per card.

## Other responses

- `400` — Bad request
- `500` — Server error

---

[API](https://skmtc.dev/audius/apis/audius-api.md) · [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/audius/audius-api/revisions/940230b2ed3d/schema)