Configure an Integration API

Use the Integration Screen to select the data source and define the columns, values, and filters for the external API link. Any system with a valid token can POST {} to that link and receive the latest data.

See Integration for best practices when you configure data for external access.

To configure data for external access:

  1. Open the Integration Screen.
  2. Click the Configure Data icon on the right-hand toolbar.

    The Configure Data panel displays.

  3. Select the data Source from:
    • Metrics – Aggregated measures for elements on the mine value chain (for example, Mine Production, Plant Feed, Crusher Received).
    • Movements – Material movement transactions (for example, Haulage, Control Point transactions).
    • Stockpiles – Stockpile balances and adjustments (Opening and Closing balances, Additions and Removals).
  4. Select the fields to group or filter by from the Columns (Dimensions) drop-down list. For example, Site, Area, Material, Equipment, Control Point.

    Note: Include a Date or Shift field so downstream systems can filter by date.

  5. Select the numeric or attribute outputs to include from the Values (Measures) drop-down list. For example, Wet Tonnes, Dry Tonnes, Volume, grades, metals, and attributes.
  6. Click Apply to update the screen's table and keep the Configure Data panel open.
  7. Click Apply & Close to update the screen's table and close the Configure Data panel.
  8. Apply filters at the top of the screen, if required.
    1. To filter by Period:
      • Check the Period box and select a range, time period or a Quick Link (for example, Last 7 Days). Quick Links are relative to the date the API is queried.
      • Uncheck Period only if you want all available data.
    2. To further narrow the dataset, select Custom filter columns and values (for example, limit to specific metrics, material types, or areas).
    3. Click the refresh icon to apply the selected filters.
  9. Save and manage the configuration:
    1. Click the ellipsis (…) next to the configuration name and select Save As.
    2. Enter or update the configuration Name.
    3. Set Visibility to Private or Global.
    4. Set the configuration to Locked if required.

      Note: Locked configurations can only be edited after being unlocked via the Analysis Configurations Screen.

    5. Click Save.

    The configuration saves.

To copy the API URL:

  1. Click the ellipsis (…) next to the configuration name.
  2. Select Copy External Link from the menu.

    The URL copies to the clipboard.

    Important: Treat the link like a credential and share only with trusted systems. Calling the external link requires an OAuth2 client-credentials bearer token and a POST request with an empty JSON body {}. The response is raw JSON matching your selected columns and values.