GET /v1/projects/:projectId/apple-ads-attribution

Returns Apple Search Ads (ASA) attribution records the Layers SDK captured on iOS installs. Each record carries the campaign and ad group the install attributed to, plus the install timestamp.

The Layers SDK calls Apple's token API at first launch and posts the encoded token to the ingest endpoint. The ingest pipeline exchanges it with Apple and stamps the campaign / ad group / country onto the originating sdk_events row. This endpoint surfaces those rows directly — Phase 1 reads them from sdk_events filtered by attribution_method = 'deterministic_adservices', so the Apple-side fields Layers does not yet retain (orgId, keywordId, creativeSetId, clickDate) are returned as zero / null placeholders.

Records appear only for users who installed via an ASA ad and whose device returned a valid token within the Apple-defined attribution window. Organic installs and users who opted out of tracking (att_status != authorized) do not appear here.

Example request

curl "https://api.layers.com/v1/projects/prj_01HX9Y7K8M2P4RSTUV56789AB/apple-ads-attribution?since=2026-04-11T00:00:00Z" \
  -H "Authorization: Bearer lp_live_01HX9Y6K7EJ4T2_4QZpN..."

const { records, nextCursor } = await layers.appleAdsAttribution.list(
  "prj_01HX9Y7K8M2P4RSTUV56789AB",
  { since: "2026-04-11T00:00:00Z" }
);

result = layers.apple_ads_attribution.list(
    project_id="prj_01HX9Y7K8M2P4RSTUV56789AB",
    since="2026-04-11T00:00:00Z",
)

Response

{
  "records": [
    {
      "recordId": "01HXA7K8M2P4RSTUV56789AB",
      "appUserId": "user_a7f3c1d9",
      "appId": "01HXA1NPQR5TVWXYZABCDEFGH",
      "attribution": "true",
      "orgId": 0,
      "campaignId": 1440210011,
      "adGroupId": 1440210072,
      "keywordId": 0,
      "creativeSetId": 0,
      "countryOrRegion": "US",
      "conversionType": "Download",
      "clickDate": null,
      "installedAt": "2026-04-11T16:06:02Z",
      "reDownload": false,
      "exchangedAt": "2026-04-11T16:06:02Z"
    }
  ],
  "nextCursor": null
}

Errors

See also

• GET /v1/projects/:projectId/events — raw event stream (includes non-iOS platforms)
• GET /v1/projects/:projectId/conversions — aggregated conversions