---
title: "POST /TransactionList"
method: POST
path: "/TransactionList"
tags: ["secure"]
---

# POST /TransactionList

`POST /TransactionList`

## Request

- Base URL: `https://core.demo-paco.2c2p.com/api/2.0/Inquiry`
- URL: `https://core.demo-paco.2c2p.com/api/2.0/Inquiry/TransactionList`
- Auth: API key in header `apiKey`

Retrieve transaction list including latest payment status. It can be called without any parameter but the result will only limitted to 500 results and/or within past full 12 months (whatever more limited)

## Request body `application/jose`

- object
  - `apiRequest` object, required
    - `requestMessageID` string, guid, required: Identifier that idenentify this specific message. Should globally unique but this is up to the cally party. Re-attempt of the same request should also has a new MessageID as well. Accepted format is GUID.
    - `requestDateTime` string, date-time, required: Request DateTime
    - `language` string: Value representing the preferred language as defined in IETF BCP47. Returned from navigator.language property.
  - `advSearchParams` object, required: Parameters for advanced search
    - `officeId` string[]: Office ID
    - `referenceNo` string[]: Reference No. of purchanse item, e.g. Ticket Number and Insurance Policy No.
    - `paymentStatus` string[]: Payment Status
    - `paymentStep` string[]: Payment Step
    - `orderNo` string[]: Order No. (a.k.a Transaction Invoice No.)
    - `productDescription` string[]: Product Description (a.k.a. PNR)
    - `invoiceNo2C2P` string[]: 2C2P Invoice No. (a.k.a. EP Number)
    - `pspReferenceNo` string[]: PSP Reference No. (a.k.a. PSP Invoice No.)
    - `controllerInternalID` string[]: Internal ID (UUID format) for PACO internal used
    - `paymentCategory` string[]
    - `paymentType` string[]
    - `channelCode` string[]
    - `agentCode` string[]
    - `cardFormat` 'First6Digits' | 'Last4Digits' | 'FullPAN': Spedific format of querying card, i.e. First 6 digits, Last 4 digits and Full PAN.
    - `cardNumber` string[]: Credit card number (PAN)
    - `issuerBankCountry` string[]: Country of issuer bank in ISO3166 (2 alphabet format). It will be used for fraud checking.
    - `pspMerchantId` string[]: Merchant ID (MID)
    - `dateOption` 'CreatedDate' | 'UpldatedDate': Which type of date-time coloumns to be look up. CreatedDate will lookup on transactionDateTime whereas UpdatedDate will lookup on lastUpdatedDTTM
    - `fromDate` string, date-time: From date to lookup. Also affected by dateOption.
    - `toDate` string, date-time: To date to lookup. Must not before fromDate. Also affected by dateOption.
    - `amountType` 'Transaction' | 'Settlement': Amount type: Transaction or Settlement
    - `amountFrom` string: Look up amount from. Must not more than amountTo. Authorization amount including leading zero. The decimal point is based on the currency exponent in ISO4217. (eg. If currency is THB, exponent is 2 so the last 2 digits is decimal point)
    - `amountTo` string: Look up amount to. Must not less than amountFrom. Authorization amount including leading zero. The decimal point is based on the currency exponent in ISO4217. (eg. If currency is THB, exponent is 2 so the last 2 digits is decimal point)
    - `currencyCode` string: ISO 4217 Currency code (3-character format variant)
    - `statementDescriptor` string: Dynamic statement description displayed on the customer's account. Restrictions: cannot contain the following special characters: < > ' " * Note: Feature availability is subject to the acquiring bank
    - `transactionInitiator` string: Code of transaction initiator: C = Customer (default), M = Merchant
    - `previousPaymentID` string
    - `maxResults` integer: Maximum number of results to be inquiried. Avoid using too big number here for performance reason. The maximum limit is 500.

## Response `200`

List of payment transaction and status

## Other responses

- `400`: The specified resource was not found

---

[API](https://skmtc.dev/2c2p/apis/inquiry.md) - [All operations](https://skmtc.dev/2c2p/apis/inquiry/llms.txt) - [OpenAPI document](https://skmtc.dev/2c2p/apis/inquiry/revisions/0f0470d4ac14?raw)