> ## Documentation Index > Fetch the complete documentation index at: https://docs.trytikt.com/llms.txt > Use this file to discover all available pages before exploring further. # List leads > A page of leads with their full profile and their verdict criterion by criterion. Without filters, what the Leads page shows: leads at your workspace's threshold, without the ones you discarded, newest first. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/leads openapi: 3.1.0 info: title: TIKT API version: '2026-10-01' description: >- Read your leads with their verdict criterion by criterion, and answer TIKT: file, discard, exclude, pause, track. Server to server only: never call it from a browser. servers: - url: https://api.trytikt.com security: - apiKey: [] tags: - name: workspace - name: leads - name: lists - name: posts - name: tracked-profiles - name: icp - name: analytics - name: events - name: webhook-endpoints - name: workflows - name: tools paths: /v1/leads: get: tags: - leads summary: List leads description: >- A page of leads with their full profile and their verdict criterion by criterion. Without filters, what the Leads page shows: leads at your workspace's threshold, without the ones you discarded, newest first. operationId: listLeads parameters: - name: min_score in: query required: false schema: type: string pattern: ^[0-5]$ description: >- Only leads scoring at least this, from 0 to 5. Your workspace's threshold by default (none inside a list). - name: max_score in: query required: false schema: type: string pattern: ^[0-5]$ description: Only leads scoring at most this, from 0 to 5. - name: include_discarded in: query required: false schema: type: string enum: - 'true' - 'false' description: >- `true` to include the leads you discarded and the ones your ICP excluded. - name: fit_band in: query required: false schema: type: string maxLength: 200 description: >- Only these bands, separated by commas: `strong`, `good`, `weak`, `excluded`. - name: criteria_met in: query required: false schema: type: string maxLength: 200 description: >- Only leads that meet all these criteria, separated by commas: `job_role`, `location`, `company_type`, `company_size`, `industry`. - name: criteria_not_met in: query required: false schema: type: string maxLength: 200 description: >- Only leads that don't meet any of these criteria, separated by commas. - name: list_id in: query required: false schema: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ description: >- Only the leads of this list. Inside a list, no threshold and discarded leads included, unless you ask. - name: in_list in: query required: false schema: type: string enum: - 'true' - 'false' description: >- `true`: only leads in at least one list; `false`: only leads in none. - name: handled in: query required: false schema: type: string enum: - 'true' - 'false' description: 'The same as `in_list`: a lead in a list counts as handled.' - name: kol_id in: query required: false schema: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ description: Only leads who engaged with a post of this tracked profile. - name: post_id in: query required: false schema: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ description: Only leads who engaged with this post. - name: engaged_by in: query required: false schema: type: string enum: - reactions - comments - any description: >- Only leads who reacted (`reactions`), commented (`comments`), or either (`any`). - name: min_engagements in: query required: false schema: type: string pattern: ^\d{1,3}$ description: Only leads with at least this many engagements. - name: engaged_since in: query required: false schema: type: string maxLength: 40 description: Only leads found or active since this date (ISO 8601). - name: engaged_within in: query required: false schema: type: string enum: - 24h - 7d - 30d description: Only leads found or active over the last `24h`, `7d` or `30d`. - name: first_seen_after in: query required: false schema: type: string maxLength: 40 description: Only leads found from this date on (ISO 8601). - name: first_seen_before in: query required: false schema: type: string maxLength: 40 description: Only leads found before this date (ISO 8601). - name: status_changed_after in: query required: false schema: type: string maxLength: 40 description: Only leads discarded or restored since this date (ISO 8601). - name: q in: query required: false schema: type: string minLength: 1 maxLength: 100 description: >- Search the name, title, headline and company name. Counts stop at 1,001. - name: sort in: query required: false schema: default: first_seen_at type: string enum: - first_seen_at - score - engagements - last_engagement_at description: >- `first_seen_at` (the default, newest first), `score`, `engagements` or `last_engagement_at`. - name: limit in: query required: false schema: type: string pattern: ^\d{1,3}$ description: Items per page, from 1 to 100. 50 by default. - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 600 description: >- The `next_cursor` of the previous page. Leave it out for the first page. responses: '200': description: Success. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Lead' page: type: object properties: next_cursor: anyOf: - type: string - type: 'null' has_more: type: boolean required: - next_cursor - has_more additionalProperties: false required: - data - page additionalProperties: false '400': $ref: '#/components/responses/E400' '401': $ref: '#/components/responses/E401' '404': $ref: '#/components/responses/E404' '429': $ref: '#/components/responses/E429' '500': $ref: '#/components/responses/E500' '503': $ref: '#/components/responses/E503' security: - apiKey: [] components: schemas: Lead: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ status: type: string score: anyOf: - type: integer - type: 'null' score_max: type: integer fit_band: anyOf: - type: string - type: 'null' criteria: type: array items: type: object properties: key: type: string label: type: string mode: type: string verdict: type: string justification: anyOf: - type: string - type: 'null' required: - key - label - mode - verdict - justification additionalProperties: false disqualifiers: type: array items: type: object properties: kind: type: string key: anyOf: - type: string - type: 'null' label: anyOf: - type: string - type: 'null' justification: anyOf: - type: string - type: 'null' additionalProperties: false summary: anyOf: - type: string - type: 'null' scored_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' scoring_version: anyOf: - type: string - type: 'null' icp_version_id: anyOf: - type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ - type: 'null' engagement_count: type: integer reaction_count: type: integer comment_count: type: integer signals: type: array items: $ref: '#/components/schemas/LeadSignal' first_seen_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' last_engagement_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' status_changed_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' lists: type: array items: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ name: type: string added_at: type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ required: - id - name - added_at additionalProperties: false handled: type: boolean console_url: type: string person: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ linkedin_url: anyOf: - type: string - type: 'null' linkedin_member_id: anyOf: - type: string - type: 'null' full_name: anyOf: - type: string - type: 'null' first_name: anyOf: - type: string - type: 'null' last_name: anyOf: - type: string - type: 'null' headline: anyOf: - type: string - type: 'null' about: anyOf: - type: string - type: 'null' picture_url: anyOf: - type: string - type: 'null' location: type: object properties: country: anyOf: - type: string - type: 'null' country_code: anyOf: - type: string - type: 'null' region: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' required: - country - country_code - region - city additionalProperties: false current_position: type: object properties: title: anyOf: - type: string - type: 'null' company_name: anyOf: - type: string - type: 'null' company_linkedin_url: anyOf: - type: string - type: 'null' required: - title - company_name - company_linkedin_url additionalProperties: false seniority: anyOf: - type: string - type: 'null' department: anyOf: - type: string - type: 'null' positions: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' company_name: anyOf: - type: string - type: 'null' company_linkedin_url: anyOf: - type: string - type: 'null' company_linkedin_id: anyOf: - type: string - type: 'null' start_date: anyOf: - type: string - type: 'null' end_date: anyOf: - type: string - type: 'null' is_current: type: boolean duration: anyOf: - type: string - type: 'null' location: anyOf: - type: string - type: 'null' employment_type: anyOf: - type: string - type: 'null' workplace_type: anyOf: - type: string - type: 'null' description: anyOf: - type: string - type: 'null' required: - title - company_name - company_linkedin_url - company_linkedin_id - start_date - end_date - is_current - duration - location - employment_type - workplace_type - description additionalProperties: false education: type: array items: type: object properties: school_name: anyOf: - type: string - type: 'null' school_linkedin_url: anyOf: - type: string - type: 'null' degree: anyOf: - type: string - type: 'null' field_of_study: anyOf: - type: string - type: 'null' start_year: anyOf: - type: integer - type: 'null' end_year: anyOf: - type: integer - type: 'null' required: - school_name - school_linkedin_url - degree - field_of_study - start_year - end_year additionalProperties: false languages: type: array items: type: object properties: name: type: string proficiency: anyOf: - type: string - type: 'null' required: - name - proficiency additionalProperties: false skills: type: array items: type: string followers_count: anyOf: - type: integer - type: 'null' connections_count: anyOf: - type: integer - type: 'null' flags: type: object properties: open_to_work: type: boolean is_hiring: type: boolean is_premium: type: boolean is_influencer: type: boolean is_verified: type: boolean is_creator: type: boolean required: - open_to_work - is_hiring - is_premium - is_influencer - is_verified - is_creator additionalProperties: false profile_language: anyOf: - type: string - type: 'null' profile_country: anyOf: - type: string - type: 'null' websites: type: array items: type: string linkedin_member_since: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' profile_read_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' required: - id - linkedin_url - linkedin_member_id - full_name - first_name - last_name - headline - about - picture_url - location - current_position - seniority - department - positions - education - languages - skills - followers_count - connections_count - flags - profile_language - profile_country - websites - linkedin_member_since - profile_read_at additionalProperties: false company: anyOf: - $ref: '#/components/schemas/Company' - type: 'null' required: - id - status - score - score_max - fit_band - criteria - disqualifiers - summary - scored_at - scoring_version - icp_version_id - engagement_count - reaction_count - comment_count - signals - first_seen_at - last_engagement_at - status_changed_at - lists - handled - console_url - person - company additionalProperties: false LeadSignal: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ kind: type: string reaction_type: anyOf: - type: string - type: 'null' text: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' likes: type: integer replies: type: integer is_pinned: type: boolean is_edited: type: boolean occurred_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' captured_at: type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ post: $ref: '#/components/schemas/Post' required: - id - kind - reaction_type - text - url - likes - replies - is_pinned - is_edited - occurred_at - captured_at - post additionalProperties: false Company: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ linkedin_company_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' universal_name: anyOf: - type: string - type: 'null' linkedin_url: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' domain: anyOf: - type: string - type: 'null' logo_url: anyOf: - type: string - type: 'null' tagline: anyOf: - type: string - type: 'null' about: anyOf: - type: string - type: 'null' industry: anyOf: - type: string - type: 'null' specialties: type: array items: type: string company_size: anyOf: - type: string - type: 'null' employees_count: anyOf: - type: integer - type: 'null' organization_type: anyOf: - type: string - type: 'null' founded_year: anyOf: - type: integer - type: 'null' followers_count: anyOf: - type: integer - type: 'null' headquarters: anyOf: - type: string - type: 'null' country_code: anyOf: - type: string - type: 'null' locations: type: array items: type: string enriched_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' required: - id - linkedin_company_id - name - universal_name - linkedin_url - website - domain - logo_url - tagline - about - industry - specialties - company_size - employees_count - organization_type - founded_year - followers_count - headquarters - country_code - locations - enriched_at additionalProperties: false Error: type: object properties: error: type: object properties: code: type: string enum: - parametre_inconnu - parametre_invalide - corps_invalide - curseur_invalide - cle_absente - cle_invalide - cle_revoquee - cle_de_lecture - introuvable - methode_non_permise - limite_atteinte - corps_trop_gros - refus - trop_de_requetes - erreur_interne - indisponible message: type: string status: type: integer request_id: anyOf: - type: string - type: 'null' details: type: object additionalProperties: true required: - code - message - status - request_id additionalProperties: false required: - error additionalProperties: false Post: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ linkedin_post_id: type: string urn: type: string url: type: string author: type: object properties: type: type: string name: anyOf: - type: string - type: 'null' public_id: anyOf: - type: string - type: 'null' linkedin_url: anyOf: - type: string - type: 'null' avatar_url: anyOf: - type: string - type: 'null' required: - type - name - public_id - linkedin_url - avatar_url additionalProperties: false text: anyOf: - type: string - type: 'null' hashtags: type: array items: type: string media_type: anyOf: - type: string - type: 'null' media: type: object properties: images: type: array items: type: string videos: type: array items: type: string required: - images - videos additionalProperties: false external_links: type: array items: type: string is_repost: type: boolean posted_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' counters: type: object properties: reactions: anyOf: - type: integer - type: 'null' comments: anyOf: - type: integer - type: 'null' checked_at: anyOf: - type: string pattern: ^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ$ - type: 'null' required: - reactions - comments - checked_at additionalProperties: false tracking_status: type: string source: type: string kol: $ref: '#/components/schemas/TrackedProfileSummary' console_url: type: string required: - id - linkedin_post_id - urn - url - author - text - hashtags - media_type - media - external_links - is_repost - posted_at - counters - tracking_status - source - kol - console_url additionalProperties: false TrackedProfileSummary: type: object properties: id: type: string pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ name: anyOf: - type: string - type: 'null' relationship: anyOf: - type: string - type: 'null' linkedin_url: anyOf: - type: string - type: 'null' required: - id - name - relationship - linkedin_url additionalProperties: false responses: E400: description: Error 400. content: application/json: schema: $ref: '#/components/schemas/Error' E401: description: Error 401. content: application/json: schema: $ref: '#/components/schemas/Error' E404: description: Error 404. content: application/json: schema: $ref: '#/components/schemas/Error' E429: description: Error 429. content: application/json: schema: $ref: '#/components/schemas/Error' E500: description: Error 500. content: application/json: schema: $ref: '#/components/schemas/Error' E503: description: Error 503. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: >- Your API key, created in Settings › API: `Authorization: Bearer tikt_live_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.