> ## 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. # Count leads > How many leads match the same filters as `GET /v1/leads`: at your threshold, by score from 0 to 5, by band, and discarded. With `q`, counted over the first 1,001 matches. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/leads/counts 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/counts: get: tags: - leads summary: Count leads description: >- How many leads match the same filters as `GET /v1/leads`: at your threshold, by score from 0 to 5, by band, and discarded. With `q`, counted over the first 1,001 matches. operationId: countLeads 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. responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/LeadCounts' '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: LeadCounts: type: object properties: at_threshold: type: integer by_score: type: object properties: '0': type: integer '1': type: integer '2': type: integer '3': type: integer '4': type: integer '5': type: integer required: - '0' - '1' - '2' - '3' - '4' - '5' additionalProperties: false by_fit_band: type: object properties: strong: type: integer good: type: integer weak: type: integer excluded: type: integer required: - strong - good - weak - excluded additionalProperties: false discarded: type: integer required: - at_threshold - by_score - by_fit_band - discarded 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 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.