APG PayAPG Paydocs

Reporting

Create reports

POST/reports

Run a report. The answer is the report, nothing is stored, so keep it. Each report is authorised as the collection it reports on is.

4 actionsRprtCmdPayoutRprtCmdRefundsRprtCmdSettlementRprtCmdTransactions

Permissions

Required permission

Required action depends on the request variant. Select a variant in the request body below to see the permission it requires.

Request body

This body is a typed union. Pick a variant to see its fields, the permission it requires, and a matching example.

Discriminated by type
type = "RprtCmdPayout"
Required permission
merchantFinancials:query

Report, and email, one payout

merchantIdMchtId

The payout's merchant. Omit it, the payout names it.

Example mcht_9f2Kd8QpLzXw

payoutIdPayoutIdrequired

Identifier of a payout.

Example payout_9f2Kd8QpLzXw

emailToarray of string

Also email the report to these addresses. The platform does not report send failures.

Example ada@example.com

includeSettlementReportboolean

Attach the settlement report to that email as well. Only meaningful with emailTo.

Example true

curl -X POST https://api.tst.au.apgpay.dev/reports \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "RprtCmdPayout",
  "merchantId": "mcht_9f2Kd8QpLzXw",
  "payoutId": "payout_9f2Kd8QpLzXw",
  "emailTo": [
    "ada@example.com"
  ],
  "includeSettlementReport": true
}'

Responses

The response is a tagged shape: type is always "RprtCreateRspAttributes". Switch on it; subtypes can be added, and a client that already reads it will not break.

Discriminated by type
type = "RprtCreateRspAttributes"

The resource that was created.

Example
{
  "type": "RprtCreateRspAttributes",
  "created": {
    "type": "RprtViewPayout",
    "merchantId": "mcht_9f2Kd8QpLzXw",
    "payoutId": "payout_9f2Kd8QpLzXw",
    "facilitation": "string",
    "amounts": {
      "type": "RprtPayoutAmountsAttributes",
      "currency": "AUD",
      "payout": 1250,
      "gross": 1250,
      "net": 1250,
      "feesInclTax": 1250,
      "feesTax": 1250
    },
    "createdAt": "2026-08-19T04:21:07Z",
    "arrivedAt": "2026-08-19T04:21:07Z",
    "emailedTo": [
      "ada@example.com"
    ],
    "rows": [
      {
        "type": "RprtPaymentRowAttributes",
        "direction": "string",
        "transactionId": "tran_9f2Kd8QpLzXw",
        "orderReference": "your-own-reference",
        "paymentType": "string",
        "net": 1250,
        "feeInclTax": 1250,
        "feeTax": 1250,
        "customFields": {
          "yourKey": "string"
        },
        "at": "2026-08-19T04:21:07Z"
      }
    ]
  }
}

Error responses