{
  "openapi": "3.1.0",
  "info": {
    "title": "LeadFuze API",
    "version": "1.0.0",
    "description": "Search, enrich, verify and deliver B2B contact data from 269M+ US profiles. One API key works for every endpoint. Every value in these examples belongs to a made-up person.",
    "contact": {
      "name": "LeadFuze data team",
      "url": "https://www.leadfuze.com/contact"
    }
  },
  "servers": [
    {
      "url": "https://console.leadfuze.com/api/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    },
    {
      "apiKeyQuery": []
    }
  ],
  "tags": [
    {
      "name": "Lead database",
      "description": "Search 269M+ US profiles with the same filters as the LeadFuze app. Searching, counting and paging are free and show who matches and what contact details are on file. You spend a credit only when you reveal or export a record.\n\n### How a search works\n\n1. **Read the catalog once.** `GET /leads-database/catalog` lists every field you can filter on and its allowed values.\n2. **Size the market.** `POST /leads-database/count` returns how many people match. Free.\n3. **Start the search.** `POST /leads-database/search` returns the first page of previews and a `next_cursor`. Free.\n4. **Page through.** `GET /leads-database/searches/{search}/pages/{cursor}`. Free.\n5. **Pay only for what you keep.** Reveal up to 100 people at a time, or export up to 100,000 to CSV or Excel. One credit per person, and the same person again within 30 days is free.\n\n### Include, exclude and match\n\n- Different fields combine with AND. Values inside one `include` list combine with OR. A match on any `exclude` value removes the person.\n- Each list takes up to 20 values, and a search takes up to 200 include and exclude values in total.\n- `match: \"exact\"` compares the whole value, ignoring case. `match: \"phrase\"` finds whole words inside the text, and works on job_title, company_name, work_history, education_history, company_description and social_connections. Phrase is the default for the last four.\n- `presence: \"has\"` keeps only people with that field on file, and `\"missing\"` only people without it. A person with no value passes an exclude-only rule, so add `presence: \"has\"` when the value must exist.\n- State names become codes (Texas becomes TX), and country codes are uppercased.\n\n### Job titles and title groups\n\n`job_titles` matches whole words and phrases inside the job title. Any `include` phrase is enough; any `exclude` phrase removes the person, so a title group is simply a list of phrases to include and a list to exclude:\n\n- Owners: include Owner, Founder, Co-Founder, Partner; exclude Vice, Assistant, Product.\n- Operations leaders: include VP of Operations, Director of Operations, Head of Operations.\n\nWith `similar` on (the default), common variants are added for you: CEO and Chief Executive Officer, VP of Sales and Vice President of Sales, Founder and Co-Founder. At most 20 titles after expansion.\n\n### Filter groups\n\nThe catalog sorts every filter into a group: **Person and work**, **Company**, **Location and personal**, **Contact availability** (the on-file filters, such as `has_mobile_phone`) and **Identifiers** (`up_id`, `cc_id`).\n\n- Shortcut filters: `state` (work state, otherwise company state), `country`, `industry`, `department`, `seniority` and `company_size`.\n- Combined on-file filters: `has_any_email`, `has_any_phone` and `has_personal_email`."
    },
    {
      "name": "Enrichment",
      "description": "Turn an email, phone number, LinkedIn URL or domain into a full person record with the company attached. One at a time, or a CSV in the background.\n\n### Credits\n\nOne credit per person returned. No match costs nothing, the same person again within 30 days is free, and an answer served from your `cache_ttl` is free. Every response ends with your remaining credits.\n\n### Response shape\n\n`data` is a list of people. Company fields sit under `company` and LinkedIn data under `social`; turn either off with `include_company` or `include_social`. Fields with nothing on file are null."
    },
    {
      "name": "Email verification",
      "description": "Check whether an address will accept mail before you send to it, one at a time, 100 at once or a whole file.\n\n### Statuses\n\n`valid` is safe to send. `risky` means the domain accepts every address (catch-all) or the inbox is full. `invalid` will bounce. `unknown` means the mail server did not answer."
    },
    {
      "name": "Phone validation",
      "description": "Confirm a number is real, see whether it is a mobile, and get it back in E.164 and local formats.\n\n### Statuses\n\n`valid` numbers parse and are valid for their region. `risky` covers numbers that are only possible, premium rate or otherwise unusual. `invalid` numbers cannot be dialed."
    },
    {
      "name": "Intent data",
      "description": "Find the people researching a topic across the internet. Search 42,000+ topics, run a scan, and download the people as a file.\n\n### How a scan works\n\n1. Find a topic with `GET /intent-data/search`.\n2. Run a scan with `POST /intent-data`. Each topic uses one Intent Scan from your plan.\n3. Poll `GET /intent-data/{id}/status` until it is done, then download the files in `data_urls`."
    },
    {
      "name": "Identity Resolution Pixel",
      "description": "Create a pixel project per website, place its tracking code, and receive every identified visitor by API, webhook or a connected tool.\n\n### Install\n\nCreate a project for each website and place its `tracking_code` in the head of every page. Resellers can rename the script variable and path with `tracking_variable` and `tracking_slug`.\n\n### Webhook events\n\nEach new or updated lead is posted to your URL as `lead.created` or `lead.updated`, with an `X-Event-Type` header. When the project has a webhook secret, `X-Webhook-Signature` carries an HMAC-SHA256 of the raw body, so you can confirm it came from LeadFuze."
    },
    {
      "name": "Integrations",
      "description": "Deliver pixel leads straight to HubSpot, Pipedrive, Slack, email and the major email marketing tools.\n\n### Destinations\n\n`{type}` is one of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse or beehiiv."
    }
  ],
  "paths": {
    "/leads-database/catalog": {
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "List the filterable fields",
        "operationId": "listFilterableFields",
        "description": "Every field you can filter on, with its group, whether it is an on-file (boolean) filter, whether it supports phrase matching and on-file presence, an example, and the allowed values where the list is fixed. Read it once and cache it.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Catalog"
                },
                "example": {
                  "fields": [
                    {
                      "key": "company_employee_count",
                      "label": "Company Employee Count",
                      "group": "Company",
                      "boolean": false,
                      "phrase": false,
                      "description": "Exact normalized value from this source column.",
                      "example": "1001 to 5000",
                      "choices": [
                        "1 to 10",
                        "11 to 25",
                        "26 to 50",
                        "51 to 100",
                        "101 to 250",
                        "251 to 500",
                        "501 to 1000",
                        "1001 to 5000",
                        "5001 to 10000",
                        "10000+"
                      ],
                      "presence": true
                    },
                    {
                      "key": "has_mobile_phone",
                      "label": "Has Mobile Phone",
                      "group": "Contact availability",
                      "boolean": true,
                      "phrase": false,
                      "description": "Whether mobile_phone has a usable value.",
                      "example": true,
                      "choices": [],
                      "presence": false
                    }
                  ],
                  "credits_remaining": 24812,
                  "max_export": 100000
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/count": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Count the people who match",
        "operationId": "countPeopleMatch",
        "description": "Takes the same criteria as a search and returns only the total. Use it to size a market before you spend anything. Free.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Criteria"
              },
              "example": {
                "query": "",
                "job_titles": {
                  "include": [
                    "VP of Operations",
                    "Director of Operations"
                  ],
                  "exclude": [
                    "Assistant"
                  ],
                  "similar": true
                },
                "filters": {
                  "primary_industry": {
                    "include": [
                      "Truck Transportation",
                      "Warehousing And Storage"
                    ]
                  },
                  "company_employee_count": {
                    "include": [
                      "101 to 250",
                      "251 to 500"
                    ]
                  },
                  "state": {
                    "include": [
                      "Texas",
                      "OK"
                    ]
                  },
                  "company_description": {
                    "include": [
                      "cold chain"
                    ],
                    "match": "phrase"
                  },
                  "company_domain": {
                    "exclude": [
                      "competitor.com"
                    ]
                  },
                  "mobile_phone": {
                    "presence": "has"
                  },
                  "has_business_email": {
                    "value": true
                  }
                },
                "limit": 25
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CountResult"
                },
                "example": {
                  "total": 18420,
                  "total_is_exact": true
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/search": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Start a search",
        "operationId": "startSearch",
        "description": "Runs the criteria and returns the first page of previews: who each person is, where they work, and which contact details are on file. Contact values are never in a preview. The search is kept for 30 days; each next_cursor is good for 14 minutes. Free.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Criteria"
              },
              "example": {
                "query": "",
                "job_titles": {
                  "include": [
                    "VP of Operations",
                    "Director of Operations"
                  ],
                  "exclude": [
                    "Assistant"
                  ],
                  "similar": true
                },
                "filters": {
                  "primary_industry": {
                    "include": [
                      "Truck Transportation",
                      "Warehousing And Storage"
                    ]
                  },
                  "company_employee_count": {
                    "include": [
                      "101 to 250",
                      "251 to 500"
                    ]
                  },
                  "state": {
                    "include": [
                      "Texas",
                      "OK"
                    ]
                  },
                  "company_description": {
                    "include": [
                      "cold chain"
                    ],
                    "match": "phrase"
                  },
                  "company_domain": {
                    "exclude": [
                      "competitor.com"
                    ]
                  },
                  "mobile_phone": {
                    "presence": "has"
                  },
                  "has_business_email": {
                    "value": true
                  }
                },
                "limit": 25
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchPage"
                },
                "example": {
                  "success": true,
                  "search_id": "3f6c2a8e-1b7d-4c55-9e0a-6d2f8b41c9a7",
                  "criteria": {
                    "query": "",
                    "filters": {
                      "company_description": {
                        "include": [
                          "cold chain"
                        ],
                        "exclude": [],
                        "match": "phrase"
                      },
                      "company_domain": {
                        "include": [],
                        "exclude": [
                          "competitor.com"
                        ],
                        "match": "exact"
                      },
                      "company_employee_count": {
                        "include": [
                          "101 to 250",
                          "251 to 500"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "has_business_email": {
                        "value": true
                      },
                      "mobile_phone": {
                        "include": [],
                        "exclude": [],
                        "match": "exact",
                        "presence": "has"
                      },
                      "primary_industry": {
                        "include": [
                          "Truck Transportation",
                          "Warehousing And Storage"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "state": {
                        "include": [
                          "TX",
                          "OK"
                        ],
                        "exclude": [],
                        "match": "exact"
                      }
                    },
                    "job_titles": {
                      "include": [
                        "VP of Operations",
                        "Director of Operations"
                      ],
                      "exclude": [
                        "Assistant"
                      ],
                      "similar": true
                    },
                    "lookup_type": null,
                    "limit": 25
                  },
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "company_name": "Northline Logistics",
                      "company_domain": "northlinelogistics.com",
                      "company_employee_count": "251 to 500",
                      "company_revenue": "50 Million to 100 Million",
                      "primary_industry": "Truck Transportation",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "company_city": "Austin",
                      "company_state": "TX",
                      "country": "US",
                      "on_file": {
                        "business_email": true,
                        "personal_emails": true,
                        "mobile_phone": true,
                        "personal_phone": true,
                        "direct_number": true,
                        "linkedin_url": true
                      },
                      "verified_business_email": true
                    }
                  ],
                  "total": 18420,
                  "total_is_exact": true,
                  "next_cursor": "9b2e7d10-5a3c-4f8e-b1d6-2c7a9e4f0b13",
                  "cursor_expires_at": "2026-10-27T15:18:05+00:00"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/searches/{search}/pages/{cursor}": {
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "Get the next page",
        "operationId": "getNextPage",
        "description": "Pass the next_cursor from the previous page. Returns the same shape as a search, with a new next_cursor until the results run out. Free.",
        "parameters": [
          {
            "name": "search",
            "in": "path",
            "required": true,
            "description": "The search_id from POST /leads-database/search.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "cursor",
            "in": "path",
            "required": true,
            "description": "next_cursor from the previous page.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchPage"
                },
                "example": {
                  "success": true,
                  "search_id": "3f6c2a8e-1b7d-4c55-9e0a-6d2f8b41c9a7",
                  "criteria": {
                    "query": "",
                    "filters": {
                      "company_description": {
                        "include": [
                          "cold chain"
                        ],
                        "exclude": [],
                        "match": "phrase"
                      },
                      "company_domain": {
                        "include": [],
                        "exclude": [
                          "competitor.com"
                        ],
                        "match": "exact"
                      },
                      "company_employee_count": {
                        "include": [
                          "101 to 250",
                          "251 to 500"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "has_business_email": {
                        "value": true
                      },
                      "mobile_phone": {
                        "include": [],
                        "exclude": [],
                        "match": "exact",
                        "presence": "has"
                      },
                      "primary_industry": {
                        "include": [
                          "Truck Transportation",
                          "Warehousing And Storage"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "state": {
                        "include": [
                          "TX",
                          "OK"
                        ],
                        "exclude": [],
                        "match": "exact"
                      }
                    },
                    "job_titles": {
                      "include": [
                        "VP of Operations",
                        "Director of Operations"
                      ],
                      "exclude": [
                        "Assistant"
                      ],
                      "similar": true
                    },
                    "lookup_type": null,
                    "limit": 25
                  },
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "company_name": "Northline Logistics",
                      "company_domain": "northlinelogistics.com",
                      "company_employee_count": "251 to 500",
                      "company_revenue": "50 Million to 100 Million",
                      "primary_industry": "Truck Transportation",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "company_city": "Austin",
                      "company_state": "TX",
                      "country": "US",
                      "on_file": {
                        "business_email": true,
                        "personal_emails": true,
                        "mobile_phone": true,
                        "personal_phone": true,
                        "direct_number": true,
                        "linkedin_url": true
                      },
                      "verified_business_email": true
                    }
                  ],
                  "total": 18420,
                  "total_is_exact": true,
                  "next_cursor": "1c7e9a2f-4b3d-4e8a-9f05-6d2c8b1a7e40",
                  "cursor_expires_at": "2026-10-27T15:32:11+00:00"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/searches/{search}/reveal": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Reveal full records",
        "operationId": "revealFullRecords",
        "description": "Returns every field for up to 100 people from this search. One credit per person; revealing the same person again within 30 days is free. Answers 402 when you are out of credits. Cost: 1 credit per new person.",
        "parameters": [
          {
            "name": "search",
            "in": "path",
            "required": true,
            "description": "The search_id from POST /leads-database/search.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ids"
                ],
                "properties": {
                  "ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "1 to 100 up_id values returned by this search."
                  }
                }
              },
              "example": {
                "ids": [
                  "up_8c41d2e7a9"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RevealResult"
                },
                "example": {
                  "success": true,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "cc_id": "cc_51b9e0a4f2",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "social_connections": "500+",
                      "job_title": "VP of Operations",
                      "job_title_normalized": "vice president of operations",
                      "seniority_level": "Vp",
                      "seniority_level_2": "vice president",
                      "department": "Operations",
                      "department_2": "operations",
                      "business_email": "dana@northlinelogistics.com",
                      "business_email_validation_status": "Valid (Esp)",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "historical_programmatic_emails": "dwhitfield@ridgewayfreight.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "company_name": "Northline Logistics",
                      "company_domain": "northlinelogistics.com",
                      "related_domains": "northline.io",
                      "company_description": "Regional freight and warehousing for retailers",
                      "primary_industry": "Truck Transportation",
                      "company_sic": "4213",
                      "company_naics": "484121",
                      "company_employee_count": "251 to 500",
                      "company_revenue": "50 Million to 100 Million",
                      "company_phone": "+15125550100",
                      "company_linkedin_url": "linkedin.com/company/northlinelogistics",
                      "company_address": "400 Commerce Way",
                      "company_city": "Austin",
                      "company_state": "TX",
                      "company_zip": "78744",
                      "company_country": "US",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "contact_country": "US",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "dpv_code": "Y",
                      "gender": "F",
                      "age_range": "45-54",
                      "dob": null,
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "work_history": "Director of Operations, Ridgeway Freight, 2014 to 2019",
                      "education_history": "University of Texas, BS, Business Administration"
                    }
                  ],
                  "credits_used": 1,
                  "credits_remaining": 24811,
                  "limited_by_credits": false
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/exports": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Export a search to a file",
        "operationId": "exportSearchFile",
        "description": "Queues an export of chosen people, or of every match, up to 100,000 rows. Send an Idempotency-Key header so a retry never creates a second export. Answers 202; poll the export until download_ready is true. Cost: 1 credit per new person exported.",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Any stable unique string for this export.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "search_id"
                ],
                "properties": {
                  "search_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The search to export from."
                  },
                  "name": {
                    "type": "string",
                    "description": "A name for the file, up to 80 characters."
                  },
                  "all": {
                    "type": "boolean",
                    "description": "Export every match instead of a list of ids."
                  },
                  "ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Up to 1,000 up_id values to export."
                  },
                  "exclude_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "With all, up to 1,000 up_id values to leave out."
                  },
                  "max_results": {
                    "type": "integer",
                    "description": "Stop after this many rows, 1 to 100,000."
                  }
                }
              },
              "example": {
                "search_id": "3f6c2a8e-1b7d-4c55-9e0a-6d2f8b41c9a7",
                "name": "Texas freight operations leaders",
                "all": true,
                "max_results": 5000
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Export"
                },
                "example": {
                  "id": "c2d8f1a0-7e4b-4b19-a3c5-8f0e6d2b9a41",
                  "name": "Texas freight operations leaders",
                  "status": "queued",
                  "max_results": 5000,
                  "exported_count": 0,
                  "credits_used": 0,
                  "error_code": null,
                  "created_at": "2026-10-27T15:04:05.000000Z",
                  "download_ready": false
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      },
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "List exports",
        "operationId": "listExports",
        "description": "The latest 100 exports with status and counts.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "data": []
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/exports/{export}": {
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "Check an export",
        "operationId": "checkExport",
        "description": "Status is queued, running, done, partial (stopped when credits ran out), failed or canceled.",
        "parameters": [
          {
            "name": "export",
            "in": "path",
            "required": true,
            "description": "The export id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Export"
                },
                "example": {
                  "id": "c2d8f1a0-7e4b-4b19-a3c5-8f0e6d2b9a41",
                  "name": "Texas freight operations leaders",
                  "status": "done",
                  "max_results": 5000,
                  "exported_count": 5000,
                  "credits_used": 4870,
                  "error_code": null,
                  "created_at": "2026-10-27T15:04:05.000000Z",
                  "download_ready": true
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      },
      "delete": {
        "tags": [
          "Lead database"
        ],
        "summary": "Cancel an export",
        "operationId": "cancelExport",
        "description": "Stops a queued or running export.",
        "parameters": [
          {
            "name": "export",
            "in": "path",
            "required": true,
            "description": "The export id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Export"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/exports/{export}/download": {
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "Download an export",
        "operationId": "downloadExport",
        "description": "Streams the file with up_id, cc_id and every field as columns. Pass api_key as a query parameter when a browser does the download.",
        "parameters": [
          {
            "name": "export",
            "in": "path",
            "required": true,
            "description": "The export id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "csv (default) or xlsx.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/parse": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Turn a sentence into criteria",
        "operationId": "turnSentenceIntoCriteria",
        "description": "Describe who you want in plain English and get criteria back to review before you search. Words it cannot map are returned in unmapped and are not applied.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "description"
                ],
                "properties": {
                  "description": {
                    "type": "string",
                    "description": "Up to 2,000 characters."
                  }
                }
              },
              "example": {
                "description": "VPs of operations at trucking companies in Texas with a mobile phone"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "criteria": {
                    "query": "",
                    "filters": {
                      "has_mobile_phone": {
                        "value": true
                      },
                      "primary_industry": {
                        "include": [
                          "Truck Transportation"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "state": {
                        "include": [
                          "TX"
                        ],
                        "exclude": [],
                        "match": "exact"
                      }
                    },
                    "job_titles": {
                      "include": [
                        "VP of operations"
                      ],
                      "exclude": [],
                      "similar": true
                    },
                    "lookup_type": null,
                    "limit": 25
                  },
                  "unmapped": [],
                  "message": "Review the extracted filters before searching. Unmapped words are not applied."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/saved-filters": {
      "post": {
        "tags": [
          "Lead database"
        ],
        "summary": "Save criteria, with an optional schedule",
        "operationId": "saveCriteriaOptionalSchedule",
        "description": "Saves criteria under a name. With a daily or weekly schedule, LeadFuze reruns the search and exports new matches up to max_results.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "criteria"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Up to 80 characters."
                  },
                  "criteria": {
                    "$ref": "#/components/schemas/Criteria"
                  },
                  "schedule": {
                    "type": "string",
                    "description": "daily, weekly or null."
                  },
                  "max_results": {
                    "type": "integer",
                    "description": "Rows per scheduled export, 1 to 100,000."
                  }
                }
              },
              "example": {
                "name": "Texas freight operations leaders",
                "criteria": {
                  "query": "",
                  "job_titles": {
                    "include": [
                      "VP of Operations",
                      "Director of Operations"
                    ],
                    "exclude": [
                      "Assistant"
                    ],
                    "similar": true
                  },
                  "filters": {
                    "primary_industry": {
                      "include": [
                        "Truck Transportation",
                        "Warehousing And Storage"
                      ]
                    },
                    "company_employee_count": {
                      "include": [
                        "101 to 250",
                        "251 to 500"
                      ]
                    },
                    "state": {
                      "include": [
                        "Texas",
                        "OK"
                      ]
                    },
                    "company_description": {
                      "include": [
                        "cold chain"
                      ],
                      "match": "phrase"
                    },
                    "company_domain": {
                      "exclude": [
                        "competitor.com"
                      ]
                    },
                    "mobile_phone": {
                      "presence": "has"
                    },
                    "has_business_email": {
                      "value": true
                    }
                  },
                  "limit": 25
                },
                "schedule": "weekly",
                "max_results": 500
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SavedFilter"
                },
                "example": {
                  "id": "e5a1c7b3-2d9f-4e60-8b14-7a3c0f9d2e58",
                  "name": "Texas freight operations leaders",
                  "criteria": {
                    "query": "",
                    "filters": {
                      "company_description": {
                        "include": [
                          "cold chain"
                        ],
                        "exclude": [],
                        "match": "phrase"
                      },
                      "company_domain": {
                        "include": [],
                        "exclude": [
                          "competitor.com"
                        ],
                        "match": "exact"
                      },
                      "company_employee_count": {
                        "include": [
                          "101 to 250",
                          "251 to 500"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "has_business_email": {
                        "value": true
                      },
                      "mobile_phone": {
                        "include": [],
                        "exclude": [],
                        "match": "exact",
                        "presence": "has"
                      },
                      "primary_industry": {
                        "include": [
                          "Truck Transportation",
                          "Warehousing And Storage"
                        ],
                        "exclude": [],
                        "match": "exact"
                      },
                      "state": {
                        "include": [
                          "TX",
                          "OK"
                        ],
                        "exclude": [],
                        "match": "exact"
                      }
                    },
                    "job_titles": {
                      "include": [
                        "VP of Operations",
                        "Director of Operations"
                      ],
                      "exclude": [
                        "Assistant"
                      ],
                      "similar": true
                    },
                    "lookup_type": null,
                    "limit": 25
                  },
                  "schedule": "weekly",
                  "next_run_at": "2026-11-02T14:00:00Z",
                  "max_results": 500
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      },
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "List saved filters",
        "operationId": "listSavedFilters",
        "description": "Up to 200, newest first, with schedule, next and last run, and last export id.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "data": []
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads-database/searches/{search}": {
      "delete": {
        "tags": [
          "Lead database"
        ],
        "summary": "Close a search",
        "operationId": "closeSearch",
        "description": "Frees its cursors early. Searches also expire on their own.",
        "parameters": [
          {
            "name": "search",
            "in": "path",
            "required": true,
            "description": "The search_id from POST /leads-database/search.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/saved-filters/{saved}": {
      "patch": {
        "tags": [
          "Lead database"
        ],
        "summary": "Update a saved filter",
        "operationId": "updateSavedFilter",
        "description": "Same body as creating one.",
        "parameters": [
          {
            "name": "saved",
            "in": "path",
            "required": true,
            "description": "Saved filter id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SavedFilterInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      },
      "delete": {
        "tags": [
          "Lead database"
        ],
        "summary": "Delete a saved filter",
        "operationId": "deleteSavedFilter",
        "parameters": [
          {
            "name": "saved",
            "in": "path",
            "required": true,
            "description": "Saved filter id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/leads-database/exports/{export}/contacts": {
      "get": {
        "tags": [
          "Lead database"
        ],
        "summary": "Page through exported records as JSON",
        "operationId": "pageThroughExportedRecordsJSON",
        "description": "50 records a page, up to page 2,000.",
        "parameters": [
          {
            "name": "export",
            "in": "path",
            "required": true,
            "description": "The export id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page number, from 1.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "name": "Texas freight operations leaders",
                  "data": [],
                  "total": 5000,
                  "page": 1,
                  "next_page": 2
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/enrichment/email": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Enrich by email",
        "operationId": "enrichEmail",
        "description": "Send a business or personal email and get the full person record, with the company and social objects. One credit per match; no match costs nothing, and the same person again within 30 days is free. Cost: 1 credit per match.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "email"
                ],
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "The email to look up."
                  },
                  "include_company": {
                    "type": "boolean",
                    "description": "Include the company object. Default true."
                  },
                  "include_social": {
                    "type": "boolean",
                    "description": "Include the social object. Default true."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Most profiles to return, 1 to 1,000. Default 100."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page, from 1."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "email": "dana@northlinelogistics.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrichmentResult"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "full_name": "Dana Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "full_address": "1180 Oak Ridge Dr, Round Rock, TX 78681",
                      "gender": "F",
                      "age_range": "45-54",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "dob": null,
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "professional_full_address": "400 Commerce Way, Suite 210, Austin, TX 78744",
                      "business_email_validation_status": "Valid (Esp)",
                      "business_email_last_seen": "2026-10-12",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "personal_emails_last_seen": "2026-09-28",
                      "last_updated": "2026-10-01",
                      "created_at": "2026-10-27T15:04:05.000000Z",
                      "updated_at": "2026-10-27T15:04:05.000000Z",
                      "company": {
                        "name": "Northline Logistics",
                        "domain": "northlinelogistics.com",
                        "phone": "+15125550100",
                        "sic": "4213",
                        "address": "400 Commerce Way",
                        "city": "Austin",
                        "state": "TX",
                        "zip": "78744",
                        "country": "US",
                        "linkedin_url": "linkedin.com/company/northlinelogistics",
                        "revenue": "50 Million to 100 Million",
                        "employee_count": "251 to 500",
                        "primary_industry": "Truck Transportation",
                        "description": "Regional freight and warehousing for retailers",
                        "naics": "484121",
                        "related_domains": "northline.io",
                        "last_updated": "2026-10-01"
                      },
                      "social": {
                        "linkedin_url": "linkedin.com/in/danawhitfield",
                        "social_connections": "500+"
                      }
                    }
                  ],
                  "meta": {
                    "input": "dana@northlinelogistics.com",
                    "search_type": "email",
                    "source": "leadfuze",
                    "result_count": 1,
                    "limit": 100,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  },
                  "credits": {
                    "remaining": 24812,
                    "free_remaining": 0,
                    "paid_remaining": 24812
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/phone": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Enrich by phone",
        "operationId": "enrichPhone",
        "description": "Send a mobile, direct or personal number in any common format. Cost: 1 credit per match.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phone"
                ],
                "properties": {
                  "phone": {
                    "type": "string",
                    "description": "The number. phone_number is accepted too."
                  },
                  "include_company": {
                    "type": "boolean",
                    "description": "Include the company object. Default true."
                  },
                  "include_social": {
                    "type": "boolean",
                    "description": "Include the social object. Default true."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "phone": "(512) 555-0148"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrichmentResult"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "full_name": "Dana Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "full_address": "1180 Oak Ridge Dr, Round Rock, TX 78681",
                      "gender": "F",
                      "age_range": "45-54",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "dob": null,
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "professional_full_address": "400 Commerce Way, Suite 210, Austin, TX 78744",
                      "business_email_validation_status": "Valid (Esp)",
                      "business_email_last_seen": "2026-10-12",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "personal_emails_last_seen": "2026-09-28",
                      "last_updated": "2026-10-01",
                      "created_at": "2026-10-27T15:04:05.000000Z",
                      "updated_at": "2026-10-27T15:04:05.000000Z",
                      "company": {
                        "name": "Northline Logistics",
                        "domain": "northlinelogistics.com",
                        "phone": "+15125550100",
                        "sic": "4213",
                        "address": "400 Commerce Way",
                        "city": "Austin",
                        "state": "TX",
                        "zip": "78744",
                        "country": "US",
                        "linkedin_url": "linkedin.com/company/northlinelogistics",
                        "revenue": "50 Million to 100 Million",
                        "employee_count": "251 to 500",
                        "primary_industry": "Truck Transportation",
                        "description": "Regional freight and warehousing for retailers",
                        "naics": "484121",
                        "related_domains": "northline.io",
                        "last_updated": "2026-10-01"
                      },
                      "social": {
                        "linkedin_url": "linkedin.com/in/danawhitfield",
                        "social_connections": "500+"
                      }
                    }
                  ],
                  "meta": {
                    "input": "15125550148",
                    "search_type": "phone",
                    "source": "leadfuze",
                    "result_count": 1,
                    "limit": 100,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  },
                  "credits": {
                    "remaining": 24812,
                    "free_remaining": 0,
                    "paid_remaining": 24812
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/linkedin": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Enrich by LinkedIn URL",
        "operationId": "enrichLinkedInURL",
        "description": "Send a LinkedIn profile URL. The www and https parts are optional. Cost: 1 credit per match.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "linkedin_url"
                ],
                "properties": {
                  "linkedin_url": {
                    "type": "string",
                    "description": "The profile URL. linkedin is accepted too."
                  },
                  "include_company": {
                    "type": "boolean",
                    "description": "Include the company object. Default true."
                  },
                  "include_social": {
                    "type": "boolean",
                    "description": "Include the social object. Default true."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "linkedin_url": "linkedin.com/in/danawhitfield"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrichmentResult"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "full_name": "Dana Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "full_address": "1180 Oak Ridge Dr, Round Rock, TX 78681",
                      "gender": "F",
                      "age_range": "45-54",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "dob": null,
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "professional_full_address": "400 Commerce Way, Suite 210, Austin, TX 78744",
                      "business_email_validation_status": "Valid (Esp)",
                      "business_email_last_seen": "2026-10-12",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "personal_emails_last_seen": "2026-09-28",
                      "last_updated": "2026-10-01",
                      "created_at": "2026-10-27T15:04:05.000000Z",
                      "updated_at": "2026-10-27T15:04:05.000000Z",
                      "company": {
                        "name": "Northline Logistics",
                        "domain": "northlinelogistics.com",
                        "phone": "+15125550100",
                        "sic": "4213",
                        "address": "400 Commerce Way",
                        "city": "Austin",
                        "state": "TX",
                        "zip": "78744",
                        "country": "US",
                        "linkedin_url": "linkedin.com/company/northlinelogistics",
                        "revenue": "50 Million to 100 Million",
                        "employee_count": "251 to 500",
                        "primary_industry": "Truck Transportation",
                        "description": "Regional freight and warehousing for retailers",
                        "naics": "484121",
                        "related_domains": "northline.io",
                        "last_updated": "2026-10-01"
                      },
                      "social": {
                        "linkedin_url": "linkedin.com/in/danawhitfield",
                        "social_connections": "500+"
                      }
                    }
                  ],
                  "meta": {
                    "input": "linkedin.com/in/danawhitfield",
                    "search_type": "linkedin",
                    "source": "leadfuze",
                    "result_count": 1,
                    "limit": 100,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  },
                  "credits": {
                    "remaining": 24812,
                    "free_remaining": 0,
                    "paid_remaining": 24812
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/domain": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Find people at a company domain",
        "operationId": "findPeopleAtCompanyDomain",
        "description": "Send a domain and get the people who work there, a page at a time. Cost: 1 credit per profile returned.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain"
                ],
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "A company domain, for example northlinelogistics.com."
                  },
                  "include_company": {
                    "type": "boolean",
                    "description": "Include the company object. Default true."
                  },
                  "include_social": {
                    "type": "boolean",
                    "description": "Include the social object. Default true."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Profiles per page, 1 to 1,000. Default 100."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page, from 1."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "domain": "northlinelogistics.com",
                "limit": 25
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrichmentResult"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "full_name": "Dana Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "full_address": "1180 Oak Ridge Dr, Round Rock, TX 78681",
                      "gender": "F",
                      "age_range": "45-54",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "dob": null,
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "professional_full_address": "400 Commerce Way, Suite 210, Austin, TX 78744",
                      "business_email_validation_status": "Valid (Esp)",
                      "business_email_last_seen": "2026-10-12",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "personal_emails_last_seen": "2026-09-28",
                      "last_updated": "2026-10-01",
                      "created_at": "2026-10-27T15:04:05.000000Z",
                      "updated_at": "2026-10-27T15:04:05.000000Z",
                      "company": {
                        "name": "Northline Logistics",
                        "domain": "northlinelogistics.com",
                        "phone": "+15125550100",
                        "sic": "4213",
                        "address": "400 Commerce Way",
                        "city": "Austin",
                        "state": "TX",
                        "zip": "78744",
                        "country": "US",
                        "linkedin_url": "linkedin.com/company/northlinelogistics",
                        "revenue": "50 Million to 100 Million",
                        "employee_count": "251 to 500",
                        "primary_industry": "Truck Transportation",
                        "description": "Regional freight and warehousing for retailers",
                        "naics": "484121",
                        "related_domains": "northline.io",
                        "last_updated": "2026-10-01"
                      },
                      "social": {
                        "linkedin_url": "linkedin.com/in/danawhitfield",
                        "social_connections": "500+"
                      }
                    }
                  ],
                  "meta": {
                    "input": "northlinelogistics.com",
                    "search_type": "domain",
                    "source": "leadfuze",
                    "result_count": 1,
                    "limit": 100,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  },
                  "credits": {
                    "remaining": 24812,
                    "free_remaining": 0,
                    "paid_remaining": 24812
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/profile": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Get a profile by up_id",
        "operationId": "getProfileUpId",
        "description": "Fetch a person you already have the up_id for, from a search, a pixel lead or an earlier lookup. Cost: 1 credit per match.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "up_id"
                ],
                "properties": {
                  "up_id": {
                    "type": "string",
                    "description": "The profile id."
                  },
                  "include_company": {
                    "type": "boolean",
                    "description": "Include the company object. Default true."
                  },
                  "include_social": {
                    "type": "boolean",
                    "description": "Include the social object. Default true."
                  }
                }
              },
              "example": {
                "up_id": "up_8c41d2e7a9"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrichmentResult"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": [
                    {
                      "up_id": "up_8c41d2e7a9",
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "full_name": "Dana Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "personal_emails": "danawhitfield@gmail.com",
                      "additional_personal_emails": "dana.w4@yahoo.com",
                      "programmatic_business_emails": "dana.whitfield@northlinelogistics.com",
                      "mobile_phone": "15125550148",
                      "direct_number": "+15125550190",
                      "personal_phone": "+15125550173",
                      "linkedin_url": "linkedin.com/in/danawhitfield",
                      "personal_address": "1180 Oak Ridge Dr",
                      "personal_address_2": null,
                      "personal_city": "Round Rock",
                      "personal_state": "TX",
                      "personal_zip": "78681",
                      "personal_zip4": "3342",
                      "full_address": "1180 Oak Ridge Dr, Round Rock, TX 78681",
                      "gender": "F",
                      "age_range": "45-54",
                      "income_range": "$150,000 to $199,999",
                      "net_worth": "$500,000 to $749,999",
                      "married": "Y",
                      "children": "Y",
                      "homeowner": "Y",
                      "dob": null,
                      "job_title": "VP of Operations",
                      "seniority_level": "Vp",
                      "department": "Operations",
                      "professional_address": "400 Commerce Way",
                      "professional_address_2": "Suite 210",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "professional_zip": "78744",
                      "professional_zip4": "1207",
                      "professional_full_address": "400 Commerce Way, Suite 210, Austin, TX 78744",
                      "business_email_validation_status": "Valid (Esp)",
                      "business_email_last_seen": "2026-10-12",
                      "personal_emails_validation_status": "Valid (Esp)",
                      "personal_emails_last_seen": "2026-09-28",
                      "last_updated": "2026-10-01",
                      "created_at": "2026-10-27T15:04:05.000000Z",
                      "updated_at": "2026-10-27T15:04:05.000000Z",
                      "company": {
                        "name": "Northline Logistics",
                        "domain": "northlinelogistics.com",
                        "phone": "+15125550100",
                        "sic": "4213",
                        "address": "400 Commerce Way",
                        "city": "Austin",
                        "state": "TX",
                        "zip": "78744",
                        "country": "US",
                        "linkedin_url": "linkedin.com/company/northlinelogistics",
                        "revenue": "50 Million to 100 Million",
                        "employee_count": "251 to 500",
                        "primary_industry": "Truck Transportation",
                        "description": "Regional freight and warehousing for retailers",
                        "naics": "484121",
                        "related_domains": "northline.io",
                        "last_updated": "2026-10-01"
                      },
                      "social": {
                        "linkedin_url": "linkedin.com/in/danawhitfield",
                        "social_connections": "500+"
                      }
                    }
                  ],
                  "meta": {
                    "input": "up_8c41d2e7a9",
                    "search_type": "profile",
                    "source": "leadfuze",
                    "result_count": 1,
                    "limit": 100,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  },
                  "credits": {
                    "remaining": 24812,
                    "free_remaining": 0,
                    "paid_remaining": 24812
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/email/bulk-csv": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Enrich a CSV of emails",
        "operationId": "enrichCSVEmails",
        "description": "Upload a file of emails. The job runs in the background and answers 202 with links to poll and download. Cost: 1 credit per match.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A CSV or TXT file up to 50MB with one value per row. A header row is optional."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "message": "Bulk enrichment job started",
                  "bulk_job_id": "b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03",
                  "total_entries": 12000,
                  "status_url": "https://console.leadfuze.com/api/v1/enrichment/bulk/b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03/status",
                  "download_url": "https://console.leadfuze.com/api/v1/enrichment/bulk/b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03/download",
                  "processing_mode": "async",
                  "note": "Job is processing in background. Poll status_url to track progress."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/enrichment/bulk/{bulkJobId}/status": {
      "get": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Check a bulk job",
        "operationId": "checkBulkJob",
        "description": "Progress and counts for a bulk enrichment job.",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkJobStatus"
                },
                "example": {
                  "success": true,
                  "data": {
                    "bulk_job_id": "b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03",
                    "filename": "webinar-signups.csv",
                    "entry_type": "email",
                    "status": "processing",
                    "total_entries": 12000,
                    "processed_entries": 7400,
                    "progress_percentage": 61.67,
                    "success_count": 5310,
                    "not_found_count": 1980,
                    "invalid_count": 64,
                    "skipped_count": 46,
                    "credits_used": 5310,
                    "error_message": null,
                    "started_at": "2026-10-27T15:04:05.000000Z",
                    "completed_at": null,
                    "created_at": "2026-10-27T15:04:05.000000Z"
                  },
                  "download_url": "https://console.leadfuze.com/api/v1/enrichment/bulk/b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03/download"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/enrichment/linkedin/bulk-csv": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Enrich a CSV of LinkedIn URLs",
        "operationId": "enrichCSVLinkedInURLs",
        "description": "Same as the email version, one URL per row.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A CSV or TXT file up to 50MB with one value per row. A header row is optional."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/enrichment/bulk/{bulkJobId}/download": {
      "get": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Download bulk results",
        "operationId": "downloadBulkResults",
        "description": "A CSV of every input row with the matched fields.",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/enrichment/companies/search": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Search companies",
        "operationId": "searchCompanies",
        "description": "Find companies by domain, name, industry, size or a role they employ. 25 a page by default; pass the search_id or next_cursor back for more.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [],
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Company domain."
                  },
                  "company_name": {
                    "type": "string",
                    "description": "At least 3 characters."
                  },
                  "industry": {
                    "type": "string",
                    "description": "An industry from the catalog."
                  },
                  "role": {
                    "type": "string",
                    "description": "A job title the company employs."
                  },
                  "company_size": {
                    "type": "string",
                    "description": "An employee count range, for example 251 to 500."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "1 to 100."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page, from 1."
                  },
                  "search_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Continue an earlier search."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/enrichment/company": {
      "post": {
        "tags": [
          "Enrichment"
        ],
        "summary": "Company lookup by domain or cc_id",
        "operationId": "companyLookupDomainCcId",
        "description": "Returns a summary of a company and the people on file there, with filter counts, ready to page through.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [],
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Company domain. Send this or cc_id."
                  },
                  "cc_id": {
                    "type": "string",
                    "description": "Company id."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/verification/email": {
      "post": {
        "tags": [
          "Email verification"
        ],
        "summary": "Verify an email",
        "operationId": "verifyEmail",
        "description": "Checks syntax, the mail server and the mailbox, and whether the domain accepts every address (catch-all). Status is valid, risky, invalid or unknown, with a risk level of low, medium or high. Cost: 1 verification credit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "email"
                ],
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "The address to check."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "email": "dana@northlinelogistics.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailVerification"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": {
                    "email": "dana@northlinelogistics.com",
                    "username": "dana",
                    "domain": "northlinelogistics.com",
                    "md5_hash": "5d1f8c0a9e2b7d4f6a3c1e0b9d8f7a6c",
                    "result": {
                      "valid_format": true,
                      "deliverable": true,
                      "full_inbox": false,
                      "host_exists": true,
                      "catch_all": false
                    },
                    "status": "valid",
                    "risk_level": "low"
                  },
                  "meta": {
                    "input": "dana@northlinelogistics.com",
                    "source": "validator",
                    "timestamp": "2026-10-27T15:04:05.000000Z",
                    "response_time_ms": 412
                  },
                  "credits": {
                    "used": 1,
                    "remaining": 9431
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/verification/bulk": {
      "post": {
        "tags": [
          "Email verification"
        ],
        "summary": "Verify up to 100 emails",
        "operationId": "verify100Emails",
        "description": "The same checks for a list, answered in one response. Cost: 1 verification credit per address.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "emails"
                ],
                "properties": {
                  "emails": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "1 to 100 addresses."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "emails": [
                  "dana@northlinelogistics.com",
                  "ops@northlinelogistics.com"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/verification/bulk-csv": {
      "post": {
        "tags": [
          "Email verification"
        ],
        "summary": "Verify a CSV of emails",
        "operationId": "verifyCSVEmails",
        "description": "Upload up to about a million addresses. Large files run in the background; poll the status and download the results. Cost: 1 verification credit per address.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A CSV or TXT file up to 50MB with one value per row. A header row is optional."
                  },
                  "async": {
                    "type": "boolean",
                    "description": "Force background processing for a small file."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "bulk_job_id": "b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03",
                  "status_url": "https://console.leadfuze.com/api/v1/verification/bulk/b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03/status",
                  "download_url": "https://console.leadfuze.com/api/v1/verification/bulk/b7e2a9c4-1f3d-4a8b-9c60-5e2d8f1a7b03/download"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/verification/bulk/{bulkJobId}/status": {
      "get": {
        "tags": [
          "Email verification"
        ],
        "summary": "Check a bulk verification",
        "operationId": "checkBulkVerification",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/verification/bulk/{bulkJobId}/download": {
      "get": {
        "tags": [
          "Email verification"
        ],
        "summary": "Download verification results",
        "operationId": "downloadVerificationResults",
        "description": "A CSV with status and risk level per address.",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/verification/credits": {
      "get": {
        "tags": [
          "Email verification"
        ],
        "summary": "Verification credits left",
        "operationId": "verificationCreditsLeft",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/phone-validation/validate": {
      "post": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Validate a phone number",
        "operationId": "validatePhoneNumber",
        "description": "Parses the number, formats it as E.164, international and national, and tells you the line type, carrier and time zones. Status is valid, risky or invalid. Cost: 1 phone credit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phone_number"
                ],
                "properties": {
                  "phone_number": {
                    "type": "string",
                    "description": "The number in any common format."
                  },
                  "region": {
                    "type": "string",
                    "description": "Two-letter country to assume when the number has no country code. Default US."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "phone_number": "(512) 555-0148",
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneValidation"
                },
                "example": {
                  "success": true,
                  "cached": false,
                  "data": {
                    "phone_number": "(512) 555-0148",
                    "phone_hash": "9f2c7a1e0b8d6f4a",
                    "formatted": {
                      "e164": "+15125550148",
                      "international": "+1 512-555-0148",
                      "national": "(512) 555-0148"
                    },
                    "result": {
                      "is_valid": true,
                      "is_possible": true,
                      "number_type": "Mobile",
                      "number_type_code": 1,
                      "region": "US",
                      "is_valid_for_region": true,
                      "country_code": 1,
                      "national_number": "5125550148"
                    },
                    "status": "valid",
                    "risk_level": "low",
                    "carrier": "Example Wireless",
                    "timezones": [
                      "America/Chicago"
                    ]
                  },
                  "meta": {
                    "input": "(512) 555-0148",
                    "default_region": "US",
                    "source": "libphonenumber",
                    "timestamp": "2026-10-27T15:04:05.000000Z",
                    "response_time_ms": 6
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/phone-validation/bulk": {
      "post": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Validate up to 100 numbers",
        "operationId": "validate100Numbers",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phone_numbers"
                ],
                "properties": {
                  "phone_numbers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "1 to 100 numbers."
                  },
                  "region": {
                    "type": "string",
                    "description": "Default country."
                  },
                  "cache_ttl": {
                    "type": "integer",
                    "description": "Seconds to cache this answer, 60 to 3,600. Default 600. A cached answer costs nothing."
                  }
                }
              },
              "example": {
                "phone_numbers": [
                  "(512) 555-0148",
                  "+1 512 555 0190"
                ],
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      }
    },
    "/phone-validation/bulk-csv": {
      "post": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Validate a CSV of numbers",
        "operationId": "validateCSVNumbers",
        "description": "Runs in the background for large files.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A CSV or TXT file up to 50MB with one value per row. A header row is optional."
                  },
                  "region": {
                    "type": "string",
                    "description": "Default country."
                  },
                  "async": {
                    "type": "boolean",
                    "description": "Force background processing."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/phone-validation/bulk/{bulkJobId}/status": {
      "get": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Check a bulk validation",
        "operationId": "checkBulkValidation",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/phone-validation/bulk/{bulkJobId}/download": {
      "get": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Download validation results",
        "operationId": "downloadValidationResults",
        "parameters": [
          {
            "name": "bulkJobId",
            "in": "path",
            "required": true,
            "description": "The bulk_job_id returned when the job was created.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/phone-validation/credits": {
      "get": {
        "tags": [
          "Phone validation"
        ],
        "summary": "Phone credits left",
        "operationId": "phoneCreditsLeft",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/intent-data/search": {
      "get": {
        "tags": [
          "Intent data"
        ],
        "summary": "Find intent topics",
        "operationId": "findIntentTopics",
        "description": "Search 42,000+ B2B and B2C topics by name. Topics already being scanned for you are left out.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "2 to 255 characters.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": [
                    {
                      "id": 18734,
                      "topic_id": "18734",
                      "topic": "Warehouse Management Systems",
                      "category_type": "b2b"
                    }
                  ],
                  "meta": {
                    "query": "warehouse management",
                    "result_count": 1,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/intent-data": {
      "post": {
        "tags": [
          "Intent data"
        ],
        "summary": "Run an Intent Scan",
        "operationId": "runIntentScan",
        "description": "Request the people researching one or more topics. Each topic uses one Intent Scan from your plan; duplicates of a scan already running are skipped. Cost: 1 Intent Scan per topic.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "categories"
                ],
                "properties": {
                  "categories": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Topics to scan."
                  }
                }
              },
              "example": {
                "categories": [
                  {
                    "topic_id": "18734",
                    "topic": "Warehouse Management Systems",
                    "category_type": "b2b"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "message": "1 intent data request(s) created.",
                  "data": [
                    {
                      "id": 5521,
                      "topic_id": "18734",
                      "category_type": "b2b",
                      "topic": "Warehouse Management Systems",
                      "status": "pending",
                      "created_at": "2026-10-27T15:04:05.000000Z"
                    }
                  ],
                  "meta": {
                    "created_count": 1,
                    "duplicate_count": 0,
                    "credits_remaining": 9,
                    "credits_used_this_month": 1,
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "402": {
            "$ref": "#/components/responses/NoCredits"
          }
        }
      },
      "get": {
        "tags": [
          "Intent data"
        ],
        "summary": "List your scans",
        "operationId": "listScans",
        "description": "Paginated, newest first.",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "pending, done or failed.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "Default 20.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/intent-data/{id}/status": {
      "get": {
        "tags": [
          "Intent data"
        ],
        "summary": "Check a scan",
        "operationId": "checkScan",
        "description": "Status is pending, done or failed. When done, data_urls holds the files to download.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The request id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": {
                    "id": 5521,
                    "topic_id": "18734",
                    "category_type": "b2b",
                    "topic": "Warehouse Management Systems",
                    "status": "done",
                    "data_urls": [
                      {
                        "id": 90211,
                        "file_url": "https://files.leadfuze.com/intent/5521/people.zip",
                        "label": "people.zip"
                      }
                    ],
                    "created_at": "2026-10-27T15:04:05.000000Z",
                    "updated_at": "2026-10-27T15:04:05.000000Z"
                  },
                  "meta": {
                    "timestamp": "2026-10-27T15:04:05.000000Z"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/intent-data/{id}": {
      "get": {
        "tags": [
          "Intent data"
        ],
        "summary": "Get a scan",
        "operationId": "getScan",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The request id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/intent-data/{id}/download": {
      "get": {
        "tags": [
          "Intent data"
        ],
        "summary": "Get download links for a finished scan",
        "operationId": "getDownloadLinksFinishedScan",
        "description": "Answers 400 until the scan is done.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The request id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/intent-data/{id}/retry": {
      "post": {
        "tags": [
          "Intent data"
        ],
        "summary": "Retry a failed scan",
        "operationId": "retryFailedScan",
        "description": "Runs it again without using another Intent Scan.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The request id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Create a pixel project",
        "operationId": "createPixelProject",
        "description": "One project per website. The response includes the tracking code to place on every page of that site.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "url"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "A name you will recognize."
                  },
                  "url": {
                    "type": "string",
                    "format": "url",
                    "description": "The website the pixel runs on."
                  },
                  "status": {
                    "type": "string",
                    "description": "active, inactive or archived."
                  },
                  "user_id": {
                    "type": "integer",
                    "description": "Assign it to one of your users."
                  }
                }
              },
              "example": {
                "name": "Northline Logistics website",
                "url": "https://northlinelogistics.com"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Project"
                },
                "example": {
                  "id": 812,
                  "project_identifier": "leq4k7m2x",
                  "name": "Northline Logistics website",
                  "url": "https://northlinelogistics.com",
                  "status": "active",
                  "is_paid": true,
                  "tracking_code": "<script async type=\"text/javascript\">(function(){window.__idrp=window.__idrp||{};window.__idrp.appId=\"leq4k7m2x\";var leadfuze=window.leadfuze||(window.leadfuze=[]);if(leadfuze.invoked)return;leadfuze.invoked=true;...})();</script>"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      },
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "List projects",
        "operationId": "listProjects",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/projects/{identifier}/leads": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "List identified visitors",
        "operationId": "listIdentifiedVisitors",
        "description": "Everyone the pixel identified on this site, newest first, with the pages they viewed.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "From 1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "1 to 100.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": [
                    {
                      "id": 440193,
                      "first_name": "Dana",
                      "last_name": "Whitfield",
                      "business_email": "dana@northlinelogistics.com",
                      "job_title": "VP of Operations",
                      "professional_city": "Austin",
                      "professional_state": "TX",
                      "created_at": "2026-10-27T15:04:01+00:00"
                    }
                  ],
                  "pagination": {
                    "current_page": 1,
                    "last_page": 37,
                    "per_page": 25,
                    "total": 911,
                    "from": 1,
                    "to": 25
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/webhook/configure": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Send leads to your webhook",
        "operationId": "sendLeadsWebhook",
        "description": "Every new or updated lead is posted to your HTTPS endpoint as JSON. See the event below.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "webhook_url"
                ],
                "properties": {
                  "webhook_url": {
                    "type": "string",
                    "format": "url",
                    "description": "Must start with https://."
                  },
                  "webhook_enabled": {
                    "type": "boolean",
                    "description": "Default true."
                  }
                }
              },
              "example": {
                "webhook_url": "https://hooks.example.com/leadfuze",
                "webhook_enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Get a project",
        "operationId": "getProject",
        "description": "Includes the tracking code and subscription.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      },
      "patch": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Update a project",
        "operationId": "updateProject",
        "description": "Change the name, URL or status, or white-label the script with your own tracking_variable and tracking_slug.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [],
                "properties": {
                  "tracking_variable": {
                    "type": "string",
                    "description": "JavaScript variable name, for example acmeTrack."
                  },
                  "tracking_slug": {
                    "type": "string",
                    "description": "Lowercase script path slug."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/assign": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Assign a project to a user",
        "operationId": "assignProjectUser",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "user_id"
                ],
                "properties": {
                  "user_id": {
                    "type": "integer",
                    "description": "Your user."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/webhook/test": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Send a test event",
        "operationId": "sendTestEvent",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/webhook": {
      "delete": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Remove the webhook",
        "operationId": "removeWebhook",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/webhook/events": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Webhook delivery log",
        "operationId": "webhookDeliveryLog",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/subscription": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Project billing status",
        "operationId": "projectBillingStatus",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      },
      "delete": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Cancel a project subscription",
        "operationId": "cancelProjectSubscription",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/subscribe": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Start billing for a project",
        "operationId": "startBillingProject",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/projects/{identifier}/subscription/resume": {
      "post": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Resume a canceled subscription",
        "operationId": "resumeCanceledSubscription",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "The project_identifier (or numeric id) of the pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/project-leads": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Leads by project id",
        "operationId": "leadsProjectId",
        "parameters": [
          {
            "name": "project_id",
            "in": "query",
            "required": true,
            "description": "Numeric project id.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "1 to 100.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/leads/{id}": {
      "get": {
        "tags": [
          "Identity Resolution Pixel"
        ],
        "summary": "Get one lead",
        "operationId": "getOneLead",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Lead id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/integrations/{type}/configure": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Connect a destination",
        "operationId": "connectDestination",
        "description": "Send a pixel project's leads to a CRM, email tool, Slack or an inbox.",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "One of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse, beehiiv.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "project_identifier"
                ],
                "properties": {
                  "project_identifier": {
                    "type": "string",
                    "description": "The pixel project."
                  },
                  "api_key": {
                    "type": "string",
                    "description": "The destination's API key, where it uses one."
                  },
                  "webhook_url": {
                    "type": "string",
                    "format": "url",
                    "description": "For Slack and similar."
                  },
                  "config": {
                    "type": "object",
                    "description": "Destination settings, such as a list id."
                  },
                  "is_enabled": {
                    "type": "boolean",
                    "description": "Default true."
                  }
                }
              },
              "example": {
                "project_identifier": "leq4k7m2x",
                "api_key": "YOUR_HUBSPOT_PRIVATE_APP_TOKEN",
                "is_enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/integrations": {
      "get": {
        "tags": [
          "Integrations"
        ],
        "summary": "List connected destinations",
        "operationId": "listConnectedDestinations",
        "parameters": [
          {
            "name": "project_identifier",
            "in": "query",
            "required": true,
            "description": "The pixel project.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        }
      }
    },
    "/integrations/{type}/test": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Send a test contact",
        "operationId": "sendTestContact",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "One of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse, beehiiv.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "project_identifier"
                ],
                "properties": {
                  "project_identifier": {
                    "type": "string",
                    "description": "The pixel project."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/integrations/{type}/retry": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Retry failed deliveries",
        "operationId": "retryFailedDeliveries",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "One of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse, beehiiv.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "project_identifier"
                ],
                "properties": {
                  "project_identifier": {
                    "type": "string",
                    "description": "The pixel project."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/integrations/{type}/disconnect": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Disconnect a destination",
        "operationId": "disconnectDestination",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "One of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse, beehiiv.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "project_identifier"
                ],
                "properties": {
                  "project_identifier": {
                    "type": "string",
                    "description": "The pixel project."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/integrations/{type}/send": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Push one contact now",
        "operationId": "pushOneContact",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "One of hubspot, pipedrive, slack, email, brevo, mailchimp, activecampaign, klaviyo, kit, constantcontact, getresponse, beehiiv.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contact"
                ],
                "properties": {
                  "contact": {
                    "type": "object",
                    "description": "The contact to send."
                  },
                  "project_identifier": {
                    "type": "string",
                    "description": "The pixel project."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    }
  },
  "webhooks": {
    "leadEvent": {
      "post": {
        "summary": "A pixel lead was created or updated",
        "tags": [
          "Identity Resolution Pixel"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LeadEvent"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return any 2xx to acknowledge."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Authorization: Bearer YOUR_API_KEY. Create keys in the LeadFuze app."
      },
      "apiKeyQuery": {
        "type": "apiKey",
        "in": "query",
        "name": "api_key",
        "description": "For file downloads opened in a browser."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Missing, invalid or inactive API key.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "success": false,
              "error": "unauthorized",
              "message": "Invalid API key"
            }
          }
        }
      },
      "NoCredits": {
        "description": "Out of credits for this product.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "success": false,
              "error": "insufficient_credits",
              "message": "Insufficient enrichment credits."
            }
          }
        }
      },
      "NotFound": {
        "description": "Not found, or not yours.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "success": false,
              "message": "Export not found."
            }
          }
        }
      },
      "ValidationError": {
        "description": "The request did not pass validation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "message": "Use at most 200 included and excluded values across filters.",
              "errors": {
                "filters": [
                  "Use at most 200 included and excluded values across filters."
                ]
              }
            }
          }
        }
      },
      "RateLimited": {
        "description": "More than 1,000 requests in a minute.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "message": "Too Many Attempts."
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Field-by-field messages on a 422."
          }
        }
      },
      "Credits": {
        "type": "object",
        "properties": {
          "remaining": {
            "type": "integer"
          },
          "free_remaining": {
            "type": "integer"
          },
          "paid_remaining": {
            "type": "integer"
          }
        }
      },
      "Criteria": {
        "type": "object",
        "additionalProperties": false,
        "description": "Who to find. Fields are combined with AND; values inside one include list with OR; any exclude removes a person.",
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 500,
            "default": "",
            "description": "Free text across name, job title, company name, industry, city and state. A complete email, phone, domain or LinkedIn URL runs an exact lookup."
          },
          "lookup_type": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "email",
              "phone",
              "domain",
              "linkedin",
              "id",
              null
            ],
            "description": "Force an exact lookup of query. email checks all five email columns; phone all four phone columns; id uses up_id."
          },
          "job_titles": {
            "$ref": "#/components/schemas/JobTitles"
          },
          "filters": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "state": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Professional state, otherwise company state; uppercase code."
              },
              "country": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Company country, otherwise contact country; uppercase code."
              },
              "industry": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact primary industry text, case insensitive."
              },
              "department": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact department text, case insensitive."
              },
              "seniority": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact seniority level text, case insensitive."
              },
              "company_domain": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact company domain without www."
              },
              "company_size": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact stored employee-count label; not a numeric range."
              },
              "first_name": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_first_name": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether first_name has a usable value."
              },
              "last_name": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_last_name": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether last_name has a usable value."
              },
              "business_email": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_business_email": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether business_email has a usable value."
              },
              "programmatic_business_emails": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_programmatic_business_emails": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether programmatic_business_emails has a usable value."
              },
              "mobile_phone": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_mobile_phone": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether mobile_phone has a usable value."
              },
              "direct_number": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_direct_number": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether direct_number has a usable value."
              },
              "personal_phone": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_phone": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_phone has a usable value."
              },
              "linkedin_url": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_linkedin_url": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether linkedin_url has a usable value."
              },
              "personal_address": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_address": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_address has a usable value."
              },
              "personal_address_2": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_address_2": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_address_2 has a usable value."
              },
              "personal_city": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_city": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_city has a usable value."
              },
              "personal_state": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_state": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_state has a usable value."
              },
              "personal_zip": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_zip": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_zip has a usable value."
              },
              "personal_zip4": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_zip4": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_zip4 has a usable value."
              },
              "personal_emails": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_emails": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_emails has a usable value."
              },
              "additional_personal_emails": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_additional_personal_emails": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether additional_personal_emails has a usable value."
              },
              "gender": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_gender": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether gender has a usable value."
              },
              "age_range": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_age_range": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether age_range has a usable value."
              },
              "income_range": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_income_range": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether income_range has a usable value."
              },
              "net_worth": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_net_worth": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether net_worth has a usable value."
              },
              "married": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_married": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether married has a usable value."
              },
              "children": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_children": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether children has a usable value."
              },
              "homeowner": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_homeowner": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether homeowner has a usable value."
              },
              "dob": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_dob": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether dob has a usable value."
              },
              "job_title": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column. Supports phrase matching."
              },
              "has_job_title": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether job_title has a usable value."
              },
              "seniority_level": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_seniority_level": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether seniority_level has a usable value."
              },
              "has_department": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether department has a usable value."
              },
              "professional_address": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_address": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_address has a usable value."
              },
              "professional_address_2": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_address_2": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_address_2 has a usable value."
              },
              "professional_city": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_city": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_city has a usable value."
              },
              "professional_state": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_state": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_state has a usable value."
              },
              "professional_zip": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_zip": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_zip has a usable value."
              },
              "professional_zip4": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_professional_zip4": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether professional_zip4 has a usable value."
              },
              "company_name": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column. Supports phrase matching."
              },
              "has_company_name": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_name has a usable value."
              },
              "has_company_domain": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_domain has a usable value."
              },
              "company_phone": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_phone": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_phone has a usable value."
              },
              "company_sic": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_sic": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_sic has a usable value."
              },
              "company_address": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_address": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_address has a usable value."
              },
              "company_city": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_city": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_city has a usable value."
              },
              "company_state": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_state": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_state has a usable value."
              },
              "company_zip": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_zip": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_zip has a usable value."
              },
              "company_linkedin_url": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_linkedin_url": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_linkedin_url has a usable value."
              },
              "company_revenue": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_revenue": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_revenue has a usable value."
              },
              "company_employee_count": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_employee_count": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_employee_count has a usable value."
              },
              "primary_industry": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_primary_industry": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether primary_industry has a usable value."
              },
              "business_email_validation_status": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_business_email_validation_status": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether business_email_validation_status has a usable value."
              },
              "personal_emails_validation_status": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_personal_emails_validation_status": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether personal_emails_validation_status has a usable value."
              },
              "work_history": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Phrase search in this source field. Supports phrase matching."
              },
              "has_work_history": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether work_history has a usable value."
              },
              "education_history": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Phrase search in this source field. Supports phrase matching."
              },
              "has_education_history": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether education_history has a usable value."
              },
              "company_description": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Phrase search in this source field. Supports phrase matching."
              },
              "has_company_description": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_description has a usable value."
              },
              "related_domains": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_related_domains": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether related_domains has a usable value."
              },
              "social_connections": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Phrase search in this source field. Supports phrase matching."
              },
              "has_social_connections": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether social_connections has a usable value."
              },
              "dpv_code": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_dpv_code": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether dpv_code has a usable value."
              },
              "company_naics": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_naics": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_naics has a usable value."
              },
              "company_country": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_company_country": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether company_country has a usable value."
              },
              "contact_country": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_contact_country": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether contact_country has a usable value."
              },
              "job_title_normalized": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_job_title_normalized": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether job_title_normalized has a usable value."
              },
              "seniority_level_2": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_seniority_level_2": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether seniority_level_2 has a usable value."
              },
              "department_2": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_department_2": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether department_2 has a usable value."
              },
              "historical_programmatic_emails": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact normalized value from this source column."
              },
              "has_historical_programmatic_emails": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether historical_programmatic_emails has a usable value."
              },
              "has_personal_email": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether any personal_email source field has a usable value."
              },
              "has_any_email": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether any any_email source field has a usable value."
              },
              "has_any_phone": {
                "$ref": "#/components/schemas/AvailabilityFilter",
                "description": "Whether any any_phone source field has a usable value."
              },
              "up_id": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact profile or company id."
              },
              "cc_id": {
                "$ref": "#/components/schemas/FieldCondition",
                "description": "Exact profile or company id."
              }
            },
            "description": "Keyed by catalog field. At most 200 include and exclude values across all filters."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 25,
            "description": "Results per page."
          }
        },
        "example": {
          "query": "",
          "job_titles": {
            "include": [
              "VP of Operations",
              "Director of Operations"
            ],
            "exclude": [
              "Assistant"
            ],
            "similar": true
          },
          "filters": {
            "primary_industry": {
              "include": [
                "Truck Transportation",
                "Warehousing And Storage"
              ]
            },
            "company_employee_count": {
              "include": [
                "101 to 250",
                "251 to 500"
              ]
            },
            "state": {
              "include": [
                "Texas",
                "OK"
              ]
            },
            "company_description": {
              "include": [
                "cold chain"
              ],
              "match": "phrase"
            },
            "company_domain": {
              "exclude": [
                "competitor.com"
              ]
            },
            "mobile_phone": {
              "presence": "has"
            },
            "has_business_email": {
              "value": true
            }
          },
          "limit": 25
        }
      },
      "FieldCondition": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            },
            "description": "Keep people whose value matches any of these."
          },
          "exclude": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            },
            "description": "Remove people whose value matches any of these. A person with no value passes an exclude-only rule."
          },
          "match": {
            "type": "string",
            "enum": [
              "exact",
              "phrase"
            ],
            "description": "exact compares the whole value, ignoring case. phrase finds whole words inside the text and works on job_title, company_name, work_history, education_history, company_description, social_connections. Default phrase for work_history, education_history, company_description, social_connections, exact for the rest."
          },
          "presence": {
            "type": "string",
            "enum": [
              "has",
              "missing"
            ],
            "description": "Only people with this field on file, or only people without it."
          }
        }
      },
      "AvailabilityFilter": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "value"
        ],
        "properties": {
          "value": {
            "type": "boolean"
          }
        },
        "description": "true keeps people with the field on file; false keeps people without it."
      },
      "JobTitles": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Whole words or phrases matched inside job_title. Any one is enough."
          },
          "exclude": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Remove titles containing any of these. Overrides include."
          },
          "similar": {
            "type": "boolean",
            "default": true,
            "description": "Also match common variants: CEO and Chief Executive Officer, VP of X and Vice President of X, Founder and Co-Founder. At most 20 titles after expansion."
          }
        }
      },
      "CatalogField": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "group": {
            "type": "string",
            "enum": [
              "Person and work",
              "Company",
              "Location and personal",
              "Contact availability",
              "Identifiers"
            ]
          },
          "boolean": {
            "type": "boolean"
          },
          "phrase": {
            "type": "boolean"
          },
          "presence": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "example": {},
          "choices": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Catalog": {
        "type": "object",
        "properties": {
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogField"
            }
          },
          "credits_remaining": {
            "type": "integer"
          },
          "max_export": {
            "type": "integer"
          }
        }
      },
      "CountResult": {
        "type": "object",
        "properties": {
          "total": {
            "type": [
              "integer",
              "null"
            ]
          },
          "total_is_exact": {
            "type": "boolean"
          }
        }
      },
      "LeadPreview": {
        "type": "object",
        "description": "Who the person is and which contact details are on file. Never contains contact values.",
        "properties": {
          "up_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "first_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "job_title": {
            "type": [
              "string",
              "null"
            ]
          },
          "seniority_level": {
            "type": [
              "string",
              "null"
            ]
          },
          "department": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_employee_count": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_revenue": {
            "type": [
              "string",
              "null"
            ]
          },
          "primary_industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "on_file": {
            "type": "object",
            "additionalProperties": {
              "type": "boolean"
            }
          },
          "verified_business_email": {
            "type": "boolean"
          }
        }
      },
      "SearchPage": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "search_id": {
            "type": "string",
            "format": "uuid"
          },
          "criteria": {
            "$ref": "#/components/schemas/Criteria"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeadPreview"
            }
          },
          "total": {
            "type": [
              "integer",
              "null"
            ]
          },
          "total_is_exact": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "cursor_expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      },
      "LeadRecord": {
        "type": "object",
        "description": "A full lead database record: up_id, cc_id and the 60 data fields.",
        "properties": {
          "up_id": {
            "type": "string",
            "description": "Profile id."
          },
          "cc_id": {
            "type": "string",
            "description": "Company id."
          },
          "first_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "First name (Person).",
            "examples": [
              "Dana"
            ]
          },
          "last_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Last name (Person).",
            "examples": [
              "Whitfield"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "LinkedIn URL (Person).",
            "examples": [
              "linkedin.com/in/danawhitfield"
            ]
          },
          "social_connections": {
            "type": [
              "string",
              "null"
            ],
            "description": "Social connections (Person).",
            "examples": [
              "500+"
            ]
          },
          "job_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Job title (Job).",
            "examples": [
              "VP of Operations"
            ]
          },
          "job_title_normalized": {
            "type": [
              "string",
              "null"
            ],
            "description": "Job title normalized (Job).",
            "examples": [
              "vice president of operations"
            ]
          },
          "seniority_level": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seniority level (Job).",
            "examples": [
              "Vp"
            ]
          },
          "seniority_level_2": {
            "type": [
              "string",
              "null"
            ],
            "description": "Seniority level 2 (Job).",
            "examples": [
              "vice president"
            ]
          },
          "department": {
            "type": [
              "string",
              "null"
            ],
            "description": "Department (Job).",
            "examples": [
              "Operations"
            ]
          },
          "department_2": {
            "type": [
              "string",
              "null"
            ],
            "description": "Department 2 (Job).",
            "examples": [
              "operations"
            ]
          },
          "business_email": {
            "type": [
              "string",
              "null"
            ],
            "description": "Business email (Contact).",
            "examples": [
              "dana@northlinelogistics.com"
            ]
          },
          "business_email_validation_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Business email validation status (Contact).",
            "examples": [
              "Valid (Esp)"
            ]
          },
          "programmatic_business_emails": {
            "type": [
              "string",
              "null"
            ],
            "description": "Programmatic business emails (Contact).",
            "examples": [
              "dana.whitfield@northlinelogistics.com"
            ]
          },
          "historical_programmatic_emails": {
            "type": [
              "string",
              "null"
            ],
            "description": "Historical programmatic emails (Contact).",
            "examples": [
              "dwhitfield@ridgewayfreight.com"
            ]
          },
          "mobile_phone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mobile phone (Contact).",
            "examples": [
              "15125550148"
            ]
          },
          "direct_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Direct number (Contact).",
            "examples": [
              "+15125550190"
            ]
          },
          "personal_phone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal phone (Contact).",
            "examples": [
              "+15125550173"
            ]
          },
          "personal_emails": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal emails (Contact).",
            "examples": [
              "danawhitfield@gmail.com"
            ]
          },
          "additional_personal_emails": {
            "type": [
              "string",
              "null"
            ],
            "description": "Additional personal emails (Contact).",
            "examples": [
              "dana.w4@yahoo.com"
            ]
          },
          "personal_emails_validation_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal emails validation status (Contact).",
            "examples": [
              "Valid (Esp)"
            ]
          },
          "company_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company name (Company).",
            "examples": [
              "Northline Logistics"
            ]
          },
          "company_domain": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company domain (Company).",
            "examples": [
              "northlinelogistics.com"
            ]
          },
          "related_domains": {
            "type": [
              "string",
              "null"
            ],
            "description": "Related domains (Company).",
            "examples": [
              "northline.io"
            ]
          },
          "company_description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company description (Company).",
            "examples": [
              "Regional freight and warehousing for retailers"
            ]
          },
          "primary_industry": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary industry (Company).",
            "examples": [
              "Truck Transportation"
            ]
          },
          "company_sic": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company SIC (Company).",
            "examples": [
              "4213"
            ]
          },
          "company_naics": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company NAICS (Company).",
            "examples": [
              "484121"
            ]
          },
          "company_employee_count": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company employee count (Company).",
            "examples": [
              "251 to 500"
            ]
          },
          "company_revenue": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company revenue (Company).",
            "examples": [
              "50 Million to 100 Million"
            ]
          },
          "company_phone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company phone (Company).",
            "examples": [
              "+15125550100"
            ]
          },
          "company_linkedin_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company LinkedIn URL (Company).",
            "examples": [
              "linkedin.com/company/northlinelogistics"
            ]
          },
          "company_address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company address (Company).",
            "examples": [
              "400 Commerce Way"
            ]
          },
          "company_city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company city (Company).",
            "examples": [
              "Austin"
            ]
          },
          "company_state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company state (Company).",
            "examples": [
              "TX"
            ]
          },
          "company_zip": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company ZIP (Company).",
            "examples": [
              "78744"
            ]
          },
          "company_country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Company country (Company).",
            "examples": [
              "US"
            ]
          },
          "professional_address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional address (Work address).",
            "examples": [
              "400 Commerce Way"
            ]
          },
          "professional_address_2": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional address 2 (Work address).",
            "examples": [
              "Suite 210"
            ]
          },
          "professional_city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional city (Work address).",
            "examples": [
              "Austin"
            ]
          },
          "professional_state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional state (Work address).",
            "examples": [
              "TX"
            ]
          },
          "professional_zip": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional ZIP (Work address).",
            "examples": [
              "78744"
            ]
          },
          "professional_zip4": {
            "type": [
              "string",
              "null"
            ],
            "description": "Professional ZIP4 (Work address).",
            "examples": [
              "1207"
            ]
          },
          "contact_country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contact country (Work address).",
            "examples": [
              "US"
            ]
          },
          "personal_address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal address (Home address).",
            "examples": [
              "1180 Oak Ridge Dr"
            ]
          },
          "personal_address_2": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal address 2 (Home address).",
            "examples": []
          },
          "personal_city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal city (Home address).",
            "examples": [
              "Round Rock"
            ]
          },
          "personal_state": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal state (Home address).",
            "examples": [
              "TX"
            ]
          },
          "personal_zip": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal ZIP (Home address).",
            "examples": [
              "78681"
            ]
          },
          "personal_zip4": {
            "type": [
              "string",
              "null"
            ],
            "description": "Personal ZIP4 (Home address).",
            "examples": [
              "3342"
            ]
          },
          "dpv_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "DPV code (Home address).",
            "examples": [
              "Y"
            ]
          },
          "gender": {
            "type": [
              "string",
              "null"
            ],
            "description": "Gender (Household).",
            "examples": [
              "F"
            ]
          },
          "age_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "Age range (Household).",
            "examples": [
              "45-54"
            ]
          },
          "dob": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date of birth (Household).",
            "examples": []
          },
          "married": {
            "type": [
              "string",
              "null"
            ],
            "description": "Married (Household).",
            "examples": [
              "Y"
            ]
          },
          "children": {
            "type": [
              "string",
              "null"
            ],
            "description": "Children (Household).",
            "examples": [
              "Y"
            ]
          },
          "homeowner": {
            "type": [
              "string",
              "null"
            ],
            "description": "Homeowner (Household).",
            "examples": [
              "Y"
            ]
          },
          "income_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "Income range (Household).",
            "examples": [
              "$150,000 to $199,999"
            ]
          },
          "net_worth": {
            "type": [
              "string",
              "null"
            ],
            "description": "Net worth (Household).",
            "examples": [
              "$500,000 to $749,999"
            ]
          },
          "work_history": {
            "type": [
              "string",
              "null"
            ],
            "description": "Work history (History).",
            "examples": [
              "Director of Operations, Ridgeway Freight, 2014 to 2019"
            ]
          },
          "education_history": {
            "type": [
              "string",
              "null"
            ],
            "description": "Education history (History).",
            "examples": [
              "University of Texas, BS, Business Administration"
            ]
          }
        }
      },
      "RevealResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeadRecord"
            }
          },
          "credits_used": {
            "type": "integer"
          },
          "credits_remaining": {
            "type": "integer"
          },
          "limited_by_credits": {
            "type": "boolean"
          }
        }
      },
      "Export": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "done",
              "partial",
              "failed",
              "canceled"
            ]
          },
          "max_results": {
            "type": "integer"
          },
          "exported_count": {
            "type": "integer"
          },
          "credits_used": {
            "type": "integer"
          },
          "error_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "download_ready": {
            "type": "boolean"
          }
        }
      },
      "SavedFilterInput": {
        "type": "object",
        "required": [
          "name",
          "criteria"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80
          },
          "criteria": {
            "$ref": "#/components/schemas/Criteria"
          },
          "schedule": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "daily",
              "weekly",
              null
            ]
          },
          "max_results": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000
          }
        }
      },
      "SavedFilter": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "criteria": {
            "$ref": "#/components/schemas/Criteria"
          },
          "schedule": {
            "type": [
              "string",
              "null"
            ]
          },
          "next_run_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "max_results": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "Company": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "sic": {
            "type": [
              "string",
              "null"
            ]
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "zip": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "revenue": {
            "type": [
              "string",
              "null"
            ]
          },
          "employee_count": {
            "type": [
              "string",
              "null"
            ]
          },
          "primary_industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "naics": {
            "type": [
              "string",
              "null"
            ]
          },
          "related_domains": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_updated": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Profile": {
        "type": "object",
        "description": "A person from the enrichment API. Company fields are nested under company and LinkedIn data under social.",
        "properties": {
          "up_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "first_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "full_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "business_email": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_emails": {
            "type": [
              "string",
              "null"
            ]
          },
          "additional_personal_emails": {
            "type": [
              "string",
              "null"
            ]
          },
          "programmatic_business_emails": {
            "type": [
              "string",
              "null"
            ]
          },
          "mobile_phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "direct_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_address_2": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_zip": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_zip4": {
            "type": [
              "string",
              "null"
            ]
          },
          "full_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "gender": {
            "type": [
              "string",
              "null"
            ]
          },
          "age_range": {
            "type": [
              "string",
              "null"
            ]
          },
          "income_range": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_worth": {
            "type": [
              "string",
              "null"
            ]
          },
          "married": {
            "type": [
              "string",
              "null"
            ]
          },
          "children": {
            "type": [
              "string",
              "null"
            ]
          },
          "homeowner": {
            "type": [
              "string",
              "null"
            ]
          },
          "dob": {
            "type": [
              "string",
              "null"
            ]
          },
          "job_title": {
            "type": [
              "string",
              "null"
            ]
          },
          "seniority_level": {
            "type": [
              "string",
              "null"
            ]
          },
          "department": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_address_2": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_zip": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_zip4": {
            "type": [
              "string",
              "null"
            ]
          },
          "professional_full_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "business_email_validation_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "business_email_last_seen": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_emails_validation_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "personal_emails_last_seen": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_updated": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "$ref": "#/components/schemas/Company"
          },
          "social": {
            "type": "object",
            "properties": {
              "linkedin_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "social_connections": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "EnrichmentResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "cached": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Profile"
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "input": {
                "type": "string"
              },
              "search_type": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "result_count": {
                "type": "integer"
              },
              "limit": {
                "type": "integer"
              },
              "timestamp": {
                "type": "string"
              }
            }
          },
          "credits": {
            "$ref": "#/components/schemas/Credits"
          }
        }
      },
      "BulkJobStatus": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "bulk_job_id": {
                "type": "string"
              },
              "filename": {
                "type": "string"
              },
              "entry_type": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "total_entries": {
                "type": "integer"
              },
              "processed_entries": {
                "type": "integer"
              },
              "progress_percentage": {
                "type": "number"
              },
              "success_count": {
                "type": "integer"
              },
              "not_found_count": {
                "type": "integer"
              },
              "invalid_count": {
                "type": "integer"
              },
              "skipped_count": {
                "type": "integer"
              },
              "credits_used": {
                "type": "integer"
              },
              "error_message": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "started_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "completed_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "created_at": {
                "type": "string"
              }
            }
          },
          "download_url": {
            "type": "string"
          }
        }
      },
      "EmailVerification": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "cached": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "email": {
                "type": "string"
              },
              "username": {
                "type": "string"
              },
              "domain": {
                "type": "string"
              },
              "md5_hash": {
                "type": "string"
              },
              "result": {
                "type": "object",
                "properties": {
                  "valid_format": {
                    "type": "boolean"
                  },
                  "deliverable": {
                    "type": "boolean"
                  },
                  "full_inbox": {
                    "type": "boolean"
                  },
                  "host_exists": {
                    "type": "boolean"
                  },
                  "catch_all": {
                    "type": "boolean"
                  }
                }
              },
              "status": {
                "type": "string",
                "enum": [
                  "valid",
                  "risky",
                  "invalid",
                  "unknown"
                ]
              },
              "risk_level": {
                "type": "string",
                "enum": [
                  "low",
                  "medium",
                  "high"
                ]
              }
            }
          }
        }
      },
      "PhoneValidation": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "cached": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "phone_number": {
                "type": "string"
              },
              "formatted": {
                "type": "object",
                "properties": {
                  "e164": {
                    "type": "string"
                  },
                  "international": {
                    "type": "string"
                  },
                  "national": {
                    "type": "string"
                  }
                }
              },
              "result": {
                "type": "object",
                "properties": {
                  "is_valid": {
                    "type": "boolean"
                  },
                  "is_possible": {
                    "type": "boolean"
                  },
                  "number_type": {
                    "type": "string",
                    "enum": [
                      "Fixed Line",
                      "Mobile",
                      "Fixed Line or Mobile",
                      "Toll Free",
                      "Premium Rate",
                      "Shared Cost",
                      "VoIP",
                      "Personal Number",
                      "Pager",
                      "UAN",
                      "Voicemail",
                      "Unknown"
                    ]
                  },
                  "region": {
                    "type": "string"
                  },
                  "is_valid_for_region": {
                    "type": "boolean"
                  },
                  "country_code": {
                    "type": "integer"
                  },
                  "national_number": {
                    "type": "string"
                  }
                }
              },
              "status": {
                "type": "string",
                "enum": [
                  "valid",
                  "risky",
                  "invalid"
                ]
              },
              "risk_level": {
                "type": "string",
                "enum": [
                  "low",
                  "medium",
                  "high"
                ]
              },
              "carrier": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "timezones": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "Project": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "project_identifier": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive",
              "archived"
            ]
          },
          "is_paid": {
            "type": "boolean"
          },
          "tracking_code": {
            "type": "string"
          }
        }
      },
      "LeadEvent": {
        "type": "object",
        "description": "Posted to your webhook with X-Event-Type and, when a secret is set, X-Webhook-Signature (HMAC-SHA256 of the body).",
        "properties": {
          "event": {
            "type": "string",
            "enum": [
              "lead.created",
              "lead.updated"
            ]
          },
          "timestamp": {
            "type": "string"
          },
          "project_id": {
            "type": "integer"
          },
          "lead": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "email": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "ip": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "first_name": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "last_name": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "business_email": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_email": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "mobile_phone": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_phone": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "direct_number": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "job_title": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "department": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_address": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_city": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_state": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "personal_zip": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "professional_address": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "professional_city": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "professional_state": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "professional_zip": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "gender": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "age_range": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "marital_status": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "children": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "income_range": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "net_worth": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "created_at": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              },
              "updated_at": {
                "type": [
                  "string",
                  "integer",
                  "null"
                ]
              }
            }
          }
        },
        "example": {
          "event": "lead.created",
          "timestamp": "2026-10-27T15:04:05+00:00",
          "project_id": 812,
          "lead": {
            "id": 440193,
            "email": "dana@northlinelogistics.com",
            "ip": "203.0.113.24",
            "first_name": "Dana",
            "last_name": "Whitfield",
            "business_email": "dana@northlinelogistics.com",
            "personal_email": "danawhitfield@gmail.com",
            "mobile_phone": "15125550148",
            "personal_phone": "+15125550173",
            "direct_number": "+15125550190",
            "job_title": "VP of Operations",
            "department": "Operations",
            "personal_address": "1180 Oak Ridge Dr",
            "personal_city": "Round Rock",
            "personal_state": "TX",
            "personal_zip": "78681",
            "professional_address": "400 Commerce Way",
            "professional_city": "Austin",
            "professional_state": "TX",
            "professional_zip": "78744",
            "gender": "F",
            "age_range": "45-54",
            "marital_status": "Married",
            "children": "Y",
            "income_range": "$150,000 to $199,999",
            "net_worth": "$500,000 to $749,999",
            "created_at": "2026-10-27T15:04:01+00:00",
            "updated_at": "2026-10-27T15:04:01+00:00"
          }
        }
      }
    }
  }
}
