Skip to main content
All export endpoints return a text/csv file attachment. The response Content-Disposition header is set to attachment; filename=data.csv, which causes browsers to trigger a file download.
Export endpoints return all matching records without a hard page limit. For large date ranges, consider narrowing the range or filtering by type to keep file sizes manageable.

​
Download merchant transactions

Export all transactions for your merchant account as a CSV file. 
GET https://api.tagpay.ng/v1/transaction/download/merchant

​
Query parameters

​
type
string
default:"ALL"
Filter by transaction direction: CREDIT, DEBIT, or ALL.
​
category
string
Filter by transaction category, e.g. BANK_TRANSFER.
​
startDate
string
ISO 8601 date string. Includes transactions created on or after the start of this date.
​
endDate
string
ISO 8601 date string. Includes transactions created on or before the end of this date.

​
Response

Returns a 200 OK with Content-Type: text/csv. Records are sorted by createdAt descending. 
curl --request GET \
  --url "https://api.tagpay.ng/v1/transaction/download/merchant?type=DEBIT&startDate=2024-01-01&endDate=2024-03-31" \
  --header "Authorization: Bearer <token>" \
  --output merchant-transactions.csv

id,reference,type,status,amount,fee,vat,total,currency,category,description,createdAt
a1b2c3d4-...,TXN-001,DEBIT,success,500000,1000,75,501075,NGN,BANK_TRANSFER,Transfer to Access Bank,2024-03-15T10:30:00.000Z
b2c3d4e5-...,TXN-002,DEBIT,success,250000,500,37,250537,NGN,BANK_TRANSFER,Transfer to GTBank,2024-03-14T14:20:00.000Z

​
Download customer transactions

Export transaction history for a specific customer as a CSV file. 
GET https://api.tagpay.ng/v1/transaction/download/customer

​
Query parameters

​
customerId
string
required
The ID of the customer whose transactions you want to export. Must belong to your merchant account.
​
startDate
string
ISO 8601 date string for the start of the date range.
​
endDate
string
ISO 8601 date string for the end of the date range.

​
Response

Returns a 200 OK with Content-Type: text/csv. Records are sorted by createdAt descending. 
curl --request GET \
  --url "https://api.tagpay.ng/v1/transaction/download/customer?customerId=cust_abc123&startDate=2024-01-01&endDate=2024-03-31" \
  --header "Authorization: Bearer <token>" \
  --output customer-transactions.csv

id,reference,type,status,amount,fee,vat,total,currency,category,description,createdAt
c3d4e5f6-...,TXN-100,CREDIT,success,100000,0,0,100000,NGN,CUSTOMER_ACCOUNT_FUNDED,Wallet top-up,2024-02-20T08:00:00.000Z
d4e5f6a7-...,TXN-101,DEBIT,success,50000,500,37,50537,NGN,CUSTOMER_BANK_TRANSFER,ATM withdrawal,2024-02-21T12:00:00.000Z

​
Export pending transactions

Export the list of pending transactions awaiting approval as a CSV file. Only transactions at or above your user’s configured approvalLimit are included. 
GET https://api.tagpay.ng/v1/transaction/pending/export

​
Query parameters

​
type
string
default:"ALL"
Filter by direction: CREDIT, DEBIT, or ALL.
​
category
string
Filter by transaction category.
​
page
number
When provided, paginates the export using the perPage value. Omit to export all matching records.
​
perPage
number
default:"20"
Records per page when page is specified.

​
Response

Returns a 200 OK with Content-Type: text/csv. Each row includes the transaction fields plus flattened creator and approvedBy objects.
This endpoint returns a 400 error if no pending transactions match your filters. Check that transactions exist before calling this endpoint from automated scripts.
curl --request GET \
  --url "https://api.tagpay.ng/v1/transaction/pending/export?type=DEBIT" \
  --header "Authorization: Bearer <token>" \
  --output pending-transactions.csv

id,amount,type,status,category,createdAt,updatedAt
c3d4e5f6-...,10000000,DEBIT,PENDING,BANK_TRANSFER,2024-04-02T08:15:00.000Z,2024-04-02T08:15:00.000Z

​
Export batch transactions

Export the list of batch transactions as a CSV file. 
GET https://api.tagpay.ng/v1/transaction/batch/export

​
Query parameters

​
type
string
default:"ALL"
Filter by direction: CREDIT, DEBIT, or ALL.
​
category
string
Filter by transaction category.
​
search
string
Filter by batch reference string.
​
page
number
When provided, paginates the export. Omit to export all matching records.
​
perPage
number
default:"20"
Records per page when page is specified.

​
Response

Returns a 200 OK with Content-Type: text/csv. Each row represents a batch record. Internal columns mode and merchantId are excluded. 
curl --request GET \
  --url "https://api.tagpay.ng/v1/transaction/batch/export?type=DEBIT&startDate=2024-01-01" \
  --header "Authorization: Bearer <token>" \
  --output batch-transactions.csv

id,reference,type,status,totalAmount,totalCount,category,createdAt,updatedAt
d4e5f6a7-...,BATCH-001,DEBIT,success,5000000,10,BATCH_BANK_TRANSFER,2024-04-01T14:00:00.000Z,2024-04-01T14:05:30.000Z

​
CSV format notes

  • All CSV files use comma delimiters with a header row.
  • Monetary amounts are returned in the smallest currency unit (kobo for NGN). Divide by 100 to get the naira value.
  • Timestamps follow ISO 8601 format in UTC.
  • Date range filters are inclusive: startDate is treated as the start of that calendar day and endDate as the end of that calendar day.
  • There is no enforced date range limit on export endpoints, but requests spanning more than 90 days may be slow on large accounts. Prefer narrower ranges for automated reconciliation jobs.