Virtual Account Services
  1. Reporting
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
    • Get Invoice Detail
    • List Merchant Invoices
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
      • Set Collection Account
      • Create Group Code
    • Reporting
      • Get Report Types
        GET
      • Get Report Parameters
        GET
      • Create Report
        POST
      • Get Reports
        GET
      • Get Reports Details
        GET
  1. Reporting

Create Report

POST
/admin/reporting
This API operation enables merchants to generate customized reports by specifying report types and associated parameters. It allows for the selection of key data points, such as date ranges, transaction types, and other relevant filters, ensuring precise and meaningful insights. By defining these parameters, merchants can tailor reports to meet their financial tracking and analytical needs, enhancing decision-making and operational efficiency.

Request Body#

Field NameTypeRequiredDescription
namestringYesThe name of the report being generated.
reportTypeIdintegerYesThe unique identifier of the report type.
parametersarrayYesA list of parameters needed for generating the report.
parameterIdintegerYesThe unique identifier of a specific parameter.
valuestringYesThe value associated with the parameter.

Response Body#

Field NameTypeDescription
idintegerThe unique identifier of the generated report.
namestringThe name of the generated report.
reportTypeIdintegerThe unique identifier of the report type.
parametersarrayA list of parameters used in the generated report.
parameterIdintegerThe unique identifier of a specific parameter.
valuestringThe value associated with the parameter.

Request

Body Params application/json

Example
{
    "name":"Test Report 2",
    "reportTypeId":1,
    "parameters":[
        {
            "parameterId":1,
            "value":"2024-01-01"
        },
        {
            "parameterId":2,
            "value":"2024-07-08"
        },
        {
            "parameterId":3,
            "value":"OUTWARD"
        },
        {
            "parameterId":4,
            "value":"ALL"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/admin/reporting' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"Test Report 2",
    "reportTypeId":1,
    "parameters":[
        {
            "parameterId":1,
            "value":"2024-01-01"
        },
        {
            "parameterId":2,
            "value":"2024-07-08"
        },
        {
            "parameterId":3,
            "value":"OUTWARD"
        },
        {
            "parameterId":4,
            "value":"ALL"
        }
    ]
}'

Responses

🟢200Create Report [All Merchants]
application/json
Body

Example
{
    "id": 1,
    "name": "Test Report",
    "reportTypeId": 1,
    "parameters": [
        {
            "parameterId": 1,
            "value": "2024-01-01"
        },
        {
            "parameterId": 2,
            "value": "2024-07-08"
        },
        {
            "parameterId": 3,
            "value": "ALL"
        },
        {
            "parameterId": 4,
            "value": "ALL"
        },
        {
            "parameterId": 5,
            "value": "26"
        }
    ]
}
🟢200Create Report [Selected Merchants]
🟠400Create Report [Single Error]
🟠400Create Report [Multiple Errors]
Modified at 2025-03-02 15:36:10
Previous
Get Report Parameters
Next
Get Reports
Built with