API DocumentationManufacturer analytics controller

Get dashboard analytics

GET
/api/manufacturer/v1/analytics/dashboard

Returns the manufacturer analytics dashboard in one call, including revenue, funnel, production, customer and material insights. Use this endpoint for reporting dashboards and external BI syncs that need the same aggregates shown in the manufacturer app. The response is scoped to the authenticated operator. Supply a period preset or an explicit from/to range, which wins over period. Aggregation is computed at the database level. Revenue totals, top-customer revenue and customer value use non-voided ORDER-state orders and exclude REFUNDED payments. Paid means PAID; confirmed means UNPAID, PROCESSING or EXTERNALLY_TRACKED, regardless of invoice or PO payment method; outstanding means UNPAID or PROCESSING and excludes EXTERNALLY_TRACKED. Revenue total is paid + confirmed, counting each eligible order once; outstanding is a subset of confirmed and is not added again. These amounts use gross order total, including shipping and tax, grouped by order currency without FX conversion. The date basis is order.createdAt, not payment or invoice date, from the start of from (inclusive) to the start of the day after to (exclusive). Payment-behaviour outstanding uses the same ORDER-state, status, gross and order-currency bases but is a current balance across all creation dates, without a reporting-window filter. The funnel section returns three stage lists over the quotes-created-in-window cohort - acquisition (visits -> sign-ups -> first order), quoteToOrder (quote opened -> accepted -> order created) and fulfillment (order created -> production started -> production completed -> order completed) - each stage carrying drop-off counts/conversions and median/p95 days from the previous stage, so you can see where flow is lost and where it slows down. Transition times come from the audit trail, so later edits do not rewrite history; order completion is a kanban state and is reported count-only.

Authorization

Phasio API Bearer Token
headerAuthorizationBearer <token>

Query Parameters

period?string

Preset reporting window. Defaults to last_30_days when omitted. Ignored when both from and to are supplied.

Value in"today""last_7_days""last_30_days""last_90_days""this_month""last_month""this_year""last_year""all_time"
from?string

Explicit reporting window start date in yyyy-MM-dd format. Together with to, overrides period.

Formatdate
to?string

Explicit reporting window end date in yyyy-MM-dd format, inclusive. Together with from, overrides period.

Formatdate
granularity?string

Time-series bucket granularity. Auto-derived from the requested window when omitted.

Value in"day""week""month"
sections?string

Dashboard sections to compute. Repeat the query parameter for multiple sections, e.g. sections=revenue&sections=funnel. All sections are returned when omitted.

Value in"revenue""funnel""production""customers""materials"
customerType?string

Optional dimension filter by customer type.

Value in"PRO_FORMA""ACCOUNT""INTERNAL"
source?string

Optional dimension filter by order source.

Value in"INBOUND""OUTBOUND"
compare?boolean

When true, include a compact previous block (equal-length prior window) of KPI scalars for period-over-period deltas. Ignored for all_time.

Defaultfalse
includeArchived?boolean

When true, include archived orders in every count/sum. Defaults to false so the dashboard reflects only live, active orders.

Defaultfalse

Response Body

Dashboard analytics retrieved successfully

application/json
  1. response

Consolidated manufacturer analytics dashboard for a requested reporting window.

range*

Resolved reporting window and primary currency metadata.

previous?

Prior equal-length window totals. Present only when compare=true and the selected period supports comparison.

revenue?

Revenue totals, bucketed revenue and order counts by payment status. Present when the revenue section is requested.

funnel?

Quote, order, acquisition and fulfillment funnel metrics. Present when the funnel section is requested.

production?

Production throughput, work-in-progress, cycle time, scrap and kanban metrics. Present when the production section is requested and the operator subscribes to the FACTORY_FLOOR module; null otherwise.

customers?

Customer acquisition, revenue, retention, geography, payment and cart-conversion metrics. Present when the customers section is requested.

materials?

Material, technology, post-processing and material scrap metrics. Present when the materials section is requested and the operator subscribes to the PRO module; null otherwise.

curl -X GET 'https://m-api.eu.phas.io/api/manufacturer/v1/analytics/dashboard?period=last_30_days&from=2026-01-01&to=2026-01-31&granularity=day&sections=revenue&customerType=ACCOUNT&source=INBOUND'
{  "range": {    "period": "string",    "from": "2019-08-24",    "to": "2019-08-24",    "granularity": "day",    "primaryCurrency": "string"  },  "previous": {    "from": "2019-08-24",    "to": "2019-08-24",    "revenue": {      "paid": 0,      "confirmed": 0,      "outstanding": 0,      "orders": 0    },    "funnel": {      "conversion": 0.1,      "completionRate": 0.1,      "medianDaysToCompletion": 0.1    },    "customers": {      "new": 0,      "payingCustomers": 0,      "avgOrderValue": 0,      "repeatRate": 0.1    },    "production": {      "openRequisitions": 0,      "avgLeadTimeDays": 0.1,      "onTimePct": 0.1,      "scrapRate": 0.1    }  },  "revenue": {    "byCurrency": [      {        "currency": "string",        "total": 0,        "paid": 0,        "confirmed": 0,        "outstanding": 0,        "orders": 0      }    ],    "byBucket": [      {        "bucket": "2019-08-24",        "currency": "string",        "paid": 0,        "confirmed": 0,        "orders": 0      }    ],    "byPaymentStatus": {      "property1": 0,      "property2": 0    }  },  "funnel": {    "quotesGenerated": 0,    "ordersCreated": 0,    "accepted": 0,    "confirmed": 0,    "paid": 0,    "conversion": 0.1,    "acquisition": [      {        "stage": "string",        "label": "string",        "count": 0,        "dropOff": 0,        "conversionFromPrevious": 0.1,        "conversionFromStart": 0.1,        "medianDaysFromPrevious": 0.1,        "p95DaysFromPrevious": 0.1      }    ],    "quoteToOrder": [      {        "stage": "string",        "label": "string",        "count": 0,        "dropOff": 0,        "conversionFromPrevious": 0.1,        "conversionFromStart": 0.1,        "medianDaysFromPrevious": 0.1,        "p95DaysFromPrevious": 0.1      }    ],    "quoteToOrderInbound": [      {        "stage": "string",        "label": "string",        "count": 0,        "dropOff": 0,        "conversionFromPrevious": 0.1,        "conversionFromStart": 0.1,        "medianDaysFromPrevious": 0.1,        "p95DaysFromPrevious": 0.1      }    ],    "quoteToOrderOutbound": [      {        "stage": "string",        "label": "string",        "count": 0,        "dropOff": 0,        "conversionFromPrevious": 0.1,        "conversionFromStart": 0.1,        "medianDaysFromPrevious": 0.1,        "p95DaysFromPrevious": 0.1      }    ],    "fulfillment": [      {        "stage": "string",        "label": "string",        "count": 0,        "dropOff": 0,        "conversionFromPrevious": 0.1,        "conversionFromStart": 0.1,        "medianDaysFromPrevious": 0.1,        "p95DaysFromPrevious": 0.1      }    ]  },  "production": {    "openRequisitions": 0,    "avgLeadTimeDays": 0.1,    "onTimePct": 0.1,    "throughput": [      {        "operation": "string",        "bucket": "2019-08-24",        "quantity": 0      }    ],    "wip": [      {        "operation": "string",        "count": 0      }    ],    "cycleTime": [      {        "operation": "string",        "avgDays": 0.1,        "p95Days": 0.1,        "samples": 0      }    ],    "scrap": {      "scrappedUnits": 0,      "producedUnits": 0,      "scrapRate": 0.1,      "byOperation": [        {          "operation": "string",          "scrappedUnits": 0        }      ]    },    "kanban": [      {        "name": "string",        "sequence": 0,        "count": 0      }    ]  },  "customers": {    "new": 0,    "byType": {      "property1": 0,      "property2": 0    },    "topByRevenue": [      {        "customerOrganisationId": 0,        "name": "string",        "currency": "string",        "paid": 0,        "confirmed": 0      }    ],    "value": [      {        "currency": "string",        "totalPaid": 0,        "totalConfirmed": 0,        "payingCustomers": 0,        "orders": 0,        "avgOrderValue": 0,        "avgLifetimeValue": 0      }    ],    "retention": {      "customersWithOrders": 0,      "repeatCustomers": 0,      "repeatRate": 0.1,      "atRiskCustomers": 0,      "churnedCustomers": 0,      "atRiskThresholdDays": 0    },    "acquisition": [      {        "source": "string",        "customers": 0,        "paid": 0,        "confirmed": 0      }    ],    "geography": [      {        "country": "string",        "orders": 0,        "paid": 0,        "confirmed": 0      }    ],    "paymentBehaviour": [      {        "currency": "string",        "daysSalesOutstanding": 0.1,        "latePaymentRate": 0.1,        "outstanding": 0,        "paidOrders": 0,        "confirmedOrders": 0      }    ],    "cartConversion": {      "carts": 0,      "converted": 0,      "abandoned": 0,      "conversionRate": 0.1    },    "discountUsage": {      "ordersWithDiscount": 0,      "totalOrders": 0,      "usageRate": 0.1,      "avgDiscountPercentage": 0.1    }  },  "materials": {    "topMaterials": [      {        "materialId": 0,        "name": "string",        "requisitions": 0,        "quantity": 0,        "estimatedVolume": 0      }    ],    "topTechnologies": [      {        "technology": "string",        "requisitions": 0,        "quantity": 0,        "estimatedVolume": 0      }    ],    "materialProcessMatrix": [      {        "material": "string",        "technology": "string",        "requisitions": 0,        "revenue": 0      }    ],    "postProcessing": [      {        "name": "string",        "count": 0      }    ],    "scrapByMaterial": [      {        "material": "string",        "scrappedUnits": 0      }    ]  }}