Every metrics-v1 value for one issuer.

Per metric, the latest full-year period published by as_of: the same value /v1/screen ranks. Rows carry the screener's fields without rank, and each methodology_ref names the documented formula. Informational only; not advice.

get/v1/metrics/{dataco_id}

Request

  • Base URL: https://api.certvas.com
  • URL: https://api.certvas.com/v1/metrics/{dataco_id}
  • Auth: API key in header X-API-Key

Path parameters

dataco_idstring required

Certvas ID of the organisation, e.g. from /v1/tender-parties.

Query parameters

metricstring

One metrics-v1 slug, e.g. gross_margin. Omit for every metric.

as_ofstring date

Point-in-time date (YYYY-MM-DD). Per issuer and metric, takes the latest full-year period that had been published by that date, and returns its value only if every filing the value is computed from was available by then with the figures it holds today: the value is exactly what was computable on that date, with no look-ahead. Where that year's figures were revised or completed later, the value is left out rather than replaced by the revised value or an older year, so a historical query can return fewer issuers than were covered then. Because values are recomputed from current figures, a later restatement can remove a value from a past as_of; it never adds one dated before its filing.

limitinteger

Maximum rows to return. Sandbox keys are capped well below the paid ceiling.

Response

Metric values.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.