# Use Cases
source: https://developer.mastercard.com/bces-service/documentation/usecases/index.md

The Benefits Content Eligibility Service API enables vendors or users to retrieve the rich content (description, FAQ, images, etc.) for eligible bundles and benefits using various input parameters.

## Benefits Use Cases {#benefits-use-cases}

You will find sequence diagrams below that outlines an issuer and a vendor would use `benefits/contents/searches`.

### Vendor {#vendor}


Diagram usecase1

<br />

### Issuer {#issuer}

Diagram usecase2

### Use Case 1: Retrieve content for benefits that are active as of today {#use-case-1-retrieve-content-for-benefits-that-are-active-as-of-today}

1. Vendor sends a request with a card number as an input parameter.
2. Benefits Content Eligibility Service API returns the benefits that are active or effective as of the current date including Images, Short Description, Long Description, T\&Cs link and Privacy link.

### Use Case 2: Retrieve content for benefits that are active as of specific date {#use-case-2-retrieve-content-for-benefits-that-are-active-as-of-specific-date}

1. Vendor sends a request with a card number and a past date as input parameters.
2. Benefits Content Eligibility Service API returns the benefits that are active or effective as of the given date including Images, Short Description, Long Description, T\&Cs link and Privacy link.

### Use Case 3: Retrieve Content for benefits that are specific to a benefit {#use-case-3-retrieve-content-for-benefits-that-are-specific-to-a-benefit}

1. Vendor sends a request with a card number and a benefit code as input parameters.
2. Benefits Content Eligibility Service API returns the content specific to the input benefit code including Images, Short Description, Long Description, T\&Cs link and Privacy link.

### Use Case 4: Retrieve content for benefits that are specific to a product {#use-case-4-retrieve-content-for-benefits-that-are-specific-to-a-product}

1. Vendor sends a request with a card number and product code as input parameters.
2. Benefits Content Eligibility Service API returns the benefits that are active/effective as of the current date and are associated to the product code including Images, Short Description, Long Description, T\&Cs link and Privacy link.

### Use Case 5: Retrieve content for benefits that are specific to a locale {#use-case-5-retrieve-content-for-benefits-that-are-specific-to-a-locale}

1. Vendor sends a request with a card number and a locale as input parameters.
2. Benefits Content Eligibility Service API returns the benefits that are active/effective as of the current date and associated to that specific language including Images, Short Description, Long Description, T\&Cs link and Privacy link.