# Retrieve Donation Transaction Status
source: https://developer.mastercard.com/donations/documentation/use-cases/manage-donation-trns/transaction-status-api/index.md

The **Donation Transaction Status** endpoint provides real-time visibility into the final outcome of a donation transaction. It is particularly useful for resolving uncertainties caused by network disruptions or authorization timeouts, ensuring that every transaction is accurately tracked and accounted for. This functionality helps maintain transparency and trust in the donation process, while also supporting timely reconciliation and donor communication.

To view the status of a donation transaction, provide `transactionId` as parameter. ~~In case both parameters are passed, the `transactionId` takes precedence over `correlationId`~~ . A successful request returns the `HTTP 200 Success` status code and a JSON response body with the transaction status.

***Note:** Fetching donation transaction status by passing `correlationId` is deprecated.*

## Sequence Diagram {#sequence-diagram}

The following outlines the sequence of events:
Diagram transaction_status

## Execution Steps {#execution-steps}

The following details the steps in the above sequence diagram:

1. The donor requests to view the transaction status of a donation and provides the `transactionId` ~~, `correlationId`, or both~~ in the request to the partner user interface.
2. The partner user interface forwards the request to the partner server.
3. The partner server calls ~~`GET /donations/transactions`~~ `GET /donations/transactions/{transaction_id}/status` endpoint and provides the `transactionId`~~,`correlationId`, or both~~ to Mastercard Donate Service.
4. The Mastercard Donate service validates the incoming request. It retrieves the payment status for the given `transactionId` ~~or `correlationId`~~ in the database.
5. The Mastercard Donate service then returns the `transactionStatus`, `transactionId`, and `transactionMessage` to the partner server.
6. The partner server sends the `transactionStatus`, `transactionId`, and `transactionMessage` to the partner user interface.
7. The partner user interface displays the `transactionStatus`, `transactionId`, and `transactionMessage` on the end-user screen.

## Endpoint {#endpoint}


API Reference: `GET /transactions`


API Reference: `GET /transactions/{transaction_id}/status`

## Endpoint Parameter {#endpoint-parameter}

For more details on the endpoint parameters, refer to the [Parameters to Retrieve Donation Transaction Status](https://developer.mastercard.com/donations/documentation/parameters/track-donations-param/transactionstatus/index.md) section.

## Sample Request and Response {#sample-request-and-response}

For more details on the sample request and response, refer to the [Retrieve Donation Transaction Status](https://developer.mastercard.com/donations/tutorial/donation-api-details/transactionstatusapi/index.md) tutorial.