Conversions

List conversions

Changed on Sep 29, 2026

List the workspace's conversions.

Without after or since, returns the most recent conversions first (by occurred_at).

Paging through every conversion

Pass since, after, or both, and conversions come back in the order Linkly recorded them, oldest first. To walk the full history, request a page with since set to any date before your first conversion (for example 2020-01-01), then keep requesting with after set to the id of the last conversion you received for as long as has_more is true. To sync incrementally, set since to when you last synced: conversions are never renumbered, and a conversion reported late (a webhook arriving days after the sale) is recorded, and so returned, at the time it arrives rather than at its occurred_at.

get/api/v1/conversions

Request

Base URL
https://api.linklyhq.com
Auth
API key in query parameter api_key
TypeScript
https://skmtc.dev/linklyhq/apis/linkly-url-shortener-api/docs/api/v1/conversions/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

workspace_idstring

The ID of the workspace. Required when authenticating with an API key. Omit it with an OAuth token, which is bound to one workspace.

limitinteger

Maximum conversions to return (1–1000, default 100)

afterstring

Return conversions recorded after this conversion id, oldest first. Use the id of the last conversion on the previous page.

sincestring

Return conversions Linkly recorded at or after this time, oldest first. An ISO 8601 date (2026-07-29) or date-time (2026-07-29T10:30:00Z); a date-time without an offset is read as UTC.

Response

Conversion list

has_moreboolean required

True when more conversions follow this page. When paging with since or after, request the next page with after set to the last id here.

Example response

{
  "conversions": [
    {
      "amount_cents": 4999,
      "click_id": "01KYPGEEPJSPR3S564QRBDGA1W",
      "country": "US",
      "currency": "USD",
      "event_id": "shopify-1234",
      "event_name": "purchase",
      "event_type": "sale",
      "external_id": "customer-42",
      "id": "01KYPH20SEJY4HQSCPMWW60QE0",
      "inserted_at": "2026-07-29T10:30:01",
      "ip_source": "visitor",
      "link_id": 41657524,
      "occurred_at": "2026-07-29T10:30:00.123456Z",
      "source": "api"
    }
  ]
}

Changes

Sep 29, 202613ab75fedc4d Revision changes
- info
  added the new optional query request parameter after
- info
  added the new optional query request parameter since
- info
  the response property became required for the status
- info
  added the required property to the response with the status
Sep 15, 20269c5b6c116b85 Revision changes
- breaking
  the // response's property format changed from date-time to no format for status
- info
  added the new optional query request parameter workspace_id
- info
  added the non-success response with the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status

Operation history