Skip to content
On this page

Reports

Read the reports from the dashboard's Reports section: GET /reports lists the reports the business can run, and GET /reports/{id} runs one for a period and returns every widget's figures, the same figures as the page. Listing needs reports:read; running a report also needs vehicle-pricing:read and contacts:read, as reports carry costs, profit and customer names.

The Report Object

Generated from the OpenAPI schema. Always matches the live API.

Fields (14)
AttributeTypeRequiredDescriptionExample
idstring-sales-profit
namestring-Sales and Profit
groupstring-Sales
descriptionstring-
sourcestring or null-The rows the report reads: sale, stock, invoice, product, lead, salesman, user, deal, exchange, movement, turn, payment, purchase, debtor, appointment, customer, checkout, website, advert, guidance, commission or opportunity. Null for a report made of sections of other reports.sale
default_periodstring-this_month
default_basisstring or null-invoice_date
basesobject-The date bases the report can switch between, keyed by basis with a label; empty when the report counts on one date. Accrual reports count on the invoice date by default; cash reports on the payment date.
filtersobject-The filters the report accepts besides the period: primary (on the report bar) and advanced (under More filters). Values are user, sale_type, branch, product_category, supplier, body and fuel; any other is refused.
filters.primaryarray of string-
filters.advancedarray of string-
comparisonboolean-Whether the report compares the period with the one before.
add_onstring or null-The permission a chargeable report needs on the plan (limit_branch, from the Branch add-on), or null.limit_branch
widgetsarray of object-
Example object
{
    "id": "sales-profit",
    "name": "Sales and Profit",
    "group": "Sales",
    "description": "",
    "source": "sale",
    "default_period": "this_month",
    "default_basis": "invoice_date",
    "bases": {},
    "filters": {
        "primary": [
            "user"
        ],
        "advanced": [
            "user"
        ]
    },
    "comparison": false,
    "add_on": "limit_branch",
    "widgets": [
        {
            "id": "headline",
            "type": "kpi",
            "title": "",
            "metrics": [
                {
                    "key": "net_profit",
                    "label": "Net Profit",
                    "format": "",
                    "with": {
                        "key": "net_profit_percentage",
                        "label": "",
                        "format": ""
                    }
                }
            ],
            "dimension": "",
            "columns": [
                {
                    "key": "",
                    "label": "",
                    "format": ""
                }
            ]
        }
    ]
}

Endpoints

GET List Reports

GET /2.0/reports · scope reports:read

List the reports the business can run: id, name, group, source, default period and basis, the date bases and filters each accepts, and the widgets each draws. The meta block lists the period presets.

Parameters (1)
ParameterInTypeRequiredDescriptionExample
fieldsquerystring-Comma-separated dot-paths to return only those fields, e.g. id,data.stock.price_channel.
Responses
StatusDescription
200 OKList Reports

Failures use the standard error responses (4xx/5xx) with the shared error envelope.

{
    "success": true,
    "data": [
        {
            "id": "sales-profit",
            "name": "Sales and Profit",
            "group": "Sales",
            "description": "",
            "source": "sale",
            "default_period": "this_month",
            "default_basis": "invoice_date",
            "bases": {},
            "filters": {
                "primary": [
                    "user"
                ],
                "advanced": [
                    "user"
                ]
            },
            "comparison": false,
            "add_on": "limit_branch",
            "widgets": [
                {
                    "id": "headline",
                    "type": "kpi",
                    "title": "",
                    "metrics": [
                        {
                            "key": "net_profit",
                            "label": "Net Profit",
                            "format": "",
                            "with": {
                                "key": "net_profit_percentage",
                                "label": "",
                                "format": ""
                            }
                        }
                    ],
                    "dimension": "",
                    "columns": [
                        {
                            "key": "",
                            "label": "",
                            "format": ""
                        }
                    ]
                }
            ]
        }
    ]
}

GET Run Report

GET /2.0/reports/{id} · scope reports:read

Run one report for a period and return every widget's figures, the same figures as the page. Needs vehicle-pricing:read and contacts:read as well as reports:read, as a report carries costs, profit and customer names. Query: period (a preset, default the report's own; custom needs from and to as YYYY-MM-DD, to on or after from and at most five years later; a report that looks ahead, Opportunities, takes next_30_days, next_60_days or next_90_days instead), basis (only on a report whose bases list more than one date; accrual reports default to the invoice date), and the filters the report lists under filters: user (a staff user id), sale_type (margin, vat or no_vat), branch (a branch id, with a Branch add-on on the plan), product_category (a product reporting category id, or none for Uncategorised), supplier (the contact id of a supplier), body and fuel (as the vehicle records them). A filter the report does not list is refused.

Parameters (13)
ParameterInTypeRequiredDescriptionExample
idpathstringYesResource identifier in the path.
periodquerystring-A period preset; the report's own when left out. custom needs from and to. A report that looks ahead, Opportunities, takes next_30_days, next_60_days or next_90_days and no other.
fromquerystring (date)-The first day of a custom period, YYYY-MM-DD.
toquerystring (date)-The last day of a custom period, YYYY-MM-DD.
basisqueryenum-The date the report counts on, one of the report's bases. Accepted only where the report lists more than one: accrual reports default to the invoice date and switch to the paid or sold date; cash reports count on the payment date and take none.
userqueryinteger-A staff user id: the sales, enquiries or bookings that name the user. Only on the reports whose filters list user.
sale_typequeryenum-margin, vat or no_vat on every report whose filters list sale_type; aftersale and no_vehicle as well on the reports over invoices and product lines, and reservation on those over product lines.
branchqueryinteger-A branch id, with a Branch add-on on the plan. Only on the reports whose filters list branch.
product_categoryquerystring-A product reporting category id of the business, or none for Uncategorised. Only on the reports whose filters list product_category.
supplierqueryinteger-The contact id of a supplier on the business's purchase invoices. Only on the reports whose filters list supplier.
bodyquerystring-A body type of the business's sold vehicles, as the vehicle records it. Only on the reports whose filters list body.
fuelquerystring-A fuel of the business's sold vehicles, as the vehicle records it. Only on the reports whose filters list fuel.
fieldsquerystring-Comma-separated dot-paths to return only those fields, e.g. id,data.stock.price_channel.
Responses
StatusDescription
200 OKReport run

Failures use the standard error responses (4xx/5xx) with the shared error envelope.

{
    "success": true,
    "data": {
        "id": "sales-profit",
        "name": "Sales and Profit",
        "period": {
            "preset": "last_month",
            "label": "Last month (01/08/2026 to 31/08/2026)",
            "from": "2026-01-01",
            "to": "2026-01-01",
            "days": 0,
            "compare_from": "2026-01-01",
            "compare_to": "2026-01-01",
            "compare_label": ""
        },
        "basis": "invoice_date",
        "filters": {},
        "notes": [
            ""
        ],
        "rows": 0,
        "widgets": [
            {
                "id": "",
                "type": "",
                "title": ""
            }
        ]
    }
}

Build the connected dealership.

Try every feature free for 30 days, with our team on hand to help you switch.

The dealer management system dashboard: the week's diary, activity, revenue to net profit and targets
  • 5.0 Google Reviews
  • 5.0 On Google Play
  • 5.0 App store
  • 5.0 On Capterra
  • EADT Business Awards 2026 - winner, Small Business of the Year Winner
  • AWS Well-Architected Awards 2024 - winner, Most Improved Architecture Winner
  • UK Business Tech Awards 2026 - finalist, SaaS Company of the Year Finalist
  • Motor Trader Independent Dealer Awards 2026 - finalist, IT Innovation of the Year Finalist
  • Motor Trader Commercial Industry Awards 2026 - finalist, IT Innovation of the Year Finalist
  • Motor Trader Independent Dealer Awards 2025 - finalist, IT Innovation of the Year Finalist
  • Motor Trader Independent Dealer Awards 2024 - finalist, IT Innovation of the Year Finalist
Call us 01473 598 100