---
title: "The structured window of recent outreach leads"
method: GET
path: "/leads"
tags: ["leads"]
---

# The structured window of recent outreach leads

`GET /leads`

## Request

- Base URL: `https://portal.fractionalteams.com/api/v1`
- URL: `https://portal.fractionalteams.com/api/v1/leads`
- Auth: HTTP bearer

Leads with activity in the ~30 days before the latest published report: conversation summary, last message, LinkedIn profile, owning salesperson and current status. Own-leads-only keys see only their own rows. Complete list, no pagination.

## Response `200`

Recent leads

- Lead[]
  - `conversation_id` string, required
  - `contact_name` string, nullable
  - `profile_url` string, uri, nullable
  - `owner` string, nullable
  - `summary` string, nullable: Short conversation summary written for the report
  - `last_message` object, nullable
    - `at` string, date-time
    - `from` string, nullable: Who sent the last message (the lead's name, or the salesperson)
    - `text` string, nullable
  - `last_activity_at` string, date-time, nullable
  - `status` 'awaiting' | 'replied_outside', required
  - `status_changed_at` string, date-time, nullable

## Other responses

- `401`: Missing or invalid API key (a malformed ftpk_ key never falls back to the demo workspace).
- `403`: The key's scope does not include the outreach section
- `429`: Rate limit exceeded (120 requests per minute per key). Honour Retry-After / RateLimit-Reset.

---

[API](https://skmtc.dev/fractionalteams/apis/fractional-teams-portal-api.md) · [All operations](https://skmtc.dev/fractionalteams/apis/fractional-teams-portal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fractionalteams/apis/fractional-teams-portal-api/revisions/9f81154af4dc?raw)