Skip to navigation

Reports

Reports are files with the row-level records behind your billing: invoices, invoice lines and taxes, the events billed on an invoice, unmatched and duplicate events, prices and overrides, subscriptions, payments and the revenue recognition schedule. Use them for month-end close, reconciliation, tax returns and audits, or to load billing data into a spreadsheet or BI tool. Where Insights shows aggregated figures, a report gives you every row behind them.


Available reports

Every report type has a report_code, which you use to request it through the API.

Invoice data

Reportreport_codeOne row perUse it for
Invoice headersINVOICE_HEADERInvoiceReconciling invoice totals, excluding tax, tax and paid status with your ledger
Invoice linesINVOICE_LINEProduct line on an invoice, with its service periodBooking revenue per product and period
Invoice taxesINVOICE_TAXProduct line and tax categoryVAT and GST returns
InvoicesINVOICEInvoice line, with customer, pricing plan, product, tax, tier and exchange-rate detailsA wide export for your own BI tool or spreadsheet
Invoice commitmentsINVOICE_COMMITMENTMinimum-commitment line on an invoiceSeeing which customers were billed a commitment true-up
E-invoicingE_INVOICINGE-invoiceFollowing up on e-invoices that were rejected or not answered
PaymentsPAYMENTPayment attemptReconciling payments with your payment service provider, and following up on failed payments

Revenue

Reportreport_codeOne row perUse it for
Revenue recognitionREVENUE_RECOGNITIONInvoice line and reporting monthMonth-end revenue journals and the reconciliation of your deferred revenue account

Usage and events

Reportreport_codeOne row perUse it for
Invoice usageINVOICE_USAGEEvent billed on one invoiceTracing an invoice line back to the events behind it
Meter reportMETERINGCombination of meter property values on one invoiceTotals per meter property, for example per merchant or country
Child parent breakdownCHILD_PARENT_BREAKDOWNBilled item per child customer on one parent invoiceRecharging a consolidated invoice to subsidiaries or merchants
Child parent breakdown (platform)CHILD_PARENT_BREAKDOWN_PLATFORMBilled item per child customer, across all invoices in a periodThe same breakdown for every parent at once
Not matched meter dataNOT_MATCHED_METER_DATAEvent that couldn’t be matched to a subscription or priceFinding usage that wasn’t billed; see Unbilled usage
Duplicate meter dataDUPLICATE_METER_DATAEvent rejected as a duplicate of an earlier eventChecking whether events are sent twice

Customers, catalogue and contracts

Reportreport_codeOne row perUse it for
CustomersCUSTOMERCustomerSyncing customer data to a CRM or ERP
ProductsPRODUCTProduct itemAn export of your product catalogue
Pricing plan subscriptionsPRICING_PLAN_SUBSCRIPTIONSubscription and pricing plan scheduleAn overview of every subscription and its billing terms
PricingPRICINGPrice, down to the tier band, including subscription overridesAnswering “what does this customer actually pay for this item?”
ClausesCLAUSESDiscount, markup or commitment on a subscriptionAn overview of every contract term with its validity

Generate a report

Solvimon generates reports asynchronously: you request a report, Solvimon queues and builds it, and you download the file when it is ready. Files are available as CSV, JSON Lines, Parquet or Avro.

Via API

Request the report with its report_code and the parameters it takes:

Request an invoice line report for September
curl -X POST https://test.api.solvimon.com/v1/report-generate-requests \
-H "X-API-KEY: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"report_code": "INVOICE_LINE",
"format": "CSV",
"parameter_values": [
{ "name": "from_date", "value": "2026-09-01T00:00:00Z" },
{ "name": "to_date", "value": "2026-10-01T00:00:00Z" },
{ "name": "statuses", "value": "FINAL" }
]
}'
Response
{
"object_type": "string",
"id": "string",
"customer_id": "string",
"invoice_id": "string",
"generate_at": "2024-01-15T09:30:00Z",
"report_code": "INVOICE",
"parameter_values": [
{
"name": "report_date",
"value": "string"
}
],
"status": "string",
"report_subscription_id": "string",
"report_configuration_id": "string",
"run_type": "string",
"export_location": {
"integration_id": "string",
"variant": "BIGQUERY",
"stream_name": "string",
"bigquery": {
"dataset_id": "string"
},
"s3": {
"bucket_path": "string",
"path_format": "string",
"format_type": "CSV"
},
"gcs": {
"bucket_path": "string",
"path_format": "string",
"format_type": "CSV"
}
},
"format": "CSV"
}

Poll the request with GET /v1/report-generate-requests/{id} until it has finished, then fetch the report it produced and a download link for the file:

Fetch the report and its download link
curl https://test.api.solvimon.com/v1/report-generate-requests/<requestId>/report \
-H "X-API-KEY: <apiKey>"
curl https://test.api.solvimon.com/v1/reports/<reportId>/download-url \
-H "X-API-KEY: <apiKey>"

The parameters a report accepts depend on its type:

ParameterUsed by
from_date, to_dateInvoice and payment reports, revenue recognition, the platform child parent breakdown and e-invoicing
statusesInvoice headers, lines, taxes and the Invoices report: the invoice statuses to include, such as FINAL
updated_to_final_from_date, updated_to_final_to_dateInvoice reports: select invoices by the moment they became final instead of their date
invoice_idReports about one invoice: invoice usage, meter report and child parent breakdown
meter_idMeter report
report_dateMonthly event reports (not matched and duplicate meter data), and as an alternative start date for e-invoicing and the platform child parent breakdown
customer_idNot matched meter data, for one customer

The customers, products, pricing plan subscriptions, pricing and clauses reports take no parameters: they always contain your current full list.

Via Desk

Request reports on the Reporting page in Desk: choose the report, set the period and filters, and download the file once it is ready. Desk lists the reports enabled for your platform; every type can be requested through the API.

Schedules and automatic reports

A report subscription generates a report automatically: on a day of the week, on a day of the month, or each time an invoice becomes final. Subscriptions can also push each file to your own BigQuery, Amazon S3, Google Cloud Storage or Snowflake. Set them up on the Reporting page in Desk, or with POST /v1/report-subscriptions:

Generate a report on the 1st of every month
curl -X POST https://test.api.solvimon.com/v1/report-subscriptions \
-H "X-API-KEY: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"report_configuration_id": "<reportConfigurationId>",
"format": "CSV",
"schedule": { "time_of_day": 6, "day_of_month": 1 },
"active": true,
"parameter_values": [{ "name": "statuses", "value": "FINAL" }]
}'

The report configuration decides which report the subscription generates. List your platform’s configurations with GET /v1/report-configurations.

Solvimon generates the invoice usage report automatically each time a standard invoice becomes final, so it is always available for final invoices.

A report configuration sets which optional columns a report contains for your platform. Changing the columns of a report that a subscription pushes to your warehouse changes the table it writes, so update anything that reads that table at the same time.

Things to know

  • Different reports use different dates. Invoice headers, lines and taxes filter on the billing period date of the invoice, falling back to the invoice date. The Invoices report and the revenue recognition report filter on the invoice date. Two reports for “September” can therefore contain different invoices.
  • Different status defaults. Without a statuses parameter, invoice headers, lines and taxes contain final invoices only. The Invoices report contains every status, including draft and void.
  • Scheduled invoice reports contain your full history. A scheduled run has no date range, so each file contains every invoice to date.
  • Revenue recognition filters on invoice date, not reporting month. To get everything recognised in a quarter, request a wide invoice-date range and filter on the reporting period in the file.
  • Data extraction time. Solvimon builds the customers, products, pricing plan subscriptions, Invoices and revenue recognition reports from its analytics warehouse rather than from live data. Each report records when its data was extracted in data_extracted_at.

To get billing data into your own data warehouse continuously, without requesting files, use data exports. To ask questions about your billing data from an AI assistant instead, use the MCP server.