---
title: "Get south connector metrics"
method: GET
path: "/api/south/{southId}/metrics"
tags: ["South Connectors"]
---

# Get south connector metrics

`GET /api/south/{southId}/metrics`

Retrieves the current metrics of a south connector

## Path parameters

- `southId` string, required

## Response `200`

The south connector metrics

- SouthConnectorMetrics — Metrics for a south connector.
  - `metricsStart` string, required — Represents an instant in time as an ISO 8601 string.
  - `lastConnection` string, required — Represents an instant in time as an ISO 8601 string.
  - `lastRunStart` string, required — Represents an instant in time as an ISO 8601 string.
  - `lastRunDuration` number, double, nullable, required — The duration of the last run in milliseconds.
  - `numberOfValuesRetrieved` number, double, required — The number of values retrieved.
  - `numberOfFilesRetrieved` number, double, required — The number of files retrieved.
  - `lastValueRetrieved` OIBusTimeValue, required — A time-value pair.
    - `pointId` string, required — The ID of the point.
    - `timestamp` string, required — Represents an instant in time as an ISO 8601 string.
    - `data` object, required — The data associated with the point.
      - `value` union, required — The value of the point.
        - string
        - number, double
  - `lastFileRetrieved` string, nullable, required — The last file retrieved.

## Changes

- **2026-09-29** `493f2fb6bdac` — 1 info
  - endpoint added
- **2026-09-28** `62adb78789a0` — 1 breaking
  - api path removed without deprecation
- **2026-09-25** `abbc8a87e02a` — 1 info
  - endpoint added
- **2026-09-25** `5460a4ab68ba` — 1 breaking
  - api path removed without deprecation
- **2026-09-25** `6bde5d8e7c6f` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/south/:southId/metrics/get.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optimistiksas/apis/oibus-api/revisions/fa9a57387b34?raw)
