---
title: "Resolve the funnel entry-guard payload for a given Firebase UID"
method: GET
path: "/v1/acquisition/leads/by-firebase-uid/{firebaseUid}"
tags: ["Acquisition Leads"]
---

# Resolve the funnel entry-guard payload for a given Firebase UID

`GET /v1/acquisition/leads/by-firebase-uid/{firebaseUid}`

## Request

- Base URL: `https://api.miaai.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://api.miaai.chat/v1/acquisition/leads/by-firebase-uid/{firebaseUid}`
- Auth: HTTP bearer

Returns the lead, the latest session, and a short list of recent sessions. The funnel uses `lead.isCustomer` to decide whether to redirect the user to the app.

## Path parameters

- `firebaseUid` string, required

## Response `200`

- AcquisitionLeadSummaryDto
  - `lead` AcquisitionLeadDto, required
    - `id` string, required
    - `firebaseUid` string, nullable
    - `email` string, nullable
    - `linkedAppUserId` string, nullable
    - `isCustomer` boolean, required
    - `firstSeenAt` string, date-time, required
    - `lastSeenAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `latestSession` AcquisitionSessionDto, required
    - `id` string, required
    - `leadId` string, required
    - `funnelId` string, required
    - `attemptNumber` number, required
    - `status` 'in_progress' | 'completed' | 'purchased' | 'abandoned', required
    - `answers` object, required
    - `attribution` AcquisitionAttributionDto, required
      - `utmSource` string, nullable
      - `utmMedium` string, nullable
      - `utmCampaign` string, nullable
      - `utmContent` string, nullable
      - `utmTerm` string, nullable
      - `fbclid` string, nullable
      - `gclid` string, nullable
      - `ttclid` string, nullable
      - `referrer` string, nullable
      - `adMetadata` object: Additional ad/campaign metadata captured from the landing URL — all values are strings
    - `experiments` object, required
    - `locale` string, required
    - `deviceType` 'mobile' | 'tablet' | 'desktop', nullable
    - `userAgent` string, nullable
    - `country` string, nullable
    - `ipAddress` string, nullable
    - `amplitudeDeviceId` string, nullable
    - `facebookPixelId` string, nullable
    - `tiktokPixelId` string, nullable
    - `startedAt` string, date-time, required
    - `lastTouchAt` string, date-time, required
    - `completedAt` string, date-time, nullable
    - `purchasedAt` string, date-time, nullable
    - `abandonedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `sessions` AcquisitionSessionDto[], required
    - `id` string, required
    - `leadId` string, required
    - `funnelId` string, required
    - `attemptNumber` number, required
    - `status` 'in_progress' | 'completed' | 'purchased' | 'abandoned', required
    - `answers` object, required
    - `attribution` AcquisitionAttributionDto, required
      - `utmSource` string, nullable
      - `utmMedium` string, nullable
      - `utmCampaign` string, nullable
      - `utmContent` string, nullable
      - `utmTerm` string, nullable
      - `fbclid` string, nullable
      - `gclid` string, nullable
      - `ttclid` string, nullable
      - `referrer` string, nullable
      - `adMetadata` object: Additional ad/campaign metadata captured from the landing URL — all values are strings
    - `experiments` object, required
    - `locale` string, required
    - `deviceType` 'mobile' | 'tablet' | 'desktop', nullable
    - `userAgent` string, nullable
    - `country` string, nullable
    - `ipAddress` string, nullable
    - `amplitudeDeviceId` string, nullable
    - `facebookPixelId` string, nullable
    - `tiktokPixelId` string, nullable
    - `startedAt` string, date-time, required
    - `lastTouchAt` string, date-time, required
    - `completedAt` string, date-time, nullable
    - `purchasedAt` string, date-time, nullable
    - `abandonedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) - [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miaai/apis/backend-template-api/revisions/2a8d88a5124f?raw)