### Products API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving product and currency conversion information.

```APIDOC
## GET /v1/public/currency-conversions

### Description
Get currency conversion values.

### Method
GET

### Endpoint
/v1/public/currency-conversions
```

```APIDOC
## GET /v1/public/product/{productId}

### Description
Gets details about a specified product.

### Method
GET

### Endpoint
/v1/public/product/{productId}

### Parameters
#### Path Parameters
- **productId** (string) - Required - The ID of the product.
```

```APIDOC
## GET /v1/public/products/fans-support

### Description
Gets all available products related to fan support.

### Method
GET

### Endpoint
/v1/public/products/fans-support
```

```APIDOC
## GET /v1/public/products

### Description
Lists active products based on the user's IP address.

### Method
GET

### Endpoint
/v1/public/products
```

--------------------------------

### Blog API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving blog posts.

```APIDOC
## GET /v1/public/blog/latest-posts

### Description
Finds links to the latest blog posts.

### Method
GET

### Endpoint
/v1/public/blog/latest-posts
```

--------------------------------

### Discount API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving discount information.

```APIDOC
## GET /v1/public/get-discount/

### Description
Get discount information.

### Method
GET

### Endpoint
/v1/public/get-discount/
```

--------------------------------

### Authentication API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for user authentication, registration, and password management.

```APIDOC
## POST /v1/authentication/login/apple

### Description
Creates and/or logs in a user from Apple to get a JWT.

### Method
POST

### Endpoint
/v1/authentication/login/apple
```

```APIDOC
## GET /v1/authentication/check-email

### Description
Checks if an email address is already in use.

### Method
GET

### Endpoint
/v1/authentication/check-email
```

```APIDOC
## POST /v1/authentication/login/facebook

### Description
Logs in or creates a user from Facebook.

### Method
POST

### Endpoint
/v1/authentication/login/facebook
```

```APIDOC
## POST /v1/authentication/login/google

### Description
Creates and/or logs in a user from Google to get a JWT.

### Method
POST

### Endpoint
/v1/authentication/login/google
```

```APIDOC
## POST /v1/authentication/login/admin

### Description
Logs in as a user to get a JWT.

### Method
POST

### Endpoint
/v1/authentication/login/admin
```

```APIDOC
## POST /v1/authentication/lost-password

### Description
Sends a reset password token to a user via email.

### Method
POST

### Endpoint
/v1/authentication/lost-password
```

```APIDOC
## POST /v1/authentication/login

### Description
Logs in a user to get a JWT.

### Method
POST

### Endpoint
/v1/authentication/login
```

```APIDOC
## POST /v1/authentication/change-password

### Description
Changes a user's password from a lost password email.

### Method
POST

### Endpoint
/v1/authentication/change-password
```

```APIDOC
## POST /v1/authentication/signup

### Description
Registers a new user.

### Method
POST

### Endpoint
/v1/authentication/signup
```

```APIDOC
## POST /v1/authentication/verify-change-email

### Description
Confirms and verifies the user's email change.

### Method
POST

### Endpoint
/v1/authentication/verify-change-email
```

```APIDOC
## POST /v1/authentication/verify

### Description
Activates a user from a token.

### Method
POST

### Endpoint
/v1/authentication/verify
```

--------------------------------

### Programs API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving information about programs, including subscriptions, listen counts, fan numbers, rankings, and details.

```APIDOC
## GET /v1/public/ivoox-awards/candidates

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/ivoox-awards/candidates

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/count-last-audios

### Description
Gets specified program active fans number

### Method
GET

### Endpoint
/v1/public/programs/{programId}/count-last-audios

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/stats/rankings

### Description
Gets program global and category rank

### Method
GET

### Endpoint
/v1/public/programs/{programId}/stats/rankings

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/stats/country-listens

### Description
Gets program global and category rank

### Method
GET

### Endpoint
/v1/public/programs/{programId}/stats/country-listens

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/fans

### Description
Gets specified program details

### Method
GET

### Endpoint
/v1/public/programs/{programId}/fans

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/par

### Description
Gets PAR programs for a specified program

### Method
GET

### Endpoint
/v1/public/programs/{programId}/par

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}

### Description
Gets specified program details

### Method
GET

### Endpoint
/v1/public/programs/{programId}

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/stats/country-stats

### Description
Gets program stats by country

### Method
GET

### Endpoint
/v1/public/programs/{programId}/stats/country-stats

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/stats/subscribers-and-listens

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/programs/{programId}/stats/subscribers-and-listens

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/user/{userId}

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/programs/user/{userId}

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/users/{userId}/programs

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/users/{userId}/programs

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/simple-list-by-ids

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/programs/simple-list-by-ids

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/{programId}/related

### Description
Gets PAR/Subcategory programs for a specified program

### Method
GET

### Endpoint
/v1/public/programs/{programId}/related

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/users/{userId}/top-programs

### Description
Gets program subs and listens number

### Method
GET

### Endpoint
/v1/public/users/{userId}/top-programs

### Parameters
#### Path Parameters
- **userId** (string) - Required - The ID of the user.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Miscellaneous Endpoints

Source: https://core.ivoox.com/v1/doc/index

A collection of various utility endpoints including program cancellation, audio retrieval, batch processing, gift cards, image generation, and test endpoints.

```APIDOC
## POST /v1/public/programs/cancel-aod

### Description
Sends a confirmation email to cancel a program.

### Method
POST

### Endpoint
/v1/public/programs/cancel-aod

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/audios/subcategory/{subcategoryId}/origin/{origin}

### Description
Get audios by subcategory and country.

### Method
GET

### Endpoint
/v1/public/audios/subcategory/{subcategoryId}/origin/{origin}

### Parameters
#### Path Parameters
- **subcategoryId** (string) - Required - The ID of the subcategory.
- **origin** (string) - Required - The origin country.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/audios/related

### Description
Get audios by subcategory and country.

### Method
GET

### Endpoint
/v1/public/audios/related

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## POST /v1/public/batch/request-user-data-callback

### Description
Manages BatchRequestUserData callback.

### Method
POST

### Endpoint
/v1/public/batch/request-user-data-callback

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/gift-cards

### Description
Gets Gift Card details.

### Method
GET

### Endpoint
/v1/public/gift-cards

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/gift-cards/pdf

### Description
Gets pdf gift card.

### Method
GET

### Endpoint
/v1/public/gift-cards/pdf

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## POST /v1/public/purchases/gift-cards/paypal

### Description
Handles PayPal purchase of gift cards.

### Method
POST

### Endpoint
/v1/public/purchases/gift-cards/paypal

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## POST /v1/public/purchases/gift-cards/stripe

### Description
Handles Stripe purchase of gift cards.

### Method
POST

### Endpoint
/v1/public/purchases/gift-cards/stripe

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/awards/{candidateId}/{type}.{extension}

### Description
Generates awards images.

### Method
GET

### Endpoint
/v1/public/images/awards/{candidateId}/{type}.{extension}

### Parameters
#### Path Parameters
- **candidateId** (string) - Required - The ID of the candidate.
- **type** (string) - Required - The type of image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/awards/winner/special-prize/{year}/{candidateId}/{type}.{extension}

### Description
Generates awards images for special prizes.

### Method
GET

### Endpoint
/v1/public/images/awards/winner/special-prize/{year}/{candidateId}/{type}.{extension}

### Parameters
#### Path Parameters
- **year** (string) - Required - The year.
- **candidateId** (string) - Required - The ID of the candidate.
- **type** (string) - Required - The type of image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/awards/winner/{year}/{candidateId}/{type}.{extension}

### Description
Generates awards images for winners.

### Method
GET

### Endpoint
/v1/public/images/awards/winner/{year}/{candidateId}/{type}.{extension}

### Parameters
#### Path Parameters
- **year** (string) - Required - The year.
- **candidateId** (string) - Required - The ID of the candidate.
- **type** (string) - Required - The type of image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/rewind-podcasters/2023/{hash}.{extension}

### Description
Generates rewind images for podcasters in 2023.

### Method
GET

### Endpoint
/v1/public/images/rewind-podcasters/2023/{hash}.{extension}

### Parameters
#### Path Parameters
- **hash** (string) - Required - The hash of the image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/rewind-podcasters/{year}/{hash}.{extension}

### Description
Generates rewind images for podcasters for a specified year.

### Method
GET

### Endpoint
/v1/public/images/rewind-podcasters/{year}/{hash}.{extension}

### Parameters
#### Path Parameters
- **year** (string) - Required - The year.
- **hash** (string) - Required - The hash of the image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/rewind/2023/{hash}.{extension}

### Description
Generates rewind images for 2023.

### Method
GET

### Endpoint
/v1/public/images/rewind/2023/{hash}.{extension}

### Parameters
#### Path Parameters
- **hash** (string) - Required - The hash of the image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/images/rewind/{year}/{hash}.{extension}

### Description
Generates rewind images for a specified year.

### Method
GET

### Endpoint
/v1/public/images/rewind/{year}/{hash}.{extension}

### Parameters
#### Path Parameters
- **year** (string) - Required - The year.
- **hash** (string) - Required - The hash of the image.
- **extension** (string) - Required - The file extension.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/test

### Description
Dummy test controller.

### Method
GET

### Endpoint
/v1/public/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## PUT /v1/public/test

### Description
Dummy test controller.

### Method
PUT

### Endpoint
/v1/public/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## POST /v1/public/test

### Description
Dummy test controller.

### Method
POST

### Endpoint
/v1/public/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## DELETE /v1/public/test

### Description
Dummy test controller.

### Method
DELETE

### Endpoint
/v1/public/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## PATCH /v1/public/test

### Description
Dummy test controller.

### Method
PATCH

### Endpoint
/v1/public/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/sessions/{session}

### Description
Gets session details.

### Method
GET

### Endpoint
/v1/public/sessions/{session}

### Parameters
#### Path Parameters
- **session** (string) - Required - The session identifier.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Posts API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for listing podcast posts.

```APIDOC
## GET /v1/public/programs/{programId}/posts

### Description
List podcast posts for a given program.

### Method
GET

### Endpoint
/v1/public/programs/{programId}/posts

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.
```

--------------------------------

### Audios API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving, downloading, and reporting audio content.

```APIDOC
## GET /v1/public/audios/{audioId}

### Description
Get Audio by audio_id.

### Method
GET

### Endpoint
/v1/public/audios/{audioId}

### Parameters
#### Path Parameters
- **audioId** (string) - Required - The ID of the audio to retrieve.
```

```APIDOC
## GET /v1/public/audios/{audioId}/download-url

### Description
Get Audio download URL by audio_id.

### Method
GET

### Endpoint
/v1/public/audios/{audioId}/download-url

### Parameters
#### Path Parameters
- **audioId** (string) - Required - The ID of the audio to get the download URL for.
```

```APIDOC
## GET /v1/public/audios/featured/{origin}

### Description
Get FeatureCountryAudio for a country.

### Method
GET

### Endpoint
/v1/public/audios/featured/{origin}

### Parameters
#### Path Parameters
- **origin** (string) - Required - The origin country code.
```

```APIDOC
## GET /v1/public/audios

### Description
Gets public audios.

### Method
GET

### Endpoint
/v1/public/audios
```

```APIDOC
## POST /v1/public/audios/{audioId}/report-by-allusions

### Description
Reports an audio by allusions.

### Method
POST

### Endpoint
/v1/public/audios/{audioId}/report-by-allusions

### Parameters
#### Path Parameters
- **audioId** (string) - Required - The ID of the audio to report.
```

```APIDOC
## GET /v1/public/audioFile/{audioFileId}/voxnestAd

### Description
Gets the media file of an audio for Voxnest ads.

### Method
GET

### Endpoint
/v1/public/audioFile/{audioFileId}/voxnestAd

### Parameters
#### Path Parameters
- **audioFileId** (string) - Required - The ID of the audio file.
```

--------------------------------

### SaleCampaign API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving information about active sale campaigns and their discounts.

```APIDOC
## GET /v1/public/sale-campaigns/discounts

### Description
Get the current enable sale campaigns for the given filters.

### Method
GET

### Endpoint
/v1/public/sale-campaigns/discounts

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/sale-campaign

### Description
Get the current enable sale campaigns for the given filters.

### Method
GET

### Endpoint
/v1/public/sale-campaign

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Sponsorship API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for managing program sponsorships.

```APIDOC
## POST /v1/public/advoices

### Description
Creates or updates a program sponsorship.

### Method
POST

### Endpoint
/v1/public/advoices
```

--------------------------------

### Spotify API

Source: https://core.ivoox.com/v1/doc/index

Endpoint for obtaining Spotify authorization URLs.

```APIDOC
## GET /v1/public/spotify/{spotifyShowURI}

### Description
Get Spotify authorization URL

### Method
GET

### Endpoint
/v1/public/spotify/{spotifyShowURI}

### Parameters
#### Path Parameters
- **spotifyShowURI** (string) - Required - The Spotify Show URI.

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### FeaturedAudio API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving featured audio content.

```APIDOC
## GET /v1/public/featured-audios

### Description
Gets featured category audios.

### Method
GET

### Endpoint
/v1/public/featured-audios
```

--------------------------------

### Categories API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving audio categories.

```APIDOC
## GET /v1/public/categories

### Description
Lists all available categories.

### Method
GET

### Endpoint
/v1/public/categories
```

```APIDOC
## GET /v1/public/itunes-categories

### Description
Gets all available iTunes audio categories.

### Method
GET

### Endpoint
/v1/public/itunes-categories
```

--------------------------------

### Lists API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for listing items based on filters.

```APIDOC
## GET /v1/public/lists

### Description
List items based on filters passed by parameters.

### Method
GET

### Endpoint
/v1/public/lists
```

--------------------------------

### Links API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for finding links.

```APIDOC
## GET /v1/public/links

### Description
Find links.

### Method
GET

### Endpoint
/v1/public/links
```

--------------------------------

### Campaigns API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving campaign details.

```APIDOC
## GET /v1/public/campaigns/{campaignId}

### Description
Get details about a specified campaign.

### Method
GET

### Endpoint
/v1/public/campaigns/{campaignId}

### Parameters
#### Path Parameters
- **campaignId** (string) - Required - The ID of the campaign.
```

```APIDOC
## GET /v1/public/testEsi/child/{order}

### Description
Get details about a specified campaign (likely related to ESI testing).

### Method
GET

### Endpoint
/v1/public/testEsi/child/{order}

### Parameters
#### Path Parameters
- **order** (string) - Required - The order parameter for the test.
```

--------------------------------

### PARCollectionShowRoom API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving PARCollectionShowRoom data.

```APIDOC
## GET /v1/public/par-collection/{parCollectionId}/showroom

### Description
Get PARCollectionShowRoom by ParCollectionId.

### Method
GET

### Endpoint
/v1/public/par-collection/{parCollectionId}/showroom

### Parameters
#### Path Parameters
- **parCollectionId** (string) - Required - The ID of the PAR collection.
```

--------------------------------

### FeaturedCountryAudio API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving featured audio content based on country.

```APIDOC
## GET /v1/public/featured-country-audio

### Description
Get featured country audio.

### Method
GET

### Endpoint
/v1/public/featured-country-audio
```

```APIDOC
## GET /v1/public/featured-programs/origin/{originIso}

### Description
Get featured programs with their last active audios based on origin country.

### Method
GET

### Endpoint
/v1/public/featured-programs/origin/{originIso}

### Parameters
#### Path Parameters
- **originIso** (string) - Required - The ISO code of the origin country.
```

--------------------------------

### Purchases API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for handling purchase confirmations and denials, specifically for PayPal.

```APIDOC
## POST /v1/public/purchases/paypal/confirmed

### Description
Handles PayPal purchase confirmation.

### Method
POST

### Endpoint
/v1/public/purchases/paypal/confirmed

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## POST /v1/public/purchases/paypal/denied

### Description
Makes a purchase and handles PayPal denial.

### Method
POST

### Endpoint
/v1/public/purchases/paypal/denied

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Sections API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving details about specified campaigns and user-liked sections.

```APIDOC
## GET /v1/public/edge/sections/user-liked

### Description
Get details about specified campaign.

### Method
GET

### Endpoint
/v1/public/edge/sections/user-liked

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/sections/user-liked

### Description
Get details about specified campaign.

### Method
GET

### Endpoint
/v1/public/sections/user-liked

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/edge/test

### Description
Get details about specified campaign.

### Method
GET

### Endpoint
/v1/public/edge/test

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Suggestion API

Source: https://core.ivoox.com/v1/doc/index

Endpoint for finding links related to suggestions.

```APIDOC
## GET /v1/public/suggestions

### Description
Find links for suggestions.

### Method
GET

### Endpoint
/v1/public/suggestions

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### AwardCandidate API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for managing award candidates.

```APIDOC
## POST /v1/public/award-candidate

### Description
Creates an award candidate.

### Method
POST

### Endpoint
/v1/public/award-candidate
```

```APIDOC
## GET /v1/public/ivoox-awards/candidate/{candidateId}

### Description
Gets an AwardCandidate by its ID.

### Method
GET

### Endpoint
/v1/public/ivoox-awards/candidate/{candidateId}

### Parameters
#### Path Parameters
- **candidateId** (string) - Required - The ID of the award candidate.
```

```APIDOC
## GET /v1/public/ivoox-awards/candidate/program/{programId}

### Description
Gets AwardCandidate by its foreign key program ID.

### Method
GET

### Endpoint
/v1/public/ivoox-awards/candidate/program/{programId}

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.
```

--------------------------------

### Comments API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for creating, retrieving, and replying to comments.

```APIDOC
## POST /v1/public/comments

### Description
Creates a comment.

### Method
POST

### Endpoint
/v1/public/comments
```

```APIDOC
## GET /v1/public/audios/{audioId}/comments

### Description
Gets comments related to a specified audio.

### Method
GET

### Endpoint
/v1/public/audios/{audioId}/comments

### Parameters
#### Path Parameters
- **audioId** (string) - Required - The ID of the audio.
```

```APIDOC
## GET /v1/public/comments/{commentId}/replies

### Description
Gets replies related to a specified comment.

### Method
GET

### Endpoint
/v1/public/comments/{commentId}/replies

### Parameters
#### Path Parameters
- **commentId** (string) - Required - The ID of the comment.
```

```APIDOC
## GET /v1/public/posts/{postId}/comments

### Description
Gets comments related to a specified post.

### Method
GET

### Endpoint
/v1/public/posts/{postId}/comments

### Parameters
#### Path Parameters
- **postId** (string) - Required - The ID of the post.
```

```APIDOC
## POST /v1/public/comments/{commentId}/reply

### Description
Replies to a comment.

### Method
POST

### Endpoint
/v1/public/comments/{commentId}/reply

### Parameters
#### Path Parameters
- **commentId** (string) - Required - The ID of the comment to reply to.
```

--------------------------------

### Subcategories API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving tags related to audio subcategories.

```APIDOC
## GET /v1/public/subcategories/{subcategoryId}/tags

### Description
Gets all tags related to a specified audio subcategory.

### Method
GET

### Endpoint
/v1/public/subcategories/{subcategoryId}/tags

### Parameters
#### Path Parameters
- **subcategoryId** (string) - Required - The ID of the subcategory.
```

--------------------------------

### Genders API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving audio genders.

```APIDOC
## GET /v1/public/genders

### Description
Gets all available audio genders.

### Method
GET

### Endpoint
/v1/public/genders
```

--------------------------------

### Languages API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving available languages.

```APIDOC
## GET /v1/public/languages

### Description
Gets all available languages.

### Method
GET

### Endpoint
/v1/public/languages
```

--------------------------------

### Purchase API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for processing purchases using various payment methods.

```APIDOC
## POST /v1/public/purchases/fans/paypal

### Description
Makes a purchase using PayPal.

### Method
POST

### Endpoint
/v1/public/purchases/fans/paypal
```

```APIDOC
## POST /v1/public/purchases/fans/stripe-elements

### Description
Makes a purchase using Stripe Elements.

### Method
POST

### Endpoint
/v1/public/purchases/fans/stripe-elements
```

```APIDOC
## POST /v1/public/purchases/fans/stripe-checkout

### Description
Makes a purchase using Stripe Checkout.

### Method
POST

### Endpoint
/v1/public/purchases/fans/stripe-checkout
```

```APIDOC
## GET /v1/public/purchase/get-public-key/{method}

### Description
Gets credentials about database stored external services for a given payment method.

### Method
GET

### Endpoint
/v1/public/purchase/get-public-key/{method}

### Parameters
#### Path Parameters
- **method** (string) - Required - The payment method (e.g., 'paypal', 'stripe').
```

--------------------------------

### Origins API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving available countries (origins).

```APIDOC
## GET /v1/public/origins

### Description
Gets all available countries.

### Method
GET

### Endpoint
/v1/public/origins
```

--------------------------------

### Stats API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving statistics data.

```APIDOC
## GET /v1/public/advoices/audios/{audioId}/iab-listens

### Description
Gets stats data for a given audio.

### Method
GET

### Endpoint
/v1/public/advoices/audios/{audioId}/iab-listens

### Parameters
#### Path Parameters
- **audioId** (string) - Required - The ID of the audio to get stats for.
```

--------------------------------

### Radios API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for retrieving radio-related information, including top links and program rankings.

```APIDOC
## GET /v1/public/radios/top

### Description
Find links for top radios.

### Method
GET

### Endpoint
/v1/public/radios/top

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

```APIDOC
## GET /v1/public/programs/ranking

### Description
Find links for program rankings.

### Method
GET

### Endpoint
/v1/public/programs/ranking

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

--------------------------------

### Feeds API

Source: https://core.ivoox.com/v1/doc/index

Endpoints for managing and validating feeds.

```APIDOC
## GET /v1/public/soa/{programId}/{jwt}

### Description
Returns the Spotify Ingestion Feed based on programId and JWT.

### Method
GET

### Endpoint
/v1/public/soa/{programId}/{jwt}

### Parameters
#### Path Parameters
- **programId** (string) - Required - The ID of the program.
- **jwt** (string) - Required - The JSON Web Token for authentication.
```

```APIDOC
## POST /v1/public/feeds/validate

### Description
Checks whether a specified URL is addressing a valid feed.

### Method
POST

### Endpoint
/v1/public/feeds/validate
```

--------------------------------

### AdVoices API

Source: https://core.ivoox.com/v1/doc/index

Endpoints related to AdVoices and user social accounts.

```APIDOC
## GET /v1/public/user/social-account-user-id

### Description
Gets the user ID associated with a social login (AdVoices link social account).

### Method
GET

### Endpoint
/v1/public/user/social-account-user-id
```

--------------------------------

### Health Check API

Source: https://core.ivoox.com/v1/doc/index

Endpoint for checking the service status.

```APIDOC
## GET /v1/public/health-check

### Description
Health check endpoint to verify service status.

### Method
GET

### Endpoint
/v1/public/health-check
```

--------------------------------

### FacebookDeletionCallback API

Source: https://core.ivoox.com/v1/doc/index

Endpoint for handling Facebook deletion requests.

```APIDOC
## POST /v1/public/facebook/deletion-request

### Description
Get and handle Facebook deletion Request.

### Method
POST

### Endpoint
/v1/public/facebook/deletion-request

### Parameters

### Request Example

### Response
#### Success Response (200)

#### Response Example

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.