Get redemption transaction detail
Developing
GET
https://sgtr-api.returning.ai/v2/redemption-transactions/{redemptionID}
Store / Redemptions
What this endpoint does
INFO
Quick start
Authentication and permission
| Send | Permission | Community scope |
|---|---|---|
Authorization: Bearer <apiKey> | customerSuccess | Community scope is derived from the key; do not send a community identifier. |
Complete examples
{pathParameter} and use the query parameters documented below.Success and readback
meta.code = REDEMPTION_TRANSACTION_RETRIEVED{
"meta": {
"status": "success",
"statusCode": 200,
"code": "REDEMPTION_TRANSACTION_RETRIEVED"
},
"message": "Get redemption transaction detail successfully",
"data": {
"_id": "hist_agent_01",
"redemptionId": "ORD202607220001",
"productName": "Agent Test Voucher",
"price": 100,
"quantity": 1,
"status": "New Purchase",
"statusID": "sts_new",
"type": "voucher",
"userId": "usr_agent_01",
"purchasedDate": "2026-07-22T02:00:00.000Z",
"userData": {
"email": "agent-test@example.invalid",
"userName": "agent-test",
"roles": [
"@all"
]
}
}
}CHECK
Errors and recovery
meta.code, never message text.| HTTP | Machine code | What the caller should do | Retry? |
|---|---|---|---|
| 400 | VALIDATION_FAILED | Use the public ORD identifier. | No, fix first |
| 401 | AUTH_API_KEY_REQUIRED | Add the Authorization header. | No, fix first |
| 401 | AUTH_API_KEY_INVALID | Replace or rotate the key. | No, fix first |
| 401 | AUTH_API_KEY_VALIDATION_FAILED | Authentication could not be completed. | Yes, with backoff |
| 403 | AUTH_PERMISSION_REQUIRED | Request the customerSuccess permission; no resource data is returned. | No, fix first |
| 404 | REDEMPTION_TRANSACTION_NOT_FOUND | Refresh the scoped order list. | After refreshing the ID |
| 500 | INTERNAL_ERROR | Retry with exponential backoff and the same request context, then escalate. | Yes, with backoff |
| 502 | REDEMPTION_DEPENDENCY_UNAVAILABLE | Retry with exponential backoff. | Yes, with backoff |
Retry safety
TIP
Gotchas
Next steps
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://sgtr-api.returning.ai/v2/redemption-transactions/ORD202607220001' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success Example
{
"meta": {
"status": "success",
"statusCode": 200,
"code": "REDEMPTION_TRANSACTION_RETRIEVED"
},
"message": "Get redemption transaction detail successfully",
"data": {
"_id": "hist_agent_01",
"redemptionId": "ORD202607220001",
"productName": "Agent Test Voucher",
"price": 100,
"quantity": 1,
"status": "New Purchase",
"statusID": "sts_new",
"type": "voucher",
"userId": "usr_agent_01",
"purchasedDate": "2026-07-22T02:00:00.000Z",
"userData": {
"email": "agent-test@example.invalid",
"userName": "agent-test",
"roles": [
"@all"
]
}
}
}Modified at 2026-08-08 03:41:01