# Use Cases
source: https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/index.md

👉 Replace the generic resource labels below with the actual business entities used by your service. Update the eyebrow labels and icon choices in the table so they match your lifecycle categories, and point the end-to-end Mermaid diagram at the right flow file in `data/mermaid/`. Keep the overall lifecycle sequence and the diagram-driven page structure.

The {Your Service Name} API offers endpoints categorized into primary resources, secondary resources, downstream transactions, and administrative records. It supports search and filtering, record retrieval, secure handling of sensitive fields, and full CRUD operations across the main service workflows.

Built with enterprise-grade architecture, these core functionalities deliver precise data tracking and streamlined information management, establishing a reliable foundation for scalable operations and business process automation.

Use these pages as a guided sequence through the typical record lifecycle: create data first, retrieve or query it next, update it when needed, and delete it when the record is no longer required. Each use case explains who performs the action, the order of the interaction, and why that endpoint is used.

## {Your Service Name} API Requests {#your-service-name-api-requests}

Facilitates five types of requests:

|       Use Case       |                                                                                                                                                                 Description                                                                                                                                                                 |
|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Create new records   | `Creation` capabilities ensure that you can create new service objects. Create a new primary record, secondary record, downstream transaction, or administrative record. [Add new records](https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/add-new-database-records/index.md)                            |
| Retrieve information | `Retrieving` capabilities ensure that you can receive the most up-to-date resource and transaction information. Retrieve information about an existing resource or supporting record. [Retrieve information](https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/retrieve-new-database-information/index.md) |
| Query information    | `Querying` capabilities allow you to filter and search for specific records. Search for current resources, historical transactions, or administrative records. [Query information](https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/querying-database-information/index.md)                               |
| Update information   | `Updating` capabilities ensure that you can immediately correct or refresh outdated service information. Update information about a resource, status, transaction, or administrative record. [Update information](https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/update-database-information/index.md)  |
| Delete information   | `Deletion` capabilities ensure that you can permanently remove obsolete records. Delete information about a resource, transaction, or administrative record. [Delete information](https://developer.mastercard.com/agent-suite-for-merchants/documentation/use-cases/delete-database-information/index.md)                                  |

## End-to-End Service Flow {#end-to-end-service-flow}

Diagram institution

The end-to-end journey generally follows this order: `Add New Records` -\> `Retrieve Information` -\> `Query Information` -\> `Update Information` -\> `Delete Information`.

## Error Handling {#error-handling}

To see information about possible errors that can be returned from the service, please explore our [Code and Formats](https://developer.mastercard.com/agent-suite-for-merchants/documentation/code-and-formats/index.md) page.

## Next Steps {#next-steps}

Now that you have an understanding of the different use cases the service uses, proceed to the [API Reference](https://developer.mastercard.com/agent-suite-for-merchants/documentation/api-reference/index.md) section to interact with all of our endpoints on the API explorer.