---
title: "Get attribution metrics"
method: GET
path: "/v1/accounts/{accountId}/conversion-destinations/{destinationId}/metrics"
tags: ["Conversions"]
---

# Get attribution metrics

`GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}/metrics`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}/conversion-destinations/{destinationId}/metrics`
- Auth: HTTP bearer

Shows a LinkedIn conversion rule's attributed conversions, value, leads and cost over time.

LinkedIn-only today. Returns conversion-attribution metrics
(`externalWebsiteConversions`, `externalWebsitePostClickConversions`,
`externalWebsitePostViewConversions`, `conversionValueInLocalCurrency`,
`qualifiedLeads`, `costInLocalCurrency`) bucketed by date.

Date-range constraints (passed through from LinkedIn):
- `granularity=DAILY` is retained for ~6 months only
- `granularity=ALL` with a range > 6 months auto-rounds to month boundaries
- `granularity=MONTHLY`/`YEARLY` retains 24 months

Throttle: LinkedIn caps adAnalytics at 45M metric values per 5-minute
window across the calling token. Single-rule queries are well within
that limit; surfaces as 429 if hit.

## Path parameters

- `accountId` string, required
- `destinationId` string, required

## Query parameters

- `adAccountId` string, required
- `startDate` string, required
- `endDate` string
- `granularity` 'ALL' | 'DAILY' | 'MONTHLY' | 'YEARLY'

## Response `200`

Metrics rows

- object
  - `platform` 'linkedinads'
  - `granularity` 'ALL' | 'DAILY' | 'MONTHLY' | 'YEARLY'
  - `rows` object[]
    - `start` string: YYYY-MM-DD
    - `end` string: YYYY-MM-DD (inclusive)
    - `metrics` object

## Other responses

- `400`: Validation error or invalid date range.
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Ads add-on or LinkedIn reconnect required.
- `404`: The account or requested resource was not found or is not accessible. An account ID may have been disconnected and removed. Read GET /v1/accounts for current account IDs.
- `405`: Platform does not support metrics readback.
- `409`: The account exists but is inactive or needs reconnection. Reconnect it, then read GET /v1/accounts for its current account ID before retrying. Code: ads_connection_required.
- `429`: LinkedIn analytics rate limit hit.

## Changes

- **2026-10-06** `f8c8f34fb41a`: 3 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `404`
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `409`
- **2026-10-02** `d556591af3f6`: 9 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `404` status
  - …5 more
- **2026-09-30** `16a7b9d5373e`: 2 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `404`
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `409`
- **2026-09-25** `2c04683ce694`: 8 info
  - added the optional property `details/adAccountId` to the response with the `404` status
  - added the optional property `details/adAccountId` to the response with the `409` status
  - added the optional property `details/createdObjects` to the response with the `404` status
  - added the optional property `details/createdObjects` to the response with the `409` status
  - …4 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/conversion-destinations/:destinationId/metrics/get.md)

---

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