---
title: "Get Fp Sample"
method: GET
path: "/api/v1/classification/fp-sample"
tags: ["classification"]
---

# Get Fp Sample

`GET /api/v1/classification/fp-sample`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/classification/fp-sample`
- Auth: API key in header `X-API-Key`

Random sample of N records currently classified into `sector` for
false-positive audit.

Uses `ORDER BY random() LIMIT n` — fine at our scale (≤ ~1M rows per
sector cross-state). If sample sizes climb past ~100, swap to
TABLESAMPLE BERNOULLI which is constant-time. Random ordering rather
than recency on purpose — FP audit needs an unbiased sample so the
agent isn't seeing only the most recent classification decisions.

## Query parameters

- `sector` string, required: industry_sector to sample (required)
- `n` integer
- `state` string, nullable: Optional state scope (CO/FL/VA/NY)

## Response `200`

Successful Response

- FpSampleResponse
  - `sector` string, required
  - `n_requested` integer, required
  - `n_returned` integer, required
  - `records` FpSampleRecord[], required
    - `lead_ref` string, required
    - `state` string, required
    - `entity_name` string, required
    - `entity_type` string, nullable, required
    - `industry_sector` string, nullable, required
    - `industry_name` string, nullable, required
    - `industry_confidence_tier` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)