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

👉 Use this page to outline the entire end to end user journey. It is important that you document the distinct sequence of calls that your service uses. A customer must be able to understand the flow of data from one call to the next. In other words, what information from a response is then used in a sequential request, and so on. Create a paragraph (or bullet points) here that outlines this and a table that shows all the use cases. You must use a singular mermaidJS diagram to add a visual diagram of this below as well, do not use your own imagery. For documentation about how to use mermaidJS within JAMStack see [the diagram shortcode documentation](https://stage.developer.mastercard.com/jamstack/documentation/theme/shortcodes/diagram/).

The {Pet Store API} offers endpoints categorized into Dogs, Cats, Pets, Adoptions, and Employees. This robust system enables advanced pet management operations including status-based pet searches, adoption record retrieval, secure employee authentication via Social Security Number (SSN) lookup, and full CRUD operations for both pet and employee records.

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

## {Pet Store} API Requests {#pet-store-api-requests}

👉 Use the [Eyebrow Shortcodes](https://stage.developer.mastercard.com/jamstack/documentation/theme/shortcodes/eyebrow/) and [Table Shortcodes](https://stage.developer.mastercard.com/jamstack/documentation/theme/markdown-guide/syntax/#tables) here.   

Facilitates five types of requests:

|       Use Case       |                                                                                                                                                      Description                                                                                                                                                      |
|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Welcome new Pets     | `Creation` capabilities ensure that you can create new {Pet Store} objects. Create a new Dog, Cat, Adoption, or Employee. [Learn more](https://developer.mastercard.com/mastercard-agent-pay/documentation/use-cases/add-new-database-records/index.md)                                                               |
| Search for Pets      | `Retrieving` capabilities ensure that you can receive the most up-to-date Pet, Adoption and Employee information. Retrieve information about a Dog, Cat, Adoption or Employee. [Learn more](https://developer.mastercard.com/mastercard-agent-pay/documentation/use-cases/retrieve-new-database-information/index.md) |
| Filter for Pets      | `Filtering` capabilities allow you to filter and search for specific records. Search for Pets, Adoptions or Employees. [Learn more](https://developer.mastercard.com/mastercard-agent-pay/documentation/use-cases/querying-database-information/index.md)                                                             |
| Edit Pet information | `Updating` capabilities ensure that you instantly update outdated {Pet Store} information. Update information about a Dog, Cat, Pet status, Adoption or Employee. [Learn more](https://developer.mastercard.com/mastercard-agent-pay/documentation/use-cases/update-database-information/index.md)                    |
| Remove Pets          | `Deletion` capabilities ensure that you can instantly delete {Pet Store} records. Delete information about a Pet, Adoption, or Employee. [Learn more](https://developer.mastercard.com/mastercard-agent-pay/documentation/use-cases/delete-database-information/index.md)                                             |

## End-to-End Pet Adoption Process {#end-to-end-pet-adoption-process}

👉 Create an institutional mermaid diagram which encompasses all the service use cases.

Diagram institution

## Error Handling {#error-handling}

👉 Direct the user to information about error handling on your Code and Formats page.

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

## Next Steps {#next-steps}

👉 Direct the user to the API Reference section.

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