Skip to main content
GET
/
business
/
transaction
List transactions
curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/transaction \
  --header 'X-Numero-Api-Key: <api-key>'
{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "transactions": [
      {
        "trxAmount": 50000,
        "trxFee": 25,
        "settledAmount": 50000,
        "merchant": "Your Business Name",
        "businessCode": "BUS001",
        "reference": "TRF-20240115-abc123",
        "sessionId": "session123",
        "vendorReference": "vendor_ref_001",
        "type": "Transfer",
        "status": "Successful",
        "channel": "API",
        "postingType": "Debit",
        "description": "Salary payment",
        "service": "SingleTransfer",
        "requestState": "Completed",
        "requestStateDetails": "Transfer completed successfully",
        "currency": "NGN",
        "dateCreated": "2024-01-15T10:30:00Z",
        "dateModified": "2024-01-15T10:31:00Z",
        "beneficiaryBank": "GT Bank",
        "beneficiaryName": "John Doe",
        "beneficiaryNumber": "0123456789",
        "stampDutyApplied": true,
        "stampDutyAmount": 50
      }
    ],
    "pageNumber": 1,
    "pageSize": 20,
    "totalCount": 150
  },
  "error": null
}

Authorizations

​
X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Query Parameters

​
startDate
string<date-time>
​
endDate
string<date-time>
​
searchBy
string
​
pageNumber
integer
default:1
Required range: x >= 1
​
pageSize
integer
default:50
Required range: 1 <= x <= 200

Response

Successful response

Canonical response envelope for the public surface. data on success, error on failure.

​
data
any
required

Endpoint payload on success (object or array); null on failure.

​
error
object
required
​
meta
object
required