# Manage Issuing transactions
You can access transactional data about a [transaction's lifecycle](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/transaction-lifecycle.md) using the Transactions API, or through [webhooks](#Subscribe_to_webhooks).
The API can help you investigate a specific transaction or monitor performance, with granular or aggregated data.
---
## Get a list of transactions
Call the [Get a list of transactions](https://api-reference.checkout.com/#tag/Transactions) endpoint
Use the optional query parameters to:
- Limit the number of transactions to return, skip a certain number of transactions, or set a search time frame.
- Search for a specific cardholder, card, entity, or transaction status.
> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).
**Production**
`GET` `https://{prefix}.api.checkout.com/issuing/transactions?limit=0&skip=0&cardholder_id=crh_d3ozhf43pcq2xbldn2g45qnb44&card_id=crd_fa6psq242dcd6fdn5gifcq1491&entity_id=ent_fa6psq242dcd6fdn5gifcq1491&status=authorized&from=string&to=string`
**Sandbox**
`GET` `https://{prefix}.api.sandbox.checkout.com/issuing/transactions?limit=0&skip=0&cardholder_id=crh_d3ozhf43pcq2xbldn2g45qnb44&card_id=crd_fa6psq242dcd6fdn5gifcq1491&entity_id=ent_fa6psq242dcd6fdn5gifcq1491&status=authorized&from=string&to=string`
#### Response example
```json
{
"limit":5,
"skip":10,
"total_count":100,
"data":[
{
"id":"trx_aayhhfwbdyxwcaeyhhfwbd4xga",
"created_on":null,
"status":"authorized",
"transaction_type":"purchase",
"client":{
"id":"cli_vkuhvk4vjn2edkps7dfsq6emqm"
},
"entity":{
"id":"ent_fa6psq242dcd6fdn5gifcq1491"
},
"card":{
"id":"crd_fa6psq242dcd6fdn5gifcq1491",
"network":"mastercard"
},
"digital_card":{
"id":"dcr_5ngxzsynm2me3oxf73esbhda6q",
"wallet_type":"googlepay"
},
"cardholder":{
"id":"crh_d3ozhf43pcq2xbldn2g45qnb44"
},
"amounts":{
"total_held":{
"amount":100,
"currency":"USD"
},
"total_authorized":{
"amount":100,
"currency":"USD"
},
"total_reversed":{
"amount":100,
"currency":"USD"
},
"total_cleared":{
"amount":100,
"currency":"USD"
},
"total_refunded":{
"amount":100,
"currency":"USD"
}
},
"merchant":{
"id":"(*)123456789",
"name":"My Merchant",
"city":"Paris",
"state":"",
"country_code":"FR",
"category_code":5331
},
"reference_transaction":{
"transaction_id":"trx_aayhhfwbdyxwcaeyhhfwbd4xga",
"reference_type":"original_mit"
},
"messages":[
{
"id":"msg_fa6psq242dcd6fdn5gifcq1491",
"initiator":"cardholder",
"type":"authorization",
"result":"declined",
"is_relayed":true,
"indicator":"incremental_preauthorization",
"decline_reason":"expiry_date_invalid",
"authorization_code":"03C0C0",
"billing_amount":100,
"billing_currency":"USD",
"created_on":"2019-09-10T10:11:12Z"
}
],
"_links":{
"self":{
"href":"string",
"actions":[
],
"types":[
]
},
"card":{
"href":"string",
"actions":[
],
"types":[
]
},
"cardholder":{
"href":"string",
"actions":[
],
"types":[
]
},
"reference_transaction":{
"href":"string",
"actions":[
],
"types":[
]
}
}
}
]
}
```
---
## Get a single transaction
Call the [Get a single transactions](https://api-reference.checkout.com/tag/Transactions/#operation/getTransactionById) endpoint and provide the `{transactionId}` path parameter.
> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).
**Production**
`GET` `https://{prefix}.api.checkout.com/issuing/transactions/{transactionId}`
**Sandbox**
`GET` `https://{prefix}.api.sandbox.checkout.com/issuing/transactions/{transactionId}`
#### Response example
```json
{
"id":"trx_aayhhfwbdyxwcaeyhhfwbd4xga",
"created_on":null,
"status":"authorized",
"transaction_type":"purchase",
"client":{
"id":"cli_vkuhvk4vjn2edkps7dfsq6emqm"
},
"entity":{
"id":"ent_fa6psq242dcd6fdn5gifcq1491"
},
"card":{
"id":"crd_fa6psq242dcd6fdn5gifcq1491",
"network":"visa"
},
"digital_card":{
"id":"dcr_5ngxzsynm2me3oxf73esbhda6q",
"wallet_type":"googlepay"
},
"cardholder":{
"id":"crh_d3ozhf43pcq2xbldn2g45qnb44"
},
"amounts":{
"total_held":{
"amount":100,
"currency":"USD"
},
"total_authorized":{
"amount":100,
"currency":"USD"
},
"total_reversed":{
"amount":100,
"currency":"USD"
},
"total_cleared":{
"amount":100,
"currency":"USD"
},
"total_refunded":{
"amount":100,
"currency":"USD"
}
},
"merchant":{
"id":"(*)123456789",
"name":"My Merchant",
"city":"Paris",
"state":"",
"country_code":"FR",
"category_code":5331
},
"reference_transaction":{
"transaction_id":"trx_aayhhfwbdyxwcaeyhhfwbd4xga",
"reference_type":"original_mit"
},
"messages":[
{
"id":"msg_fa6psq242dcd6fdn5gifcq1491",
"initiator":"cardholder",
"type":"authorization",
"result":"declined",
"is_relayed":true,
"indicator":"incremental_preauthorization",
"decline_reason":"expiry_date_invalid",
"authorization_code":"03C0C0",
"billing_amount":100,
"billing_currency":"USD",
"created_on":"2019-09-10T10:11:12Z"
}
],
"_links":{
"self":{
"href":"string",
"actions":[
],
"types":[
]
},
"card":{
"href":"string",
"actions":[
],
"types":[
]
},
"cardholder":{
"href":"string",
"actions":[
],
"types":[
]
},
"reference_transaction":{
"href":"string",
"actions":[
],
"types":[
]
}
}
}
```
### Transaction statuses
The transaction status field in the response indicates the current phase of the transaction as follows:
| Status | Description |
| --- | --- |
| `Authorized` | At least one authorization is approved, but there has been no movement of funds.
A transaction can remain in this status for some time. For example, until a clearing first presentment is received. |
| `Declined` | The transaction failed authorization. |
| `Cleared` | A presentment is received of a given amount. |
| `Canceled` | The transaction is fully reversed by the merchant or the issuer.
If the transaction was authorized and is then partially reversed by the merchant or acquirer, it remains in the authorization phase, and the amount is updated accordingly. |
| `Refunded` | A full or partial refund cleared and the funds returned to the cardholder’s account for a given amount. |
| `Disputed` | A chargeback has been submitted for a cleared transaction. |
### Transaction amounts
The `amounts` object provides a detailed breakdown of the transaction amount during different lifecycle phases.
| Amount type | Description |
| --- | --- |
| `total_held` | The amount Checkout.com holds to cover the transaction, which is not debited from your account.
It represents the difference between the total amount authorized, the total amount reversed, and the total amount cleared.
This value is useful to understand the current liability on the account pending settlement. |
| `total_authorized` | The amount authorized for the transaction.
It aggregates the billing amounts from all approved authorizations for this transaction.
This value is useful to track the total amount approved for spending or withdrawal, offering a clear view of the potential financial commitment. |
| `total_reversed` | The amount reversed by either the merchant or the issuer.
It includes the billing amounts from all approved reversals and issuer-initiated reversals for this transaction.
This value is useful to understand the actual amounts that have moved through the transaction process and been settled. |
| `total_cleared` | The amount cleared by the card scheme, which is the total of the billing amounts of all presentments for this transaction.
This value is useful to understand the actual amounts that have moved through the transaction process and been settled. |
| `total_refunded` | The amount refunded to the cardholder.
It includes the billing amounts of all presentments of the type `refund` for this transaction.
This value is useful to track the total refunds processed, offering insight into the amount returned to the cardholder after th transaction. |
---
## Subscribe to webhooks
You can set up webhooks to be notified about payments with issued cards:
1. [Configure your webhook server](https://www.checkout.com/docs/developer-resources/event-notifications/receive-webhooks/configure-your-webhook-server.md).
2. Subscribe to the following webhooks:
- [Authorization advice received](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/authorization_advice_received.md)
- [Authorization approved](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/authorization_approved.md)
- [Authorization declined](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/authorization_declined.md)
- [Issuer reversal processed](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/issuer_reversal_processed.md)
- [Presentment received](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/presentment_received.md)
- [Presentment reversed](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/presentment_reversed.md)
- [Reversal approved](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/reversal_approved.md)
- [Reversal declined](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/reversal_declined.md)
---
## Related topics
- [Transaction lifecycle](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/transaction-lifecycle.md): Learn more about how your cardholder's transactions transition through the various stages of the transaction lifecycle.
- [Relay authorization requests](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/relay-authorization-requests.md): Review relayed authorization requests to approve or decline payments based on your own fraud logic.
- [Manage Issuing disputes](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/manage-issuing-disputes.md): Learn more about managing disputes on a card that you've issued.
- [Authenticate cardholders for transactions](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/authenticate-cardholders-for-transactions.md): Perform out-of-band (OOB) 3D Secure cardholder authentication for digital transactions in your app.