TagMangoTagMango Docs
Transactions

List Transactions

POST
/api/v1/external/transactions

Returns payments and free registrations for your Mangoes.

Filters

  • Compatible filters are combined.
  • Use either customers or customerSearch.
  • With freeRegistrationsOnly, only the date range, mangoes, customers, and paymentCycle may 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.

AuthorizationBearer <token>

In: header

Header Parameters

x-whitelabel-host*string

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
}