# Transaction Details Service
source: https://developer.mastercard.com/transactions-service/documentation/use-cases/transaction-details-service/index.md

This use case is used to fetch the transaction details for given search criteria.

## Pre-requisites {#pre-requisites}

There are no pre-requisites for the customer to use this endpoint.

## Sequence Diagram {#sequence-diagram}

Diagram transaction-details-service

##### Following are the execution steps: {#following-are-the-execution-steps}

1. The consumer signs in to the issuer's app.
2. The customer authenticates the consumer.
3. The customer sends a request to the Transactions Service for the list of transaction details.

* The request for transaction details requires the following mandatory input parameters:
  * userId
  * userIdType

4. Mastercard API Gateway authenticates/authorizes the customer and routes the request to the Transactions Service in the case of a valid customer.
5. The Transactions Service validates the request received via the `/transactions/searches` endpoint.
6. The Transactions Service retrieves the list of transaction details.
7. The Transactions Service sends a response with the list of transaction details (200).
8. The Transactions Service sends a response with a status code of 4xx/5xx in case of an invalid request.

You will receive an error response for an invalid request or any missing request parameter. In that case, you need to update the input and perform step 3 again.

### Endpoint {#endpoint}


API Reference: `GET /transactions/searches`

Note: For more information about the error codes, refer to the [Code and Formats](https://developer.mastercard.com/transactions-service/documentation/code-and-formats/index.md) section.