find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/coldleads-app:coldleads-app-leads-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Cold Leads API
  version: 1.0.0
  description: 'Headless e-mail verification and B2B e-mail discovery, plus the sales memory an AI agent needs to continue work across sessions: one-call lead context, a next-actions queue, follow-up scheduling and an audit log of API/MCP calls. Each operation declares x-coldleads-side-effect (read or write); nothing here sends e-mail. Authenticate with an API key from Settings → API keys (Business plan). Node.js SDK: https://github.com/anttka4cz/coldleads-node-sdk · MCP server: https://github.com/anttka4cz/mcp-server-coldleads'
servers:
- url: https://coldleads.app/api/v1
security:
- apiKey: []
tags:
- name: Leads
paths:
  /leads:
    get:
      operationId: searchLeads
      summary: Contacts already in your Cold Leads CRM at a company domain (no credits)
      parameters:
      - name: domain
        in: query
        required: true
        schema:
          type: string
        description: Company domain, e.g. example.com
      - name: role
        in: query
        required: false
        schema:
          type: string
          maxLength: 80
        description: Keyword matched against name, e-mail local part, tags, notes and type
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 10
      responses:
        '200':
          description: domain, count, source=crm, leads[] with email, name, company, phone, stage, tags, verification, do_not_contact
        '400':
          description: domain_required
        '401':
          description: Missing or bad API key
        '429':
          description: Rate limited
      tags:
      - Leads
  /leads/context:
    get:
      operationId: getLeadContext
      summary: Everything known about one lead in one call (no credits) — same as the MCP tool…
      x-coldleads-side-effect: read
      parameters:
      - name: contact_id
        in: query
        required: false
        schema:
          type: string
          maxLength: 100
        description: Contact id; or pass email
      - name: email
        in: query
        required: false
        schema:
          type: string
          format: email
        description: Contact e-mail; alternative to contact_id
      responses:
        '200':
          description: Lead context
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadContext'
        '400':
          description: lead_required
        '404':
          description: not_found
      tags:
      - Leads
components:
  schemas:
    LeadContext:
      type: object
      properties:
        lead:
          type: object
          properties:
            id:
              type: string
            email:
              type: string
            name:
              type: string
            company:
              type: string
            phone:
              type: string
            stage:
              type: string
              enum:
              - cold
              - subscriber
              - lead
              - customer
              - regular
            source:
              type: string
            tags:
              type: string
            notes:
              type: string
            owner:
              type:
              - string
              - 'null'
            deal_value:
              type:
              - number
              - 'null'
            created_at:
              type: string
              format: date-time
        contactability:
          type: object
          properties:
            do_not_contact:
              type: boolean
            reasons:
              type: array
              items:
                type: string
                enum:
                - opted_out
                - bounced
                - do_not_contact_list
                - consent_withdrawn
            consent:
              type: string
            email_verification:
              type:
              - object
              - 'null'
            safe_to_contact:
              type: boolean
        relationship:
          type: object
          properties:
            sent_messages:
              type: integer
            received_replies:
              type: integer
            campaign_templates_received:
              type: integer
            last_contacted_at:
              type:
              - string
              - 'null'
              format: date-time
            last_reply_at:
              type:
              - string
              - 'null'
              format: date-time
            last_reply_class:
              type:
              - string
              - 'null'
              enum:
              - positive
              - neutral
              - negative
              - unsubscribe
              - auto
              - null
            last_reply_tag:
              type:
              - string
              - 'null'
              enum:
              - meeting
              - pricing
              - objection
              - referral
              - not_now
              - question
              - null
            awaiting_our_reply:
              type: boolean
        next_action:
          type: object
          properties:
            action:
              type: string
              enum:
              - reply
              - close
              - follow_up
              - follow_up_later
              - none
            due_at:
              type:
              - string
              - 'null'
              format: date-time
            reason:
              type: string
            source:
              type: string
              enum:
              - reply_waiting
              - scheduled
              - none
        recent_messages:
          type: array
          items:
            type: object
            properties:
              direction:
                type: string
                enum:
                - in
                - out
              at:
                type: string
                format: date-time
              subject:
                type: string
              text:
                type: string
              reply_class:
                type:
                - string
                - 'null'
              reply_tag:
                type:
                - string
                - 'null'
              channel:
                type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
externalDocs:
  description: Node.js SDK (GitHub)
  url: https://github.com/anttka4cz/coldleads-node-sdk