Conversions API

Call the API from your backend with a secret key, never from a browser. Create keys on your Tracking page: sk_test_ keys for test mode and sk_live_ keys for live. Keys are shown once and stored hashed.

curl https://takeslice.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"id":"order_123","event":"sale","amount":2900,"currency":"EUR","click_id":"clk_…"}'

Request body

• id (required): your order, invoice or signup ID. Sending the same id again is safe: it is ignored as a duplicate.
• event (required): sale, signup or lead.
• click_id: the sclid value exactly as Slice sent it. Without it no publisher is credited.
• amount: integer minor units (2900 is 29.00). Required for sales, together with currency.
• currency: EUR, USD or GBP.
• occurred_at: ISO 8601 date-time. Defaults to now; not in the future, not older than 400 days.

Response

{
  "data": {
    "id": "cnv_…",
    "object": "conversion",
    "mode": "test",
    "attribution": "attributed",
    "explanation": "Credited to the publisher whose link was clicked.",
    "duplicate": false
  }
}

A new conversion returns 201, a duplicate returns 200. The attribution field says whether a publisher was credited: attributed, no_click, unknown_click, expired_click or wrong_mode.

Errors

• 401 missing_api_key / invalid_api_key
• 400 invalid_json
• 422 invalid_request, with the field in param
• 500 internal_error: retry with the same id