---
page_title: List Transactions
product: UPI TPAP SDK
platform: React Native
page_source: https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/list-transactions
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt
---


## List Transactions



This api will be used for getting a list of transactions.


###   Process Parameters



## Request Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Value:
    - **Action**:
      - Description: Operation to be performed in the SDK.
      - Value: upiTransactionList
      - Tags: String, Mandatory
    - **Offset**:
      - Description: Offset to be applied on transaction list
      - Value: eg : 0
      - Tags: Int, Mandatory
    - **Limit**:
      - Description: Number of transactions to be fetched at once.
      - Value: eg : 20
      - Tags: Int, Mandatory
    - **MerchantKeyId**:
      - Description: Key ID to identify the public-private key pair used for signature generation.
      - Tags: String, Mandatory
    - **SignaturePayload**:
      - Description: Stingified JSON
      - Value:
        - **Merchant_id**:
          - Description: Unique identifier associated with an account created by juspay. Ex: stock
          - Tags: String, Mandatory
        - **Customer_id**:
          - Description: Any unique reference associated with your customer.
          - Tags: String, Mandatory
        - **Timestamp**:
          - Description: Time when request is created in milliseconds.
          - Tags: String, Mandatory
        - **CustomerMobileNumber**:
          - Tags: String, Optional
      - Tags: String, Mandatory
    - **Signature**:
      - Description: Signature generated for the signaturePayload
      - Value: <signature>
      - Tags: String, Mandatory
    - **Status**:
      - Description: This field specifies the transaction status used for filtering. It can be populated in any way.
      - Value: Example:- ["SUCCESS", "PENDING", "FAILURE"]
      - Tags: Array, Conditional
    - **StartDate**:
      - Description: The start date for filtering transactions. The date is to be passed in “YYYY-MM-DD” format.
      - Value: Example: "2025-07-12"
      - Tags: String, Conditional
    - **EndDate**:
      - Description: The end date for filtering transactions. The date is to be passed in “YYYY-MM-DD” format.
      - Value: Example: "2025-07-15"
      - Tags: String, Conditional
    - **AccountTypes**:
      - Description: Account type used in the transaction to be filtered against.
      - Value: Example:- ["SAVINGS", "CREDIT"]
      - Tags: Array, Conditional
  - Tags: JSON, Mandatory


## Response Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String
- **Payload**:
  - Description: Response Parameters
  - Value:
    - **Action**:
      - Description: Operation performed in the SDK.
      - Value: upiTransactionList
      - Tags: String, Mandatory
    - **Status**:
      - Description: If upiTransactionList was success or failed
      - Value: SUCCESS / FAILURE
      - Tags: String, Mandatory
    - **MerchantId**:
      - Description: Unique merchant id shared during onboarding
      - Value: <merchant_id>
      - Tags: String, Mandatory
    - **MerchantChannelId**:
      - Tags: String, Mandatory
    - **MerchantCustomerId**:
      - Description: Merchant generated unique profile id for customer as passed in the request
      - Tags: String, Mandatory
    - **TxnList**:
      - Description: Array of JSON containing all transaction related data .
      - Value:
        - **Amount**:
          - Description: Amount for which the particular transaction was executed. Numeric String with two decimals
          - Value: eg : 5000
          - Tags: String, Mandatory
        - **GatewayReferenceId**:
          - Tags: String, Mandatory
        - **GatewayResponseCode**:
          - Description: Response Code received from NPCI
          - Tags: String, Mandatory
        - **GatewayTransactionId**:
          - Description: upiRequestId as passed in request
          - Tags: String, Mandatory
        - **PayeeName**:
          - Description: Payee Name
          - Tags: String, Optional
        - **PayeeVpa**:
          - Description: Payee Vpa
          - Tags: String, Mandatory
        - **PayerName**:
          - Description: Payer Name
          - Tags: String, Optional
        - **PayerVpa**:
          - Description: Payer Vpa
          - Tags: String, Optional
        - **Remarks**:
          - Description: Remarks for this transaction
          - Tags: String, Mandatory
        - **TransactionTimestamp**:
          - Description: Time at which this transaction was executed.
          - Tags: String, Mandatory
        - **Type**:
          - Description: Type of transaction.
          - Value: PAY/COLLECT
          - Tags: String, Mandatory
        - **IsP2MTransaction**:
          - Description: If the transaction was P2M transaction or P2P transaction
          - Value: true / false
          - Tags: Boolean, Mandatory
        - **Expiry**:
          - Description: Time after which the transaction would expire
          - Tags: String, Optional
        - **RefUrl**:
          - Tags: String, Optional
        - **RefCategory**:
          - Tags: String, Optional
        - **GatewayResponseMessage**:
          - Description: Response Message received from NPCI
          - Tags: String, Optional
        - **MerchantRequestId**:
          - Description: Merchant generated id for the mandate request.
          - Tags: String, Optional
        - **SelfInitiated**:
          - Description: If this transaction was self initiated or not
          - Tags: String, Optional
      - Tags: Array of JSON, Mandatory
  - Tags: JSON
- **Error**:
  - Description: Possible values :- true/false
  - Tags: Boolean
- **ErrorMessage**:
  - Description: Error Message
  - Tags: String
- **ErrorCode**:
  - Description: Error Code
  - Tags: String
- **Event**:
  - Description: Value: process_result
  - Tags: String





#### Code Snippets: -

#### Java Code Snippet:

```java
{"success":false,"message":"Failed to fetch snippet"}
```

#### Kotlin Code Snippet:

```kotlin
{"success":false,"message":"Failed to fetch snippet"}
```


## Sample Code Snippets:
### Request snippets:

#### Request Code Snippet:

```request
{"success":false,"message":"Failed to fetch snippet"}
```

### Response snippets:

#### Response:
```plaintext
{"success":false,"message":"Failed to fetch snippet"}
```



---

## Complete Code Reference

The following code files are referenced in the steps above:

### InappHeadless2.txt

```
{"success":false,"message":"Failed to fetch snippet"}
```


---

## See Also

- [Mandate transaction List](https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/mandate-transaction-list)
- [Transaction Status](https://juspay.io/in/docs/upi-tpap-sdk/react-native/headless-process-payloads/transaction-status)