The Report Object

Represents a generated report for payments, transactions, reconciliation, or settlements.

The Report object represents an asynchronous report generation request. Reports are created with filters and parameters, processed in the background, and made available for download once complete. Use reports for reconciliation, accounting, and operational analysis.

Asynchronous processing. Reports are generated asynchronously. After creating a report, poll the Get Report endpoint until status transitions to SUCCEEDED, then use the download_url to retrieve the file. Large reports may take several minutes to process.

Report Types

Yuno supports eleven report types, each designed for a specific reconciliation or analysis use case:

Type	Description	Typical Use Case
PAYMENT	Payment-level summary including status, amounts, and metadata	Daily sales reconciliation, merchant dashboards
TRANSACTION	Transaction-level detail including provider responses and retry attempts	Debugging declines, provider performance analysis
TRANSACTION_RECONCILIATION	Matches Yuno transactions against provider settlement records	Finance reconciliation, dispute resolution
SETTLEMENT	Provider settlement batches with net amounts and fees	Accounting, cash flow management
COMMUNICATIONS	Webhook and notification delivery logs	Debugging webhook failures, delivery monitoring
FRAUD_TRANSACTIONS	Fraud screening results and risk assessment data	Fraud analysis, risk rule tuning
PAYOUTS	Payout transaction data including beneficiary and withdrawal details	Payout reconciliation, beneficiary audits
FEES	Processing fees charged per transaction	Cost analysis, provider fee comparison
AGENDA	Schedule of expected future settlements and receivables	Cash flow forecasting, receivables planning
SALES_CONCILIATION	Matches sales records with provider confirmations	Sales vs. provider reconciliation
ADVANCEMENTS	Early receipt of future receivables from providers	Advancement tracking, fee analysis

See Reports Fields for the complete column reference for each report type.

Object Fields

id · string

The unique identifier of the report (UUID).

Example: rpt_e1f2a3b4-c5d6-7890-ef12-3456789abcde

type · string

The report type, determining the data schema and available columns.

Values: PAYMENT, TRANSACTION, TRANSACTION_RECONCILIATION, SETTLEMENT, COMMUNICATIONS, FRAUD_TRANSACTIONS, PAYOUTS, FEES, AGENDA, SALES_CONCILIATION, ADVANCEMENTS

Example: TRANSACTION

status · string

Current report generation status.

Values: PROCESSING, SUCCEEDED, FAILED

• PROCESSING. Report is being generated. Poll until status changes.
• SUCCEEDED. Report is ready for download via download_url.
• FAILED. Generation failed (invalid filters, internal error). Check date_range and filters for issues.

Example: SUCCEEDED

date_range · object

The time window for data included in the report.

Show date_range

from · string

Start of the date range (ISO 8601, inclusive).

Example: 2026-03-01T00:00:00.000Z

to · string

End of the date range (ISO 8601, exclusive).

Example: 2026-03-10T00:00:00.000Z

filters · object

Optional filters applied to narrow the report data. Available filters vary by report type.

Show filters

payment_status · array

Filter by payment statuses. Applicable to PAYMENT and TRANSACTION types.

Example: ["SUCCEEDED", "REFUNDED"]

currency · array

Filter by ISO 4217 currency codes.

Example: ["USD", "EUR"]

country · array

Filter by ISO 3166-1 alpha-2 country codes.

Example: ["US"]

payment_method_type · array

Filter by payment method types.

Example: ["CARD", "BANK_TRANSFER"]

provider · array

Filter by provider names.

Example: ["ADYEN", "STRIPE"]

merchant_order_id · string

Filter by a specific merchant order identifier.

Example: order-20260301-001

columns · array

The columns included in the report output. If not specified at creation, all available columns for the report type are included.

Example: ["payment_id", "status", "amount", "currency", "provider", "created_at"]

download_url · string

Pre-signed URL to download the report file. Only present when status is SUCCEEDED. The URL expires after 24 hours.

Example: https://reports.y.uno/downloads/rpt_e1f2a3b4-c5d6-7890-ef12-3456789abcde.csv?token=eyJ...

format · string

The file format of the generated report.

Values: CSV, ZIP

• CSV. Single CSV file. Best for smaller reports.
• ZIP. Compressed archive containing the CSV. Used automatically for large reports.

Example: CSV

created_at · string

ISO 8601 timestamp of when the report was requested.

Example: 2026-03-10T09:00:00.000Z

Example

{
  "id": "rpt_e1f2a3b4-c5d6-7890-ef12-3456789abcde",
  "type": "TRANSACTION",
  "status": "SUCCEEDED",
  "date_range": {
    "from": "2026-03-01T00:00:00.000Z",
    "to": "2026-03-10T00:00:00.000Z"
  },
  "filters": {
    "payment_status": ["SUCCEEDED", "REFUNDED"],
    "currency": ["USD"],
    "country": ["US"],
    "payment_method_type": ["CARD", "BANK_TRANSFER"],
    "provider": null,
    "merchant_order_id": null
  },
  "columns": [
    "payment_id",
    "transaction_id",
    "type",
    "status",
    "amount",
    "currency",
    "provider",
    "response_code",
    "created_at"
  ],
  "download_url": "https://reports.y.uno/downloads/rpt_e1f2a3b4-c5d6-7890-ef12-3456789abcde.csv?token=eyJ...",
  "format": "CSV",
  "created_at": "2026-03-10T09:00:00.000Z"
}

Related Endpoints

• Create Report. POST /v1/reports
• Get Report. GET /v1/reports/{report_id}
• List Reports. GET /v1/reports
• Download Report. GET /v1/reports/{report_id}/download

Related Concepts

• Reports. How to generate and use reports in Yuno