---
title: "List conversions"
method: GET
path: "/api/v1/conversions"
tags: ["Conversions"]
---

# List conversions

`GET /api/v1/conversions`

List the workspace's conversions, most recent first.

## Query parameters

- `limit` integer

## Response `200`

Conversion list

- object
  - `conversions` object[]
    - `amount_cents` integer, nullable
    - `click_id` string, nullable
    - `country` string, nullable
    - `currency` string, nullable
    - `event_id` string, nullable
    - `event_name` string
    - `event_type` string
    - `external_id` string, nullable
    - `id` string — ULID. Sorts chronologically, so ids are ordered by creation.
    - `inserted_at` string, date-time
    - `ip_source` 'visitor' | 'server' | 'unknown' — Whose address was recorded. `server` means the connecting address belonged to your backend or a platform relay, so it is excluded from geographic reporting. The address itself is never returned.
    - `link_id` integer, nullable — The attributed link, or null if the conversion could not be attributed.
    - `metadata` object, nullable
    - `occurred_at` string, date-time
    - `source` string — Which integration reported it.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/linklyhq/apis/linkly-url-shortener-api.md) · [All operations](https://skmtc.net/linklyhq/apis/linkly-url-shortener-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linklyhq/linkly-url-shortener-api/revisions/351c1f004617/schema)