GET
/
v0
/
gamertag
/
transaction
/
{id}
Get Reward
curl --request GET \
  --url https://api.zebedee.io/v0/gamertag/transaction/{id} \
  --header 'apikey: <apikey>'
{
  "message": "Fetched charge.",
  "success": true,
  "data": {
    "id": "903883f2-67d9-4707-a21b-ddff004fe041",
    "receiverId": "ec9b38d5-b126-4307-9d1e-8aa0dfab5d7e",
    "amount": "15000",
    "fee": "1000",
    "unit": "msats",
    "processedAt": "2023-01-04T15:59:16.993Z",
    "confirmedAt": "2023-01-04T15:59:16.989Z",
    "comment": "Achievement unlocked! 🏆",
    "status": "TRANSACTION_STATUS_COMPLETED"
  }
}

Track and verify rewards sent to your users. This endpoint provides complete transaction details including status, fees, and confirmation times.

​
When to Use This

Verify Delivery

Confirm rewards reached the intended recipient

Track Performance

Build reward dashboards and reports with transaction data

Handle Support

Investigate user inquiries about rewards

Audit Trail

Maintain records for accounting and compliance

​
Configuration

​
Path Parameters

​
id
string
required

Transaction ID from the Send Reward response

Example: "78fb6474-d791-47a1-bda1-a4b9023898c0"

​
Header Parameters

​
apikey
string
required

Your ZBD Project API Key

​
Code Examples

curl -X GET https://api.zebedee.io/v0/gamertag/transaction/78fb6474-d791-47a1-bda1-a4b9023898c0 \
  -H "apikey: YOUR_API_KEY"

​
Response

{
  "message": "Fetched charge.",
  "success": true,
  "data": {
    "id": "903883f2-67d9-4707-a21b-ddff004fe041",
    "receiverId": "ec9b38d5-b126-4307-9d1e-8aa0dfab5d7e",
    "amount": "15000",
    "fee": "1000",
    "unit": "msats",
    "processedAt": "2023-01-04T15:59:16.993Z",
    "confirmedAt": "2023-01-04T15:59:16.989Z",
    "comment": "Achievement unlocked! 🏆",
    "status": "TRANSACTION_STATUS_COMPLETED"
  }
}

​
Response Fields

FieldTypeDescription
idstringUnique transaction identifier
receiverIdstringRecipient’s ZBD User ID
amountstringReward amount in millisatoshis
feestringNetwork fee in millisatoshis
unitstringAlways “msats”
processedAtstringWhen transaction was initiated
confirmedAtstringWhen reward was delivered
commentstringDescription sent with reward
statusstringTransaction status (see below)

​
Status Values

StatusDescription
TRANSACTION_STATUS_COMPLETEDReward successfully delivered
TRANSACTION_STATUS_PENDINGProcessing (rare for gamertag payments)
TRANSACTION_STATUS_FAILEDReward failed to deliver

Instant Verification - Rewards sent to gamertags are confirmed within milliseconds. The status will almost always be COMPLETED when you check.