Insights

Network insights

The supply-chain network graph: supplier, location and sales-channel nodes, and the purchase-order, transfer-order and sales-order flows between them.

Base URL: https://api.miridia.io. Read Authentication and Conventions before you call these operations.

Method	Path	Operation
GET	`/api/v1/insights/network`	Get network insight

Get network insight

GET/api/v1/insights/network

Returns the network graph for the business over the period. Defaults to the current calendar month when from/to are not supplied.

Access. Send a bearer token or an API key. The caller needs the Insights view permission.

Parameters

Name	In	Type	Required	Description
`from`	query	`string (date-time)`	No
`to`	query	`string (date-time)`	No

Response

200. Returns a SingleResult envelope. The data field is NetworkInsightResponse.

Request

curl -X GET "https://api.miridia.io/api/v1/insights/network" \
  -H "Authorization: Bearer $MIRIDIA_TOKEN" \
  -H "X-Business-Id: $MIRIDIA_BUSINESS_ID"

Response

{
  "message": "string",
  "messages": [
    {
      "title": "string",
      "message": "string",
      "level": "Standard",
      "icon": "SyncAlert",
      "code": "string"
    }
  ],
  "data": {
    "periodFrom": "2026-09-29T08:00:00Z",
    "periodTo": "2026-09-29T08:00:00Z",
    "currency": "string",
    "nodes": [
      {}
    ],
    "edges": [
      {}
    ],
    "totals": {
      "suppliers": 0,
      "locations": 0,
      "storefronts": 0,
      "warehouses": 0,
      "channels": 0,
      "purchaseSpend": 0,
      "salesRevenue": 0
    }
  },
  "statusCode": "OK",
  "canRead": true,
  "canEdit": true,
  "canDelete": true
}

Models

The operations on this page use these object types. Select a type to see its fields.

NetworkEdgeResponse

One edge in the supply-chain network graph: a flow of purchase orders, transfer orders, or sales orders between two nodes over a period.

Field	Type	Description
`id`	`string`
`sourceId`	`string (uuid)`
`targetId`	`string (uuid)`
`kind`	`enum NetworkEdgeKind`	One of: `PurchaseOrder`, `TransferOrder`, `SalesOrder`.
`count`	`integer (int32)`
`value`	`number (double)`
`inTransitCount`	`integer (int32)`	The count of orders on this edge that are still in transit. Zero for a sales edge.
`inTransitValue`	`number (double)`	The value of orders on this edge that are still in transit. Zero for a sales edge.

NetworkInsightResponse

The supply-chain network graph for a business over a period: every supplier, location and sales-channel node, plus the purchase-order, transfer-order and sales-order edges between them.

Field	Type	Description
`periodFrom`	`string (date-time)`
`periodTo`	`string (date-time)`
`currency`	`string`	The most common sale currency in the period. Null with no sales.
`nodes`	`NetworkNodeResponse[]`
`edges`	`NetworkEdgeResponse[]`
`totals`	`NetworkTotalsResponse`

NetworkNodeResponse

One node in the supply-chain network graph: a supplier, a location, or a sales channel.

Field	Type	Description
`id`	`string (uuid)`
`kind`	`enum NetworkNodeKind`	One of: `Supplier`, `Location`, `Channel`.
`title`	`string`
`locationType`	`enum BusinessLocationType`	One of: `Office`, `Warehouse`, `Storefront`, `Remote`, `Other`, `Headquarters`, `Factory`.
`channelKind`	`enum SalesChannelKind`	One of: `Direct`, `PointOfSale`, `Online`, `Marketplace`.
`latitude`	`number (double)`	Set for a supplier node and a location node. Null when the address is missing.
`longitude`	`number (double)`	Set for a supplier node and a location node. Null when the address is missing.
`country`	`string`	Set only for a `Supplier` node with an address.

NetworkTotalsResponse

Summary counts and monetary totals for the supply-chain network graph over a period.

Field	Type	Description
`suppliers`	`integer (int32)`
`locations`	`integer (int32)`
`storefronts`	`integer (int32)`
`warehouses`	`integer (int32)`
`channels`	`integer (int32)`
`purchaseSpend`	`number (double)`
`salesRevenue`	`number (double)`

Supplier insights

Aggregated purchase-order performance metrics for suppliers.

AI Studio

The ai studio operations of the Core API.