Conversions

Users attributed to your links, and how far each has come.

List conversions

GET/v1/partner-api/conversions

Users attributed to your links, newest first, in the key’s environment.

AuthPartner API key with scope conversions:read

Query parameters

limitinteger1–100default 50

Items per page.

cursorstring≤ 200 chars

nextCursor from the previous page.

fromstringdate

Start, inclusive: a date (2026-11-01) or an ISO 8601 time.

tostringdate

End, inclusive: a date counts to the end of that day (UTC), or an ISO 8601 time.

statusstring

One of qualification_pending qualified rejected reversed

programIdstringuuid

Only this program.

linkIdstringuuid

Only this link.

Returns · 200

itemsarray of objectsrequired

Child attributes

idstringrequireduuid

statusstringrequired

One of qualification_pending qualified rejected reversed

createdAtstringrequireddate-time

registeredAtstringrequireddate-time

qualifiedAtstringrequireddate-timenullable

rejectionReasonstringrequirednullable

reasonCodestringrequirednullable

Set on rejected and reversed conversions.

One of self_affiliate already_user program_cap partner_reversal other

programIdstringrequireduuid

programNamestringrequired

campaignIdstringrequireduuid

campaignNamestringrequired

appNamestringrequired

linkIdstringrequireduuidnullable

linkCodestringrequirednullable

subIdsmap of stringsrequired

The sub-ids of the link at the time of the click.

commissionAmountintegerrequired

Commission earned on it so far, not counting rejected or reversed.

commissionCurrencystringrequirednullable

hasMorebooleanrequired

nextCursorstringrequirednullable

Pass as cursor for the next page; null on the last one.

Errors

400validation_error: The request does not match the schema. details says which fields failed and why.
400invalid_cursor: cursor is not one this API handed out.
401invalid_api_key: No key was sent, or the key is unknown, expired or revoked.
403partner_suspended: API access is suspended for this partner account.
403insufficient_scope: The key lacks the scope this endpoint needs.
429rate_limited: Too many requests with this key in the last minute. Wait Retry-After seconds.

Request

curl "https://api.flowgroup.se/v1/partner-api/conversions" \
  -H "authorization: Bearer $FA_API_KEY"

const res = await fetch('https://api.flowgroup.se/v1/partner-api/conversions', {
  headers: {
    authorization: `Bearer ${process.env.FA_API_KEY}`,
  },
});
const data = await res.json();

200 OK

{
  "items": [
    {
      "id": "3f1c8a52-6c1e-4b8e-9d0a-2b7f0c4e5a91",
      "status": "qualification_pending",
      "createdAt": "2026-11-09T12:00:00.000Z",
      "registeredAt": "2026-11-09T12:00:00.000Z",
      "qualifiedAt": "2026-11-09T12:00:00.000Z",
      "rejectionReason": "rejectionReason",
      "reasonCode": "self_affiliate",
      "programId": "3f1c8a52-6c1e-4b8e-9d0a-2b7f0c4e5a91",
      "programName": "programName",
      "campaignId": "3f1c8a52-6c1e-4b8e-9d0a-2b7f0c4e5a91",
      "campaignName": "campaignName",
      "appName": "appName",
      "linkId": "3f1c8a52-6c1e-4b8e-9d0a-2b7f0c4e5a91",
      "linkCode": "linkCode",
      "subIds": {
        "key": "value"
      },
      "commissionAmount": 2500,
      "commissionCurrency": "commissionCurrency"
    }
  ],
  "hasMore": true,
  "nextCursor": "nextCursor"
}

List conversions#

List conversions