> ## Documentation Index
> Fetch the complete documentation index at: https://developer.gcashier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction History

> Query historical account ledger entries by time range, order number, currency, or transaction type.

```
POST https://{baseUrl}/api/sp2404
```

### Request Parameters

<ParamField body="beginDate" type="number">
  Unix timestamp in milliseconds (13-digit). Start of the query range, inclusive.
</ParamField>

<ParamField body="endDate" type="number">
  Unix timestamp in milliseconds (13-digit). End of the query range, inclusive.
</ParamField>

<ParamField body="batchNo" type="string">
  Unique ledger order number generated by Starlink Pay.
</ParamField>

<ParamField body="currency" type="string">
  ISO 4217 3-letter currency code to filter results (e.g. `USD`).
</ParamField>

<ParamField body="flowType" type="string">
  Fund flow direction:

  * `1` — Credit (incoming)
  * `2` — Debit (outgoing)
</ParamField>

<ParamField body="busiType" type="string">
  Transaction type code. See [Transaction Type Codes](/api/reference/enums).
</ParamField>

<ParamField body="pageNum" type="integer">
  Page number to retrieve (1-based).
</ParamField>

<ParamField body="pageSize" type="integer">
  Number of records per page. Maximum `100`.
</ParamField>

### Response Body

<ResponseField name="pageNum" type="integer" required>
  Current page number.
</ResponseField>

<ResponseField name="pageSize" type="integer" required>
  Number of records returned per page.
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of matching records.
</ResponseField>

<ResponseField name="list" type="object[]" required>
  List of ledger entries.

  <Expandable title="CurFlowRes properties">
    <ResponseField name="batchNo" type="string" required>
      Unique ledger order number for this entry.
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      ISO 4217 3-letter currency code for this entry (e.g. `USD`).
    </ResponseField>

    <ResponseField name="busiType" type="string" required>
      Transaction type code. See [Transaction Type Codes](/api/reference/enums).
    </ResponseField>

    <ResponseField name="inAmount" type="number" required>
      Credit amount. `null` if this entry is a debit.
    </ResponseField>

    <ResponseField name="outAmount" type="number" required>
      Debit amount. `null` if this entry is a credit.
    </ResponseField>

    <ResponseField name="vailAmount" type="number" required>
      Available account balance after this transaction.
    </ResponseField>

    <ResponseField name="busiDate" type="string" required>
      Transaction timestamp (`YYYY-MM-DD HH:mm:ss`).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "beginDate": 1740313108000,
    "endDate": 1740313110000,
    "batchNo": "70735022320182900086",
    "currency": "USD",
    "flowType": "2",
    "busiType": "C00",
    "pageNum": 1,
    "pageSize": 10
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "pageNum": 1,
    "pageSize": 10,
    "total": 9668,
    "list": [
      {
        "currency": "USD",
        "busiType": "C11",
        "busiDate": "2020-05-28 19:32:14",
        "inAmount": null,
        "outAmount": 7.0000,
        "vailAmount": 5572.3100,
        "batchNo": "41200528653124170019"
      },
      {
        "currency": "USD",
        "busiType": "C07",
        "busiDate": "2020-05-27 17:52:56",
        "inAmount": null,
        "outAmount": 2218.0000,
        "vailAmount": 5628.3100,
        "batchNo": "41200527728820950004"
      }
    ]
  }
  ```
</ResponseExample>