List Prospects

Paginate video prospects for the authenticated organization. Use this endpoint to reconcile state from a CRM, build deduplication lookups, or power admin dashboards — the filters cover the same keys you set when you created the prospect.

Endpoint

Authenticate using a Bearer organization API key. The endpoint is read-only, free, and scoped to the caller's organization (PostgreSQL Row Level Security is enforced).

Pricing

Query Parameters

Cursor Pagination

The response carries an opaque next_cursor string. To fetch the next page, re-issue the same request and pass the cursor verbatim:

GET /api/video-prospects?cursor={next_cursor}

The cursor encodes the (created_at, id) pair of the last row on the current page. Do not construct or mutate the cursor yourself — a tampered cursor returns 422 Invalid cursor. When has_more is false, the next_cursor is null and the list is exhausted. Results are ordered by created_at DESC, id DESC so new prospects always surface on page one.

Filters

All filters are optional and composable. Filter values are server-side normalized so you can match the same values you passed on creation:

external_id matches custom_vars.external_id exactly — the recommended way to look up a prospect from a CRM record when you do not have the numeric ID.
email is lower-cased before the query.
linkedin_url is canonicalised (country subdomains stripped, trailing slash removed, https://www.linkedin.com/in/{username} enforced) and matched against custom_vars.linkedin_url.
campaign_id is validated to belong to your organization — passing another org's campaign returns 422.
status accepts queued, processing, ready, failed, or pending_credits (the aggregate lifecycle state, same values returned by Create and Show).