> For the complete documentation index, see [llms.txt](https://docs.lenderlink.ph/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lenderlink.ph/product-guides/api-integration-guides/mega-api.md).

# Mega API

{% hint style="success" %}

#### For fast and easy development please use our specially designed GitHub repository for coding LLMs <https://github.com/lenderlink/lenderlink-docs>

{% endhint %}

This API is used to deliver data responses for multiple products. It can deliver JSON containing the data from the APIs below:

* [Full Response Consumer API Integration guide](/product-guides/api-integration-guides/full-response-consumer-api-integration-guide.md)
* [Telco Score API](/product-guides/api-integration-guides/telco-score-api.md)
* [Loan Applications Check API](/product-guides/api-integration-guides/loan-applications-check-api.md)
* [Standalone Payment Transaction Data API](/product-guides/api-integration-guides/standalone-payment-transaction-data-api.md)
* [Gen-1 LenderLink Network Score](/product-guides/lenderlink-network-score/gen-1-lenderlink-network-score.md)
* [Gen-2 LenderLink Network Score](/product-guides/lenderlink-network-score/gen-2-lenderlink-network-score.md)

## Authentication

Obtain a token via the [Authentication](/product-guides/api-integration-guides/authentication.md) procedure.&#x20;

## Request  Data

### Introduction

This endpoint facilitates the generation of a borrower's full data available by their phone number.

{% hint style="warning" %}
Note:

To utilize this endpoint, an access token is required. The procedure for obtaining one is detailed in the preceding section.
{% endhint %}

### **Request Data  Flow**

#### **Option 1**

POST API

```
https://sandbox-app.lenderlink.ph/api/v1/person/mega-report
```

Accepts a **raw JSON request body**.\
\
Clients must send `Content-Type: application/json`

Authorization

Use the generated token as Bearer access token and include it into the request.

| Token | `eyJ0eXAiOiJKasd10sJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI5YTc4MzVm...` |
| ----- | -------------------------------------------------------------- |

#### Request body (JSON)

```json
{
  "requestId": "test-02f2-4933-88f3-a73c94e83487",
  "firstName": "John",
  "lastName": "Doe",
  "dateOfBirth": "1990-01-01",
  "idNumber": "ABC123456",
  "email": "john.doe@example.com",
  "cellphoneNumber": "63XXXXXXXXXX",
  "productIds": "FR,PT,CHA,TS"
}

```

#### Live examples (Full Response) that can be tested on our sandbox.

```json
 {
    "requestId": "test-09ab-4933-88f3-a73c94e83401",
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1990-01-01",
    "idNumber": "ABC123456",
    "email": "john.doe@example.com",
    "cellphoneNumber": "639171230001",
    "productIds": "FR"
  },
  {
    "requestId": "test-10bc-4933-88f3-a73c94e83402",
    "firstName": "Jane",
    "lastName": "Smith",
    "dateOfBirth": "1985-07-15",
    "idNumber": "XYZ987654",
    "email": "jane.smith@example.com",
    "cellphoneNumber": "639171230002",
    "productIds": "FR"
  },
  {
    "requestId": "test-11cd-4933-88f3-a73c94e83403",
    "firstName": "Michael",
    "lastName": "Johnson",
    "dateOfBirth": "1978-12-30",
    "idNumber": "LMN456789",
    "email": "michael.johnson@example.com",
    "cellphoneNumber": "639171230003",
    "productIds": "FR"
  },
  {
    "requestId": "test-12de-4933-88f3-a73c94e83404",
    "firstName": "Maria",
    "lastName": "Garcia",
    "dateOfBirth": "1992-04-20",
    "idNumber": "PQR123456",
    "email": "maria.garcia@example.com",
    "cellphoneNumber": "639171230004",
    "productIds": "FR"
  },
  {
    "requestId": "test-13ef-4933-88f3-a73c94e83405",
    "firstName": "Wei",
    "lastName": "Chen",
    "dateOfBirth": "1980-10-05",
    "idNumber": "JKL789012",
    "email": "wei.chen@example.com",
    "cellphoneNumber": "639171230005",
    "productIds": "FR"
  },
  {
    "requestId": "test-14f0-4933-88f3-a73c94e83406",
    "firstName": "Soo",
    "lastName": "Lee",
    "dateOfBirth": "1995-02-18",
    "idNumber": "QRS567890",
    "email": "soo.jin.lee@example.com",
    "cellphoneNumber": "639171230006",
    "productIds": "FR"
  },
  {
    "requestId": "test-33a1-4933-88f3-a73c94e83407",
    "firstName": "Rojas",
    "lastName": "Smith",
    "dateOfBirth": "1990-07-01",
    "idNumber": "ABC123456",
    "email": "fernando@example.com",
    "cellphoneNumber": "639385208771",
    "productIds": "FR"
  },
  {
    "requestId": "test-a1b2-4c3d-91e5-f67890123401",
    "firstName": "Ramon",
    "lastName": "Santos",
    "dateOfBirth": "1988-03-14",
    "idNumber": "PHL20230001",
    "email": "ramon.santos@gmail.com",
    "cellphoneNumber": "639171230007",
    "productIds": "FR"
  },
  {
    "requestId": "test-b2c3-5d4e-82f6-a78901234502",
    "firstName": "Ana",
    "lastName": "Reyes",
    "dateOfBirth": "1993-11-22",
    "idNumber": "PHL20230002",
    "email": "ana.reyes@yahoo.com",
    "cellphoneNumber": "639171230008",
    "productIds": "FR"
  },
  {
    "requestId": "test-c3d4-6e5f-73a7-b89012345603",
    "firstName": "Carlos",
    "lastName": "Torres",
    "dateOfBirth": "1975-08-09",
    "idNumber": "PHL20230003",
    "email": "carlos.torres@outlook.com",
    "cellphoneNumber": "639171230009",
    "productIds": "FR"
  },
  {
    "requestId": "test-d4e5-7f6a-64b8-c90123456704",
    "firstName": "Lisa",
    "lastName": "Fernandez",
    "dateOfBirth": "1997-05-30",
    "idNumber": "PHL20230004",
    "email": "lisa.fernandez@email.com",
    "cellphoneNumber": "639171230010",
    "productIds": "FR"
  }
  {
  "requestId": "test-e5f6-8a7b-55c9-d01234567805",
  "firstName": "Pedro",
  "lastName": "Ramos",
  "dateOfBirth": "1986-09-17",
  "idNumber": "PHN20240011",
  "email": "pedro.ramos@gmail.com",
  "cellphoneNumber": "639171230011",
  "productIds": "FR"
}
```

#### Option 2

GET API URL

```
https://sandbox-app.lenderlink.ph/api/v1/person/mega-report
```

Authorization

Use the generated token as Bearer access token and include it into the request.

| Token | `eyJ0eXAiOiJKasd10sJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI5YTc4MzVm...` |
| ----- | -------------------------------------------------------------- |

* **Query Params**

<table><thead><tr><th width="258">Parameter</th><th width="125">Type</th><th width="116">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>requestId</td><td>String</td><td>Yes</td><td>Unique identification code generated by the client</td></tr><tr><td>firstName</td><td>String</td><td>Yes</td><td>First Name</td></tr><tr><td>lastName</td><td>String</td><td>Yes</td><td>Last Name</td></tr><tr><td>dateOfBirth</td><td>Date</td><td>Yes</td><td>Date of Birth - YYYY-MM-DD</td></tr><tr><td>cellphoneNumber</td><td>String</td><td>Yes</td><td>Borrower's phone number, the format is 63XXXXXXXXXX.</td></tr><tr><td>email</td><td>String</td><td>No</td><td>Borrower's email address</td></tr><tr><td>idNumber</td><td>String</td><td>No</td><td>Borrower's ID document number. ID, Driver license, etc</td></tr><tr><td>productIds</td><td>String</td><td>Yes</td><td>The list of products that you are requesting data from, as a comma-separated string. "FR", "PT", "TS", "LAC", "PT1", "PT2", "PT3", "PT4". See Standalone Payment Transaction products below.</td></tr></tbody></table>

### 1. No match:

```json

{
    "requestId": "X123-AB45",
    "productIds": [],
    "response": {}
}
                                
```

### 2. Match&#x20;

{% stepper %}
{% step %}

### You can use this interactive tool [<mark style="color:green;background-color:yellow;">https://dimohh.github.io/json/</mark>](https://dimohh.github.io/json/) to check what will the be the exact JSON you will receive if you include or exclude productIds.

{% endstep %}

{% step %}

### JSON structure

```json
{
  "requestId": "X123-AB45",
  "productIds": [
    "FR",
    "TS",
    "LAC",
    "PT1",
    "PT2",
    "PT3",
    "PT4"
  ],
  "response": {
    "FR": {
      "data": [
        {
          "recordID": "123456789",
          "kycSurname": "Doe",
          "kycFirstName": "John",
          "kycMiddleName": "Smith",
          "kycDateOfBirth": "1990-01-01",
          "kycIdNumber": "ABC123456",
          "kycIdType": 4,
          "kycMobileNumber": "63XXXXXXXXXX",
          "kycEmailAddress": "john.doe@example.com",
          "kycAddress": "123 Main St, Anytown, USA",
          "loanInfoLoanType": 1,
          "loanInfoApplicationDate": "2022-01-01",
          "loanInfoOpenDate": "2022-01-01",
          "loanInfoLoanTerm": 5,
          "loanInfoOpenBalance": 10000,
          "loanInfoOutstandingBalance": 8000,
          "loanInfoNextDueDate": "2024-05-01",
          "loanInfoLastPaymentAmount": 200,
          "loanInfoLastPaymentDate": "2024-04-01",
          "loanInfoStatusCode": "Active",
          "loanInfoInstallmentAmount": 500,
          "loanInfoOverdueAmount": 100,
          "loanInfoRepaymentFrequency": 1,
          "loanInfoRepaymentHistory": "00000",
          "loanInfoRepaymentFullHistory": [
            {
              "dueDate": "2022-02-01",
              "paymentDate": "2022-02-01",
              "paymentAmount": 500.00
            },
            {
              "dueDate": "2022-03-01",
              "paymentDate": "2022-03-01",
              "paymentAmount": 500.00
            },
            {
              "dueDate": "2022-04-01",
              "paymentDate": "2022-04-01",
              "paymentAmount": 500.00
            },
            {
              "dueDate": "2022-05-01",
              "paymentDate": "2022-05-01",
              "paymentAmount": 500.00
            },
            {
              "dueDate": "2022-06-01",
              "paymentDate": "2022-06-01",
              "paymentAmount": 500.00
            }
          ],
          "loanInfoCloseDate": "2023-12-28",
          "loanInfoLenderType": "fintech",
          "contributorId": "12d3ae45-678d-9ae1-2345-6e789e3xx000",
          "matchedKeys": [
            "cellphoneNumber",
            "email",
            "firstName-lastName-dateOfBirth",
            "idNumber"
          ],
          "matchedKeyCount": 4
        }
      ],
      "summary": {
        "numApp": 1,
        "numAcc": 1,
        "numReqSameDay": 3,
        "wasDpd30Ever": 1,
        "wasDpd90Ever": 0,
        "wasDpd30Last3Months": 0,
        "wasDpd90Last3Months": 0,
        "wasDpd30LastYear": 0,
        "wasDpd90LastYear": 0,
        "numActiveLoan": 1,
        "numClosedLoans": 2,
        "numCollectionLoans": 0,
        "numDelayedLoans": 0,
        "numIncompleteLoans": 0,
        "numNotDisbLoans": 0,
        "numRejectedLoans": 2,
        "numWrittenoffLoans": 0,
        "minOpenBalance": 500,
        "maxOpenBalance": 3000,
        "sumOpenBalance": 4500,
        "avgOpenBalance": 1500,
        "minOutstanding": 3360,
        "maxOutstanding": 3360,
        "sumOutstanding": 3360,
        "avgOutstanding": 3360,
        "minLastPayment": 0,
        "maxLastPayment": 1000,
        "sumLastPayment": 1674,
        "avgLastPayment": 837,
        "minInstallment": 0,
        "maxInstallment": 3360,
        "sumInstallment": 4360,
        "avgInstallment": 1453.33,
        "minOverdue": 0,
        "maxOverdue": 0,
        "sumOverdue": 0,
        "avgOverdue": 0,
        "minLoanTerm": 0,
        "maxLoanTerm": 1,
        "avgLoanTerm": 1,
        "avgOpenBalancePerLoan": 1500,
        "avgOutstandingPerLoan": 1120,
        "ratioDisbAppl": 0.6,
        "ratioOutstandingOpenbalance": 0.75,
        "ratioOverdueInstallment": 0,
        "avgUtilizationRate": 2.24,
        "maxUtilizationRate": 1.12,
        "paymentToOutstandingRatio": 0.5,
        "avgPaymentToInstallmentRatio": 0.58,
        "highOutstandingFlag": 0,
        "veryHighOutstandingFlag": 0,
        "overdueFlag": 0,
        "highOverdueFlag": 0,
        "openRange": 2500,
        "balanceVolatilityProxy": 1.67,
        "outstandingRange": 0,
        "outstandingVolatilityProxy": 0,
        "installmentRange": 3360,
        "installmentVolatilityProxy": 2.31,
        "outstandingToOpenTrendProxy": 0,
        "overdueTrendProxy": 0,
        "loanTermTrendProxy": 0,
        "avgApplDays": 8,
        "daysSinceLastApplication": 1,
        "daysSinceLastReject": 1,
        "numRecordsLast10Days": 4,
        "numRecordsLast30Days": 4,
        "numRecordsLast60Days": 5,
        "numRecordsLast90Days": 5,
        "numRecordsLast180Days": 5,
        "maxRecWeek": 2,
        "minDaysApp": 1,
        "maxDaysApp": 32,
        "isFrequentApplicant": 1,
        "isMediumFreqApplicant": 0,
        "isInfrequentApplicant": 0,
        "applicationFrequencyTrend": 0.13,
        "numDistContr": 3,
        "shareBiggestContr": 0.4,
        "numDistIdNum": 1,
        "numDistIdType": 1,
        "numDistPhones": 1,
        "numDistEmail": 1,
        "numDistNames": 2,
        "closedRate": 0.4,
        "activeRate": 0.2,
        "delayedRate": 0,
        "collectionRate": 0,
        "writtenoffRate": 0,
        "rejectRate": 0.4,
        "notDisbRate": 0,
        "incompleteRate": 0,
        "noHistPerf": 0,
        "hasBadHistory": 0,
        "hasCleanClosedHistory": 1,
        "badToGoodRatio": 0,
        "age": 28,
        "numDistLoanType": 2,
        "numPaydayLoans": 2,
        "numPosLoans": 0,
        "numCashLoans": 0,
        "numRevLoans": 1,
        "numCCLoans": 0,
        "numAutoLoans": 0,
        "numMotoLoans": 0,
        "numHomeLoans": 0
      },
      "scores": {
        "CS": {
          "score": 540,
          "band": 9
        }
      }
    },
    "TS": {
      "transactionId": "f2279c3df6eb4368a8ec31c0ca561c8a",
      "code": "0000",
      "result": "ok",
      "scores": {
        "G": [
          ["score", 337],
          ["band", 1]
        ]
      }
    },
    "LAC": {
      "result": "ok",
      "code": "0000",
      "transactionId": "c14432247a694546bdd11abf156c2161",
      "scores": {
        "CVSCR2": {
          "cvScore": {
            "score": 501,
            "band": 3
          },
          "cvTotals": {
            "reqTotal1": 0,
            "unqEntities1": 0,
            "reqOthers1": 0,
            "reqBnpl1": 0,
            "reqPos1": 0,
            "reqDigiLoan1": 0,
            "reqDigiBank1": 0,
            "reqCashLoan1": 0,
            "reqAuto1": 0,
            "reqBank1": 0,
            "reqDigiBnpl1": 0,
            "reqTotal7": 0,
            "unqEntities7": 0,
            "reqOthers7": 0,
            "reqBnpl7": 0,
            "reqPos7": 0,
            "reqDigiLoan7": 0,
            "reqDigiBank7": 0,
            "reqCashLoan7": 0,
            "reqAuto7": 0,
            "reqBank7": 0,
            "reqDigiBnpl7": 0,
            "reqTotal14": 0,
            "unqEntities14": 0,
            "reqOthers14": 0,
            "reqBnpl14": 0,
            "reqPos14": 0,
            "reqDigiLoan14": 0,
            "reqDigiBank14": 0,
            "reqCashLoan14": 0,
            "reqAuto14": 0,
            "reqBank14": 0,
            "reqDigiBnpl14": 0,
            "reqTotal21": 0,
            "unqEntities21": 0,
            "reqOthers21": 0,
            "reqBnpl21": 0,
            "reqPos21": 0,
            "reqDigiLoan21": 0,
            "reqDigiBank21": 0,
            "reqCashLoan21": 0,
            "reqAuto21": 0,
            "reqBank21": 0,
            "reqDigiBnpl21": 0,
            "reqTotal28": 0,
            "unqEntities28": 0,
            "reqOthers28": 0,
            "reqBnpl28": 0,
            "reqPos28": 0,
            "reqDigiLoan28": 0,
            "reqDigiBank28": 0,
            "reqCashLoan28": 0,
            "reqAuto28": 0,
            "reqBank28": 0,
            "reqDigiBnpl28": 0,
            "reqTotal35": 0,
            "unqEntities35": 0,
            "reqOthers35": 0,
            "reqBnpl35": 0,
            "reqPos35": 0,
            "reqDigiLoan35": 0,
            "reqDigiBank35": 0,
            "reqCashLoan35": 0,
            "reqAuto35": 0,
            "reqBank35": 0,
            "reqDigiBnpl35": 0,
            "reqTotal45": 0,
            "unqEntities45": 0,
            "reqOthers45": 0,
            "reqBnpl45": 0,
            "reqPos45": 0,
            "reqDigiLoan45": 0,
            "reqDigiBank45": 0,
            "reqCashLoan45": 0,
            "reqAuto45": 0,
            "reqBank45": 0,
            "reqDigiBnpl45": 0,
            "reqTotal60": 0,
            "unqEntities60": 0,
            "reqOthers60": 0,
            "reqBnpl60": 0,
            "reqPos60": 0,
            "reqDigiLoan60": 0,
            "reqDigiBank60": 0,
            "reqCashLoan60": 0,
            "reqAuto60": 0,
            "reqBank60": 0,
            "reqDigiBnpl60": 0,
            "reqTotal90": 0,
            "unqEntities90": 0,
            "reqOthers90": 0,
            "reqBnpl90": 0,
            "reqPos90": 0,
            "reqDigiLoan90": 0,
            "reqDigiBank90": 0,
            "reqCashLoan90": 0,
            "reqAuto90": 0,
            "reqBank90": 0,
            "reqDigiBnpl90": 0,
            "reqTotal180": 0,
            "unqEntities180": 0,
            "reqOthers180": 0,
            "reqBnpl180": 0,
            "reqPos180": 0,
            "reqDigiLoan180": 0,
            "reqDigiBank180": 0,
            "reqCashLoan180": 0,
            "reqAuto180": 0,
            "reqBank180": 0,
            "reqDigiBnpl180": 0,
            "reqTotal360": 0,
            "unqEntities360": 0,
            "reqOthers360": 0,
            "reqBnpl360": 0,
            "reqPos360": 0,
            "reqDigiLoan360": 0,
            "reqDigiBank360": 0,
            "reqCashLoan360": 0,
            "reqAuto360": 0,
            "reqBank360": 0,
            "reqDigiBnpl360": 0,
            "reqTotal540": 0,
            "unqEntities540": 0,
            "reqOthers540": 0,
            "reqBnpl540": 0,
            "reqPos540": 0,
            "reqDigiLoan540": 0,
            "reqDigiBank540": 0,
            "reqCashLoan540": 0,
            "reqAuto540": 0,
            "reqBank540": 0,
            "reqDigiBnpl540": 0,
            "reqTotal720": 1,
            "unqEntities720": 1,
            "reqOthers720": 1,
            "reqBnpl720": 0,
            "reqPos720": 0,
            "reqDigiLoan720": 1,
            "reqDigiBank720": 0,
            "reqCashLoan720": 0,
            "reqAuto720": 0,
            "reqBank720": 0,
            "reqDigiBnpl720": 0,
            "reqTotalAll": 33,
            "unqEntitiesTotalAll": 6,
            "reqOthersTotalAll": 33
          }
        }
      }
    },
    "PT1": {
      "startDate": "2026-09-01T15:14:35.3598891+08:00",
      "endDate": "2026-03-01T00:00:00+08:00",
      "rangeMonths": 6,
      "transactionCount": 3,
      "minAmount": 1000,
      "maxAmount": 2500,
      "aveAmount": 1666.67,
      "sumAmount": 5000,
      "stdDev": 623.61,
      "refDates": [
        "2026-05-02",
        "2026-07-15",
        "2026-08-20"
      ],
      "refDateDetails": [
        {
          "refDate": "2026-05-02",
          "count": 1,
          "total": 1000
        },
        {
          "refDate": "2026-07-15",
          "count": 1,
          "total": 2500
        },
        {
          "refDate": "2026-08-20",
          "count": 1,
          "total": 1500
        }
      ],
      "categories": [
        "Loans",
        "Marketplace"
      ],
      "procIds": [
        "EXPR",
        "EXQR"
      ],
      "within1to30Days": [
        {
          "category": "Loans",
          "transactionCount": 1,
          "minAmount": 1500,
          "maxAmount": 1500,
          "sumAmount": 1500,
          "stdDev": 0
        }
      ],
      "within31to60Days": [
        {
          "category": "Loans",
          "transactionCount": 1,
          "minAmount": 2500,
          "maxAmount": 2500,
          "sumAmount": 2500,
          "stdDev": 0
        }
      ],
      "beyond61Days": [
        {
          "category": "Marketplace",
          "transactionCount": 1,
          "minAmount": 1000,
          "maxAmount": 1000,
          "sumAmount": 1000,
          "stdDev": 0
        }
      ]
    },
    "PT2": {
      "startDate": "2026-09-01T15:14:35.3598891+08:00",
      "endDate": "2026-03-01T00:00:00+08:00",
      "rangeMonths": 6,
      "transactionCount": 2,
      "minAmount": 300,
      "maxAmount": 700,
      "aveAmount": 500,
      "sumAmount": 1000,
      "stdDev": 200,
      "refDates": [
        "2026-07-20",
        "2026-08-28"
      ],
      "refDateDetails": [
        {
          "refDate": "2026-07-20",
          "count": 1,
          "total": 700
        },
        {
          "refDate": "2026-08-28",
          "count": 1,
          "total": 300
        }
      ],
      "categories": [
        "Fintech"
      ],
      "procIds": [
        "EXGC"
      ],
      "within1to30Days": [
        {
          "category": "Fintech",
          "transactionCount": 1,
          "minAmount": 300,
          "maxAmount": 300,
          "sumAmount": 300,
          "stdDev": 0
        }
      ],
      "within31to60Days": [
        {
          "category": "Fintech",
          "transactionCount": 1,
          "minAmount": 700,
          "maxAmount": 700,
          "sumAmount": 700,
          "stdDev": 0
        }
      ],
      "beyond61Days": []
    },
    "PT3": {
      "statusCode": 200,
      "data": [
        {
          "id": 100000001,
          "transactionCategory": "Topups",
          "guid": "11111111-1111-4111-8111-111111111111",
          "customerId": 21,
          "terminalId": "TERM0001",
          "referenceNumber": "TERM0001-0000000001",
          "officialReceiptNumber": null,
          "traceNo": "TRACE-0000000001",
          "mobileNumber": "639000000001",
          "identifier": "1",
          "billerTag": "EXAMPLEBILLER",
          "amount": 500,
          "tranType": "C",
          "dateIn": "2026-08-14T09:35:40",
          "status": 2,
          "statusMsg": {
            "message": "Transaction is successfully processed",
            "httpStat": 200
          },
          "timestamp": "2026-08-14T01:35:46",
          "terminalCity": "Example City",
          "terminalProvince": "Example Province",
          "terminalRegion": "Example Region"
        }
      ],
      "message": "Request Successful",
      "trackingId": "55555555-5555-4555-8555-555555555555"
    },
    "PT4": {
      "results": [
        {
          "txnId": "TXN_EXAMPLE_0001",
          "amount": "250.00",
          "sector": "EMI",
          "storeId": "STR_EXAMPLE_01",
          "merchantName": "Example Wallet",
          "transactionDate": "2026-08-14"
        },
        {
          "txnId": "TXN_EXAMPLE_0002",
          "amount": "1000.00",
          "sector": "EMI",
          "storeId": "STR_EXAMPLE_02",
          "merchantName": "Example Wallet",
          "transactionDate": "2026-07-30"
        }
      ],
      "withResults": true,
      "metadata": {
        "totalBeforeDedup": 2,
        "totalAfterDedup": 2,
        "duplicatesRemoved": 0,
        "queryMethod": "auto",
        "anonymizationEnabled": true
      }
    }
  }
}
```

{% endstep %}
{% endstepper %}

## Standalone Payment Transaction products

The standalone Payment Transaction products can be requested with other supported Mega API products except legacy PT. Each product is selected and returned independently.

| Product                | Product code | Response location |
| ---------------------- | ------------ | ----------------- |
| Payment Transactions 1 | `PT1`        | `response.PT1`    |
| Payment Transactions 2 | `PT2`        | `response.PT2`    |
| Payment Transactions 3 | `PT3`        | `response.PT3`    |
| Payment Transactions 4 | `PT4`        | `response.PT4`    |

Continue sending `productIds` as a comma-separated string, not an array:

```json
{
  "productIds": "PT3,PT4"
}
```

```json
{
  "productIds": "FR,PT3,PT4"
}
```

For standalone Payment Transaction products:

* `productIds` in the response contains only products that returned a Hit.
* Each Hit is returned under its product code in `response`.
* Products that do not return a Hit are omitted from both `productIds` and `response`. An omitted product means no Hit was returned; it does not confirm that the borrower has no transactions.
* A requested product is silently omitted when your access token lacks the required product scope. If the token has that scope but the product is not enabled for your account, the entire request returns HTTP 403 `PT_PRODUCT_NOT_ENTITLED`.
* There is no top-level `matchFlag`.
* Property names are returned in camelCase. Each product has its own structure; see the [PT1 and PT2](/product-guides/api-integration-guides/standalone-payment-transaction-data-api/pt1-and-pt2.md), [PT3](/product-guides/api-integration-guides/standalone-payment-transaction-data-api/pt3.md) and [PT4](/product-guides/api-integration-guides/standalone-payment-transaction-data-api/pt4.md) guides for every field.

{% hint style="warning" %}
**Legacy and standalone Payment Transactions cannot be combined**

Use either the legacy product `PT` or the standalone products `PT1`, `PT2`, `PT3` and `PT4`. Do not use both in the same request. Valid: `PT`, `PT3`, `PT3,PT4`, `FR,PT3,PT4`. Invalid: `PT,PT3`, `PT,PT1,PT2`.
{% endhint %}

#### Match example (PT3,PT4, payloads shortened)

```json
{
  "requestId": "8f14e45f-ceea-467a-9c1e-0a1b2c3d4e5f",
  "productIds": [
    "PT3",
    "PT4"
  ],
  "response": {
    "PT3": {
      "statusCode": 200,
      "message": "Request Successful",
      "trackingId": "55555555-5555-4555-8555-555555555555",
      "data": [
        {
          "transactionCategory": "Topups",
          "mobileNumber": "639000000001",
          "amount": 500,
          "dateIn": "2026-08-14T09:35:40",
          "status": 2
        }
      ]
    },
    "PT4": {
      "withResults": true,
      "results": [
        {
          "txnId": "TXN_EXAMPLE_0001",
          "amount": "250.00",
          "sector": "EMI",
          "storeId": "STR_EXAMPLE_01",
          "merchantName": "Example Wallet",
          "transactionDate": "2026-08-14"
        }
      ]
    }
  }
}
```

#### No match example

```json
{
  "requestId": "8f14e45f-ceea-467a-9c1e-0a1b2c3d4e5f",
  "productIds": [],
  "response": {}
}
```

## Errors

| HTTP Status | Message                                  | Description                                                                                                                                            |
| ----------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 400         | `MEGA_PRODUCT_UNSUPPORTED`               | A product code is not supported                                                                                                                        |
| 400         | `MEGA_PAYMENT_TRANSACTION_MODE_CONFLICT` | Legacy `PT` was combined with `PT1`, `PT2`, `PT3` or `PT4`                                                                                             |
| 403         | `PT_PRODUCT_NOT_ENTITLED`                | A requested standalone Payment Transaction product is not enabled for your account. `details` lists the products. No data is returned for the request. |

```json
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "MEGA_PAYMENT_TRANSACTION_MODE_CONFLICT"
}
```

```json
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "MEGA_PRODUCT_UNSUPPORTED"
}
```

```json
{
  "statusCode": 403,
  "error": "Forbidden",
  "message": "PT_PRODUCT_NOT_ENTITLED",
  "details": [
    {
      "productId": "PT4"
    }
  ]
}
```
