List Transactions
Returns payments and free registrations for your Mangoes.
Filters
- Compatible filters are combined.
- Use either
customersorcustomerSearch. - With
freeRegistrationsOnly, only the date range,mangoes,customers, andpaymentCyclemay also be used.
Results
- Newest transactions appear first by
occurredAt; ties have no fixed order. - This request is read-only and safe to retry.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/transactions" \ -H "x-whitelabel-host: string" \ -H "Content-Type: application/json" \ -d '{}'{
"total": 100,
"data": [
{
"id": "66f3a1c4d9f135a7b2c3d4e5",
"occurredAt": "2026-08-24T11:02:41.517Z",
"status": "completed",
"quantity": 1,
"couponCode": "SUMMER20",
"customer": {
"_id": "6659ca9e5f2acb7abfdcd8fd",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": 1234567890,
"profilePicUrl": "https://linktoprofilepic.com/pic.jpg",
"country": "India"
},
"mango": {
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
},
"linkedMangoes": [
{
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
}
],
"payment": {
"type": "onetime",
"chargedAmount": 4999,
"currency": "INR",
"discountAmount": 0,
"gstAmount": 762.56,
"subtotalBeforeDiscount": 4236.44
},
"commission": {
"totalAmountIncludingGst": 499.9,
"reportedGstAmount": 89.98
},
"refund": {
"amount": 0,
"amountByCurrency": {
"inrAmount": 4999,
"usdAmount": 60,
"eurAmount": 55
},
"status": "completed",
"isPartial": false,
"retrievalReferenceNumber": "203945873421",
"initiatedAt": "2026-08-14T09:02:11.000Z"
},
"invoices": {
"customer": {
"url": "https://invoices.tagmango.com/10482.pdf",
"number": 10482
},
"commission": {
"url": "https://invoices.tagmango.com/10482.pdf",
"number": 10482
}
},
"affiliate": {
"commissionAmount": 250,
"withdrawalStatus": "pending",
"withdrawalDate": "2026-09-01T00:00:00.000Z"
},
"noCostEmi": {
"absorbedInterestAmount": 180,
"absorbedInterestByCurrency": {
"inrAmount": 4999,
"usdAmount": 60,
"eurAmount": 55
}
},
"priceBreakdown": [
{
"mangoId": "66c8f2a4b7d913e5f0a1b2d4",
"mango": {
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
},
"inrAmount": 4999,
"usdAmount": 60,
"eurAmount": 55
}
],
"upsells": [
{
"mangoId": "66c8f2a4b7d913e5f0a1b2d4",
"mango": {
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
},
"inrAmount": 4999,
"usdAmount": 60,
"eurAmount": 55
}
],
"customFields": {
"Company name": "Acme Pvt Ltd",
"Team size": "25"
}
}
],
"page": 1,
"limit": 10,
"hasNext": true,
"reportingCurrency": "INR"
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"errorCode": "TRANSACTION_INVALID_REQUEST",
"message": "Check the request body for a contradictory filter combination: supply startDate and endDate together with startDate no later than endDate and a span within the allowed window; do not combine customers with customerSearch; and combine freeRegistrationsOnly only with startDate/endDate, mangoes, customers, and paymentCycle.",
"result": "Check the request body for a contradictory filter combination: supply startDate and endDate together with startDate no later than endDate and a span within the allowed window; do not combine customers with customerSearch; and combine freeRegistrationsOnly only with startDate/endDate, mangoes, customers, and paymentCycle.",
"success": false
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 404,
"type": "Not Found",
"statusMessage": "NOT_FOUND",
"errorCode": "TRANSACTION_HOST_NOT_FOUND",
"message": "We could not resolve a creator for the authenticated host.",
"result": "We could not resolve a creator for the authenticated host.",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}{
"code": 500,
"type": "UnknownError",
"statusMessage": "INTERNAL_SERVER_ERROR",
"errorCode": "TRANSACTION_LIST_FAILED",
"message": "We could not load the transactions. Please try again later.",
"result": "We could not load the transactions. Please try again later.",
"success": false
}