{
    "openapi": "3.0.1",
    "info": {
        "title": "Tomba",
        "description": "The Tomba API provides programmatic access to email discovery, verification, enrichment, and company intelligence workflows. Find professional emails, validate deliverability, retrieve sources, and automate prospecting at scale using simple REST endpoints.\n\n## Getting Started\n\nTo begin, send authenticated requests using your API credentials in the request headers. Start with domain search or email finder, then verify addresses and enrich contacts as needed for your workflow.\n\n```sh\ncurl -X GET 'https://api.tomba.io/v1/email-finder?domain=tomba.io&first_name=emily&last_name=harris' \\\n  -H \"X-Tomba-Key: your_api_key\" \\\n  -H \"X-Tomba-Secret: your_api_secret\"\n```\n\n## Rate Limits\n\n| Plan       | Requests/min | Burst |\n|------------|-------------|-------|\n| Free       | 60          | 10    |\n| Pro        | 600         | 50    |\n| Enterprise | Custom      | Custom|\n\nRate limit details are documented at [Rate Limits](https://docs.tomba.io/rate-limits). If you need higher throughput, upgrade your plan.\n\n### Rate Limit Headers\n\nEach API response includes these headers:\n\n- `X-RateLimit-Limit`: Total requests allowed in the current window (example: `15`)\n- `X-RateLimit-Remaining`: Requests left in the current window (example: `14`)\n- `X-RateLimit-Reset`: Seconds until the limit resets (example: `1`)\n\nWhen `X-RateLimit-Remaining` reaches `0`, the next request returns `429 Too Many Requests` until the reset window expires.\n\n## Authentication\n\nAll endpoints require both authentication headers: `X-Tomba-Key` and `X-Tomba-Secret`. Requests without valid credentials return unauthorized errors.\n\n## Versioning\n\nThe current stable API base URL is `https://api.tomba.io/v1`. Backward-compatible improvements may be released without changing the major version path.\n\n## Support\n\nFor questions, troubleshooting, or integration help, contact support at [info@tomba.io](mailto:info@tomba.io) or visit the documentation at https://docs.tomba.io.",
        "termsOfService": "https://tomba.io/privacy-policy",
        "contact": {
            "name": "Tomba technology web service LLC",
            "url": "https://tomba.io",
            "email": "info@tomba.io"
        },
        "license": {
            "name": "Apache 2.0",
            "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
        },
        "version": "1.0.0"
    },
    "externalDocs": {
        "description": "Developers - Full API docs",
        "url": "https://docs.tomba.io"
    },
    "tags": [
        {
            "name": "Domain Suggestions",
            "description": "Discover similar companies and related domains",
            "externalDocs": {
                "description": "Find out more about domain suggestions",
                "url": "https://docs.tomba.io/api/domain-suggestions#get-domain-suggestions"
            }
        },
        {
            "name": "Reveal",
            "description": "Company search and discovery operations"
        },
        {
            "name": "Account",
            "description": "Account details, credits, and workspace settings"
        },
        {
            "name": "Finder",
            "description": "Find professional emails by domain, name, or source"
        },
        {
            "name": "Verifier",
            "description": "Validate email deliverability and mailbox status"
        },
        {
            "name": "Phone",
            "description": "Find and validate phone numbers for contacts"
        },
        {
            "name": "Bulks",
            "description": "Create, launch, and download bulk processing jobs"
        },
        {
            "name": "Enrichment",
            "description": "Enrich people and company data with additional signals"
        },
        {
            "name": "Leads",
            "description": "Manage leads and prospect records"
        },
        {
            "name": "Lead Attributes",
            "description": "Define and retrieve custom lead attributes"
        },
        {
            "name": "Lead Lists",
            "description": "Create and organize lead lists"
        },
        {
            "name": "Keys",
            "description": "Manage API keys and access credentials"
        }
    ],
    "security": [
        {
            "Tomba-Api-Key": [],
            "Tomba-Api-Secret": []
        }
    ],
    "servers": [
        {
            "url": "https://api.tomba.io/v1",
            "description": "Production server"
        }
    ],
    "paths": {
        "/me": {
            "get": {
                "tags": ["Account"],
                "summary": "Get Account",
                "description": "Returns information about the current account.",
                "operationId": "Account",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Account information retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Account"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized - Invalid or missing API key",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/reveal/search": {
            "post": {
                "summary": "Search Companies",
                "description": "Search for companies using natural language queries or structured filters. The AI assistant will automatically generate appropriate filters from your query.",
                "operationId": "searchCompanies",
                "tags": ["Reveal"],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RevealSearchRequest"
                            },
                            "examples": {
                                "naturalLanguageQuery": {
                                    "summary": "Natural language query",
                                    "description": "Search using natural language - AI will generate filters automatically. The generated filters are returned in the meta.filters field of the response",
                                    "value": {
                                        "query": "Real Estate Agency in Europe",
                                        "page": 1
                                    }
                                },
                                "structuredFilters": {
                                    "summary": "Structured filters",
                                    "description": "Search using predefined filters",
                                    "value": {
                                        "filters": {
                                            "industry": {
                                                "include": [
                                                    "technology",
                                                    "software"
                                                ]
                                            },
                                            "location_country": {
                                                "include": ["US"]
                                            },
                                            "location_state": {
                                                "include": ["california"]
                                            },
                                            "size": {
                                                "include": ["101-500"]
                                            }
                                        },
                                        "page": 1
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful search response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RevealSearchResponse"
                                },
                                "example": {
                                    "success": true,
                                    "data": {
                                        "companies": [
                                            {
                                                "name": "TechCorp Inc",
                                                "description": "Leading software development company",
                                                "country": "US",
                                                "state": "California",
                                                "city": "San Francisco",
                                                "street_address": "123 Tech Street",
                                                "postal_code": "94105",
                                                "industry": "Technology",
                                                "company_size": "101-500",
                                                "type": "Private",
                                                "founded": "2015",
                                                "website_url": "https://techcorp.com",
                                                "total_emails": 150,
                                                "revenue": "$10M-$50M",
                                                "phone_number": true,
                                                "linkedin_url": "https://linkedin.com/company/techcorp",
                                                "facebook_url": "https://facebook.com/techcorp",
                                                "twitter_url": "https://twitter.com/techcorp",
                                                "total_similar": 25
                                            }
                                        ],
                                        "total": 1250,
                                        "page": 1,
                                        "limit": 50,
                                        "pages": 25
                                    },
                                    "meta": {
                                        "total": 1250,
                                        "page": 1,
                                        "limit": 50,
                                        "pages": 25,
                                        "filters": {
                                            "location_country": {
                                                "include": ["US"],
                                                "exclude": []
                                            },
                                            "location_state": {
                                                "include": ["California"],
                                                "exclude": []
                                            },
                                            "industry": {
                                                "include": ["Technology"],
                                                "exclude": []
                                            },
                                            "size": {
                                                "include": ["101-500"],
                                                "exclude": []
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request - Invalid query or filter combination",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Unprocessable Entity - Validation errors",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Too Many Requests - Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "402": {
                        "description": "Payment Required - Insufficient credits",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/domain-search": {
            "get": {
                "tags": ["Finder"],
                "summary": "Domain Search",
                "description": "[Domain Search](https://tomba.io/domain-search)\n Search emails are based on the website You give one domain name and it returns all the email addresses found on the internet.",
                "operationId": "DomainSearch",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "Domain name from which you want to find the email addresses. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "stripe.com"
                    },
                    {
                        "name": "company",
                        "in": "query",
                        "description": "The company name from which you want to find the email addresses. For example, \"stripe\". Note that providing the domain name gives better results as it removes the conversion from the company name. If you send a request with both the domain and the company name, the domain name will be used. The company name doesn't need to be in lowercase.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "minLength": 3,
                            "maxLength": 75
                        },
                        "example": "Stripe"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Specifies the number of email addresses to skip. The default is 1. `Premium only`.",
                        "schema": {
                            "type": "integer",
                            "format": "int32",
                            "default": 1
                        },
                        "example": 10
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Specifies the max number of email addresses to return. `Premium only`.",
                        "schema": {
                            "type": "string",
                            "enum": ["10", "20", "50"],
                            "default": "10"
                        },
                        "example": "20"
                    },
                    {
                        "name": "country",
                        "in": "query",
                        "description": "two-letter country code of the country from which you want to find the email addresses. For example, \"US\"",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "US"
                    },
                    {
                        "name": "department",
                        "in": "query",
                        "description": "Get only email addresses for people working in the selected department(s).",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "engineering",
                                "sales",
                                "finance",
                                "hr",
                                "it",
                                "marketing",
                                "operations",
                                "management",
                                "executive",
                                "legal",
                                "support",
                                "communication",
                                "software",
                                "security",
                                "pr",
                                "warehouse",
                                "diversity",
                                "administrative",
                                "facilities",
                                "accounting"
                            ]
                        },
                        "example": "pr"
                    },
                    {
                        "name": "enrich_mobile",
                        "in": "query",
                        "description": "Set to true to get the phone number associated with the email address found.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email addresses found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DomainSearch"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/email-finder": {
            "get": {
                "tags": ["Finder"],
                "summary": "Email Finder",
                "description": "[Email Finder](https://tomba.io/email-finder)\n generates or retrieves the most likely email address from a domain name, a first name and a last name.",
                "operationId": "EmailFinder",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "Domain name from which you want to find the email addresses. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "stripe.com"
                    },
                    {
                        "name": "company",
                        "in": "query",
                        "description": "The company name from which you want to find the email addresses. For example, \"stripe\". Note that providing the domain name gives better results as it removes the conversion from the company name. If you send a request with both the domain and the company name, the domain name will be used. The company name doesn't need to be in lowercase.",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "minLength": 3,
                            "maxLength": 75
                        },
                        "example": "Stripe"
                    },
                    {
                        "name": "full_name",
                        "in": "query",
                        "description": "The person's full name. It doesn't need to be in lowercase.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "John Dustin"
                    },
                    {
                        "name": "first_name",
                        "in": "query",
                        "description": "The person's first name. It doesn't need to be in lowercase.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "John"
                    },
                    {
                        "name": "last_name",
                        "in": "query",
                        "description": "The person's last name. It doesn't need to be in lowercase.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "Dustin"
                    },
                    {
                        "name": "enrich_mobile",
                        "in": "query",
                        "description": "Set to true to get the phone number associated with the email address found.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email address found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/email-verifier": {
            "get": {
                "tags": ["Verifier"],
                "summary": "Email Verifier",
                "description": "[Email Verifier](https://tomba.io/email-verifier)\n verify the deliverability of an email address.",
                "operationId": "EmailVerifier",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address you want to verify.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    },
                    {
                        "name": "enrich_mobile",
                        "in": "query",
                        "description": "Set to true to get the phone number associated with the email address found.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email verification completed successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailVerifier"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/phone-finder": {
            "get": {
                "tags": ["Phone"],
                "summary": "Phone Finder",
                "description": "[Phone Finder](https://tomba.io/phone-finder) helps you search for phone numbers based on an email, domain, or LinkedIn URL. Provide one of these parameters to retrieve associated phone data.",
                "operationId": "PhoneFinder",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address you want to find phone.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": " Domain name from which you want to find the phone numbers. For example, `stripe.com`",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    },
                    {
                        "name": "linkedin",
                        "in": "query",
                        "description": "The URL of the Linkedin. For example, `https://www.linkedin.com/in/alex-maccaw-ab592978`.",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "https://www.linkedin.com/in/alex-maccaw-ab592978"
                    },
                    {
                        "name": "full",
                        "in": "query",
                        "description": "Set to true to get the array of all phone numbers associated with the email or domain or LinkedIn URL provided.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Phone number found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PhoneFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/phone-validator": {
            "get": {
                "tags": ["Phone"],
                "summary": "Phone validator",
                "description": "[Phone validator](https://tomba.io/phone-validator) allows you to validate a phone number and retrieve its associated information.",
                "operationId": "PhoneValidator",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "phone",
                        "in": "query",
                        "description": "The phone number you want to validate.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "+14155552671"
                    },
                    {
                        "name": "country_code",
                        "in": "query",
                        "description": " Country code of the phone number. For example, \"US\"",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "US"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Phone validation completed successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PhoneFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/email-sources": {
            "get": {
                "summary": "Email Sources",
                "description": "Find email address source somewhere on the web.",
                "operationId": "EmailSources",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address you want to find sources.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email sources found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailSources"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/domain-status": {
            "get": {
                "summary": "Domain status",
                "description": "Returns domain status if is webmail or disposable.",
                "operationId": "DomainStatus",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "Domain name from which you want to check.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "gmail.com"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Domain status retrieved successfully",
                        "content": {}
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/email-count": {
            "get": {
                "tags": ["Finder"],
                "summary": "Email Count",
                "description": "Domain name from which you want to find the email addresses.",
                "operationId": "EmailCount",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain name from which you want to find the email addresses. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email count retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailCount"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/domain-suggestions": {
            "get": {
                "tags": ["Domain Suggestions"],
                "summary": "Get domain suggestions",
                "description": "Retrieve a list of suggested domains similar to or related to your search query.\nThis endpoint helps discover competitors, similar companies, and related businesses\nfor market research and prospecting purposes.\n",
                "operationId": "getDomainSuggestions",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "query",
                        "in": "query",
                        "required": true,
                        "description": "The domain or company name to find suggestions for",
                        "schema": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 255
                        },
                        "example": "zapier.com"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful response with domain suggestions",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DomainSuggestionsResponse"
                                },
                                "examples": {
                                    "successful_response": {
                                        "summary": "Standard successful response",
                                        "value": {
                                            "data": [
                                                {
                                                    "name": "Zapier",
                                                    "domain": "zapier.com",
                                                    "email_count": 455
                                                }
                                            ],
                                            "meta": {
                                                "query": "zapier.com",
                                                "limit": 5,
                                                "total_found": 5
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request - Invalid parameters",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                },
                                "examples": {
                                    "invalid_query": {
                                        "summary": "Invalid query parameter",
                                        "value": {
                                            "errors": {
                                                "type": "params_invalid",
                                                "message": "Query parameter must be between 2 and 255 characters",
                                                "code": 400
                                            }
                                        }
                                    },
                                    "invalid_limit": {
                                        "summary": "Invalid limit parameter",
                                        "value": {
                                            "errors": {
                                                "type": "params_invalid",
                                                "message": "Limit must be between 1 and 50",
                                                "code": 400
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized - Invalid or missing API key",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                },
                                "example": {
                                    "errors": {
                                        "type": "authentication_failed",
                                        "message": "Invalid API key provided",
                                        "code": 401
                                    }
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Forbidden - Insufficient permissions or quota exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                },
                                "examples": {
                                    "quota_exceeded": {
                                        "summary": "API quota exceeded",
                                        "value": {
                                            "errors": {
                                                "type": "rate_limit",
                                                "message": "Monthly API quota exceeded",
                                                "code": 403
                                            }
                                        }
                                    },
                                    "plan_limitation": {
                                        "summary": "Plan limitation",
                                        "value": {
                                            "errors": {
                                                "type": "plan_limitation",
                                                "message": "Domain suggestions not available on your current plan",
                                                "code": 403
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Too Many Requests - Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                },
                                "example": {
                                    "errors": {
                                        "type": "rate_limit",
                                        "message": "Rate limit exceeded. Please try again in 60 seconds",
                                        "code": 429
                                    }
                                }
                            }
                        },
                        "headers": {
                            "Retry-After": {
                                "description": "Number of seconds to wait before making another request",
                                "schema": {
                                    "type": "integer"
                                },
                                "example": 60
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                },
                                "example": {
                                    "errors": {
                                        "type": "api_error",
                                        "message": "Internal server error occurred",
                                        "code": 500
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/email-format": {
            "get": {
                "tags": ["Finder"],
                "summary": "Email Format",
                "operationId": "EmailFormat",
                "description": " This endpoint allows you to retrieve the email format patterns used by a specific domain.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain name from which you want to find the email addresses. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email format retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Format"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/location": {
            "get": {
                "tags": ["Finder"],
                "summary": "Location",
                "description": "Employees location based on the domain name.",
                "operationId": "LocationCount",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain name from which you want to find the location. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Location data retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Location"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/similar": {
            "get": {
                "summary": "Similar",
                "description": "This endpoint allows you to retrieve similar domains based by a specific domain.",
                "operationId": "Similar",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "Domain name from which you want to find similar domains. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Similar domains retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DomainSimilar"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/technology": {
            "get": {
                "summary": "Technology",
                "description": "This endpoint allows you to retrieve the technologies used by a specific domain.",
                "operationId": "Technology",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "Domain name from which you want to find the technology. For example, `stripe.com`",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Technologies retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DomainTechnology"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/author-finder": {
            "get": {
                "tags": ["Finder"],
                "summary": "Author Finder",
                "description": "[Author Finder](https://tomba.io/author-finder)\nThis API endpoint generates or retrieves the most likely email address from a blog post url.",
                "operationId": "AuthorFinder",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The URL of the article. For example, \"https://clearbit.com/blog/company-name-to-domain-api\".",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "https://clearbit.com/blog/company-name-to-domain-api"
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Author email found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/bulk/search": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all search bulk operations",
                "operationId": "getAllSearchBulks",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationError"
                    }
                }
            },
            "post": {
                "tags": ["Bulks"],
                "description": "Create a new search bulk operation to find email addresses based on a list of domains.\n\nYou can provide the list of domains directly in the request body or upload a CSV file containing the domains.\n\nEach domain should be on a new line in the CSV file.\n\nThe API will process the list and return a bulk operation ID that you can use to track the progress and retrieve the results once the operation is complete.",
                "summary": "Create new search bulk operation",
                "operationId": "createSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkPostSearch"
                                    }
                                ]
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkPostSearch"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationError"
                    },
                    "429": {
                        "$ref": "#/components/responses/RateLimitError"
                    }
                }
            }
        },
        "/bulk/search/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific search bulk operation",
                "operationId": "getSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch search bulk operation",
                "operationId": "launchSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/search/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete search bulk operation",
                "operationId": "deleteSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/search/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive search bulk operation",
                "operationId": "archiveSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/search/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get search bulk operation progress",
                "operationId": "getSearchBulkProgress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/search/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download search bulk results",
                "operationId": "downloadSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/search/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename search bulk operation",
                "operationId": "renameSearchBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "422": {
                        "$ref": "#/components/responses/ValidationError"
                    }
                }
            }
        },
        "/bulk/similar": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all similar bulk operations",
                "operationId": "getAllSimilarBulks",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new similar bulk operation",
                "operationId": "createSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkPostSearch"
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "400": {
                        "description": "Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/bulk/similar/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific similar bulk operation",
                "operationId": "getSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch similar bulk operation",
                "operationId": "launchSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/similar/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete similar bulk operation",
                "operationId": "deleteSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/similar/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive similar bulk operation",
                "operationId": "archiveSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/similar/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get similar bulk operation progress",
                "operationId": "getSimilarBulkProgress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/similar/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download similar bulk results",
                "operationId": "downloadSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/similar/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename similar bulk operation",
                "operationId": "renameSimilarBulk",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                }
            }
        },
        "/bulk/company": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all company bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllCompanyBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createCompanyBulks"
            }
        },
        "/bulk/company/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getCompanyBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchCompanyBulk"
            }
        },
        "/bulk/company/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteCompanyBulk"
            }
        },
        "/bulk/company/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveCompanyBulk"
            }
        },
        "/bulk/company/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get company bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressCompanyBulk"
            }
        },
        "/bulk/company/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download company bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadCompanyBulk"
            }
        },
        "/bulk/company/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename company bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameCompanyBulk"
            }
        },
        "/bulk/finder": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all finder bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllFinderBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkPostFinder"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary",
                                                "description": "CSV file for bulk processing"
                                            }
                                        },
                                        "required": ["file"]
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "404": {
                        "description": "Finder bulk type not supported without file upload"
                    }
                },
                "operationId": "createFinderBulks"
            }
        },
        "/bulk/finder/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getFinderBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchFinderBulk"
            }
        },
        "/bulk/finder/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteFinderBulk"
            }
        },
        "/bulk/finder/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveFinderBulk"
            }
        },
        "/bulk/finder/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get finder bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressFinderBulk"
            }
        },
        "/bulk/finder/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download finder bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadFinderBulk"
            }
        },
        "/bulk/finder/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameFinderBulk"
            }
        },
        "/bulk/enrich": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all enrich bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllEnrichBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createEnrichBulks"
            }
        },
        "/bulk/enrich/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getEnrichBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchEnrichBulk"
            }
        },
        "/bulk/enrich/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteEnrichBulk"
            }
        },
        "/bulk/enrich/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveEnrichBulk"
            }
        },
        "/bulk/enrich/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get enrich bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressEnrichBulk"
            }
        },
        "/bulk/enrich/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download enrich bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadEnrichBulk"
            }
        },
        "/bulk/enrich/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename enrich bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameEnrichBulk"
            }
        },
        "/bulk/linkedin": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all LinkedIn bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllLinkedinBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createLinkedinBulks"
            }
        },
        "/bulk/linkedin/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getLinkedinBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchLinkedinBulk"
            },
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete LinkedIn bulk operation (alternative endpoint)",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteLinkedinBulk"
            }
        },
        "/bulk/linkedin/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteLinkedinBulkById"
            }
        },
        "/bulk/linkedin/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveLinkedinBulk"
            }
        },
        "/bulk/linkedin/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get LinkedIn bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressLinkedinBulk"
            }
        },
        "/bulk/linkedin/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download LinkedIn bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadLinkedinBulk"
            }
        },
        "/bulk/linkedin/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename LinkedIn bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameLinkedinBulk"
            }
        },
        "/bulk/author": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all author bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllAuthorBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createAuthorBulks"
            }
        },
        "/bulk/author/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getAuthorBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchAuthorBulk"
            }
        },
        "/bulk/author/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteAuthorBulk"
            }
        },
        "/bulk/author/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveAuthorBulk"
            }
        },
        "/bulk/author/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get author bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressAuthorBulk"
            }
        },
        "/bulk/author/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download author bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadAuthorBulk"
            }
        },
        "/bulk/author/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename author bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameAuthorBulk"
            }
        },
        "/bulk/verifier": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all verifier bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllVerifierBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createVerifierBulks"
            }
        },
        "/bulk/verifier/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getVerifierBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchVerifierBulk"
            }
        },
        "/bulk/verifier/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteVerifierBulk"
            }
        },
        "/bulk/verifier/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archiveVerifierBulk"
            }
        },
        "/bulk/verifier/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get verifier bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressVerifierBulk"
            }
        },
        "/bulk/verifier/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download verifier bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadVerifierBulk"
            }
        },
        "/bulk/verifier/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename verifier bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renameVerifierBulk"
            }
        },
        "/bulk/phone-finder": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all phone finder bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllPhoneFinderBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDef"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary"
                                            }
                                        }
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createPhoneFinderBulks"
            }
        },
        "/bulk/phone-finder/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getPhoneFinderBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchPhoneFinderBulk"
            }
        },
        "/bulk/phone-finder/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deletePhoneFinderBulk"
            }
        },
        "/bulk/phone-finder/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archivePhoneFinderBulk"
            }
        },
        "/bulk/phone-finder/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get phone finder bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressPhoneFinderBulk"
            }
        },
        "/bulk/phone-finder/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download phone finder bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadPhoneFinderBulk"
            }
        },
        "/phone-finder/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename phone finder bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "putPhoneFinderIdRename"
            }
        },
        "/bulk/phone-validator": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get all phone validator bulk operations",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/PageParam"
                    },
                    {
                        "$ref": "#/components/parameters/LimitParam"
                    },
                    {
                        "$ref": "#/components/parameters/DirectionParam"
                    },
                    {
                        "$ref": "#/components/parameters/FilterParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkListResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAllPhoneValidatorBulks"
            },
            "post": {
                "tags": ["Bulks"],
                "summary": "Create new phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "allOf": [
                                    {
                                        "$ref": "#/components/schemas/BulkDef"
                                    },
                                    {
                                        "$ref": "#/components/schemas/BulkPhoneValidator"
                                    },
                                    {
                                        "type": "object",
                                        "properties": {
                                            "file": {
                                                "type": "string",
                                                "format": "binary",
                                                "description": "CSV file for phone validation"
                                            }
                                        },
                                        "required": ["file"]
                                    }
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "$ref": "#/components/responses/BulkCreateResponse"
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "createPhoneValidatorBulks"
            }
        },
        "/bulk/phone-validator/{id}": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get specific phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkDetailResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getPhoneValidatorBulk"
            },
            "put": {
                "tags": ["Bulks"],
                "summary": "Launch phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "launchPhoneValidatorBulk"
            }
        },
        "/bulk/phone-validator/{id}/delete": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Delete phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deletePhoneValidatorBulk"
            }
        },
        "/bulk/phone-validator/{id}/archive": {
            "delete": {
                "tags": ["Bulks"],
                "summary": "Archive phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "archivePhoneValidatorBulk"
            }
        },
        "/bulk/phone-validator/{id}/progress": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Get phone validator bulk operation progress",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/BulkProgressResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "getProgressPhoneValidatorBulk"
            }
        },
        "/bulk/phone-validator/{id}/download": {
            "get": {
                "tags": ["Bulks"],
                "summary": "Download phone validator bulk results",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    },
                    {
                        "$ref": "#/components/parameters/DownloadTypeParam"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "CSV file download",
                        "content": {
                            "text/csv": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "downloadPhoneValidatorBulk"
            }
        },
        "/bulk/phone-validator/{id}/rename": {
            "put": {
                "tags": ["Bulks"],
                "summary": "Rename phone validator bulk operation",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "$ref": "#/components/parameters/BulkIdParam"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkPutRename"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "$ref": "#/components/responses/SuccessResponse"
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "renamePhoneValidatorBulk"
            }
        },
        "/linkedin": {
            "get": {
                "tags": ["Finder"],
                "summary": "Linkedin Finder",
                "description": "[Linkedin Finder](https://tomba.io/linkedin-finder)\nThis API endpoint generates or retrieves the most likely email address from a Linkedin URL.",
                "operationId": "LinkedinFinder",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "url",
                        "in": "query",
                        "description": "The URL of the Linkedin. For example, `https://www.linkedin.com/in/alex-maccaw-ab592978`.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "https://www.linkedin.com/in/alex-maccaw-ab592978"
                    },
                    {
                        "name": "enrich_mobile",
                        "in": "query",
                        "description": "Set to true to get the phone number associated with the email address found.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "full",
                        "in": "query",
                        "description": "Set to true to get the full emails associated with the Linkedin URL found. By default, the API returns only the most likely email address.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email address from LinkedIn found successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LinkedinFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/enrich": {
            "get": {
                "tags": ["Finder"],
                "summary": "Email Enrichment",
                "description": "[Email Enrichment](https://tomba.io/enrichment)\nenrichment lets you look up person and company data based on an email, For example, you could retrieve a person’s name, location and social handles from an email",
                "operationId": "EmailEnrichment",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address to find data.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    },
                    {
                        "name": "enrich_mobile",
                        "in": "query",
                        "description": "Set to true to get the phone number associated with the email address found.",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "example": true
                    },
                    {
                        "name": "webhook_url",
                        "in": "query",
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Email enrichment data retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EmailFinder"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/companies/find": {
            "get": {
                "tags": ["Enrichment"],
                "summary": "Company API",
                "description": "Our Company API lets you lookup company data via a domain",
                "operationId": "CompanyAPI",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "domain",
                        "in": "query",
                        "description": "The domain name for which you to find associated information.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "tomba.io"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Company object to be returned",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EnrichmentCompanyAPI"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/people/find": {
            "get": {
                "tags": ["Enrichment"],
                "summary": "Person API",
                "description": "The Person API enables you to fetch social details tied to an email address—everything from the individual’s name and location to their Twitter handle.",
                "operationId": "PersonAPI",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address to find data.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Person object to be returned",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EnrichmentPersonAPI"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/combined/find": {
            "get": {
                "tags": ["Enrichment"],
                "summary": "Combined API",
                "description": "This endpoint expects an email address, and will return an object containing both the person and company (if found).",
                "operationId": "CombinedAPI",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "The email address to find data.",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "m@wordpress.org"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Combined person and company data retrieved successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/EnrichmentCombinedAPI"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Status Bad Request",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Rate limit exceeded",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Tomba-Api-Key": [],
                        "Tomba-Api-Secret": []
                    }
                ]
            }
        },
        "/leads": {
            "get": {
                "tags": ["Leads"],
                "summary": "Retrieve Leads",
                "description": "Retrieve a paginated list of leads. Optionally filter by domain.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "query",
                        "name": "domain",
                        "schema": {
                            "type": "string"
                        },
                        "required": false,
                        "description": "Filter leads by domain."
                    },
                    {
                        "in": "query",
                        "name": "page",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "required": false,
                        "description": "Page number."
                    },
                    {
                        "in": "query",
                        "name": "limit",
                        "schema": {
                            "type": "integer",
                            "default": 10
                        },
                        "required": false,
                        "description": "Number of leads per page."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of leads.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Lead"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "page": {
                                                    "type": "integer"
                                                },
                                                "limit": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getLeads"
            }
        },
        "/leads/{leadId}": {
            "get": {
                "tags": ["Leads"],
                "summary": "Retrieve a Single Lead",
                "description": "Retrieve detailed information for a specific lead.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "leadId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the lead."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A lead object.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Lead"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Lead not found."
                    }
                },
                "operationId": "getLeadsLeadId"
            },
            "put": {
                "tags": ["Leads"],
                "summary": "Update a lead",
                "description": "Update the fields of a lead using id.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "leadId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the lead."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A lead object.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Lead"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Lead not found."
                    }
                },
                "operationId": "putLeadsLeadId"
            },
            "delete": {
                "tags": ["Leads"],
                "summary": "Delete a lead",
                "description": "Delete a lead using id.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "leadId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the lead."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Lead deleted successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Success"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Lead not found.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "deleteLeadsLeadId"
            }
        },
        "/attributes": {
            "get": {
                "tags": ["Lead Attributes"],
                "summary": "Retrieve Lead Attributes",
                "description": "Retrieve a list of lead attributes.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of lead attributes.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeadAttribute"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAttributes"
            }
        },
        "/attributes/{attributeId}": {
            "get": {
                "tags": ["Lead Attributes"],
                "summary": "Retrieve a Single Lead Attribute",
                "description": "Retrieve details for a specific lead attribute.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "attributeId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the lead attribute."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A lead attribute object.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LeadAttribute"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "lead attribute not found.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getAttributesAttributeId"
            }
        },
        "/leads_lists": {
            "get": {
                "tags": ["Lead Lists"],
                "summary": "Retrieve Leads Lists",
                "description": "Retrieve a list of leads lists.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of leads lists.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeadsList"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getLeads_lists"
            },
            "post": {
                "tags": ["Lead Lists"],
                "summary": "Create Leads List",
                "description": "Create a new leads list.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/LeadsList"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Leads list created successfully.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LeadsList"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "postLeads_lists"
            }
        },
        "/leads_lists/{listId}": {
            "get": {
                "tags": ["Lead Lists"],
                "summary": "Retrieve a Single Leads List",
                "description": "Retrieve details of a specific leads list.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "listId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the leads list."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A leads list object.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LeadsList"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "leads list not found.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getLeads_listsListId"
            },
            "put": {
                "tags": ["Lead Lists"],
                "summary": "Update Leads List",
                "description": "Update a specific leads list.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "listId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the leads list."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/LeadsList"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Leads list updated successfully.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LeadsList"
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "putLeads_listsListId"
            },
            "delete": {
                "tags": ["Lead Lists"],
                "summary": "Delete Leads List",
                "description": "Delete a specific leads list.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "listId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the leads list."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Leads list deleted successfully."
                    },
                    "404": {
                        "$ref": "#/components/responses/NotFoundError"
                    }
                },
                "operationId": "deleteLeads_listsListId"
            }
        },
        "/keys": {
            "get": {
                "tags": ["Keys"],
                "summary": "Retrieve API Keys",
                "description": "Retrieve a list of API keys.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of API keys.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Key"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getKeys"
            }
        },
        "/keys/{keyId}": {
            "get": {
                "tags": ["Keys"],
                "summary": "Retrieve a Single API Key",
                "description": "Retrieve details for a specific API key.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "path",
                        "name": "keyId",
                        "schema": {
                            "type": "string"
                        },
                        "required": true,
                        "description": "The ID of the API key."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "An API key object.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Key"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "API key not found.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getKeysKeyId"
            }
        },
        "/usage": {
            "get": {
                "tags": ["Account"],
                "summary": "Retrieve API Usage",
                "description": "Retrieve current API usage information.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "API usage details.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Usage"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getUsage"
            }
        },
        "/logs": {
            "get": {
                "tags": ["Account"],
                "summary": "Retrieve API Logs",
                "description": "Returns a your last 1,000 requests you made during the last 3 months.",
                "parameters": [
                    {
                        "$ref": "#/components/parameters/ApiKey"
                    },
                    {
                        "$ref": "#/components/parameters/ApiSecret"
                    },
                    {
                        "in": "query",
                        "name": "page",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "required": false,
                        "description": "Page number."
                    },
                    {
                        "in": "query",
                        "name": "limit",
                        "schema": {
                            "type": "integer",
                            "default": 10
                        },
                        "required": false,
                        "description": "Number of logs per page."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "A list of logs.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Log"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "page": {
                                                    "type": "integer"
                                                },
                                                "limit": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Errors"
                                }
                            }
                        }
                    }
                },
                "operationId": "getLogs"
            }
        }
    },
    "components": {
        "parameters": {
            "ApiKey": {
                "name": "X-Tomba-Key",
                "in": "header",
                "description": "API key used to authenticate requests. Send this value in the `X-Tomba-Key` header.",
                "required": true,
                "example": "ta_xxxx",
                "schema": {
                    "type": "string"
                }
            },
            "ApiSecret": {
                "name": "X-Tomba-Secret",
                "in": "header",
                "description": "API secret used with `X-Tomba-Key` to authenticate requests. Send this value in the `X-Tomba-Secret` header.",
                "required": true,
                "example": "ts_xxxx",
                "schema": {
                    "type": "string"
                }
            },
            "BulkIdParam": {
                "name": "id",
                "in": "path",
                "required": true,
                "description": "Bulk operation ID",
                "schema": {
                    "type": "integer",
                    "format": "int64"
                }
            },
            "PageParam": {
                "name": "page",
                "in": "query",
                "description": "Page number for pagination (1-based).",
                "schema": {
                    "type": "integer",
                    "minimum": 1,
                    "default": 1
                }
            },
            "LimitParam": {
                "name": "limit",
                "in": "query",
                "description": "Number of items returned per page.",
                "schema": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 50,
                    "default": 10
                }
            },
            "DirectionParam": {
                "name": "direction",
                "in": "query",
                "description": "Sort direction for list endpoints.",
                "schema": {
                    "type": "string",
                    "enum": ["desc", "asc"],
                    "default": "desc"
                }
            },
            "FilterParam": {
                "name": "filter",
                "in": "query",
                "description": "Filter list results by status.",
                "schema": {
                    "type": "string",
                    "enum": ["archived", "all"]
                }
            },
            "DownloadTypeParam": {
                "name": "type",
                "in": "query",
                "description": "Result set to include in the downloaded file.",
                "schema": {
                    "type": "string",
                    "enum": ["full", "not_found", "valid"],
                    "default": "full"
                }
            }
        },
        "schemas": {
            "RevealSearchRequest": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "Natural language query - AI assistant will select appropriate filters for you. Note: Use this only on the first request, then use the filters parameter for subsequent requests",
                        "minLength": 8,
                        "maxLength": 100,
                        "example": "Real Estate in Europe"
                    },
                    "filters": {
                        "$ref": "#/components/schemas/RevealFilters"
                    },
                    "page": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000,
                        "default": 1,
                        "description": "Page number for pagination"
                    },
                    "webhook_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body."
                    }
                }
            },
            "RevealFilters": {
                "type": "object",
                "description": "Structured filters for company search",
                "properties": {
                    "company": {
                        "$ref": "#/components/schemas/Filter"
                    },
                    "location_country": {
                        "$ref": "#/components/schemas/Filter"
                    },
                    "location_city": {
                        "$ref": "#/components/schemas/Filter"
                    },
                    "location_state": {
                        "$ref": "#/components/schemas/Filter"
                    },
                    "industry": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "size": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "type": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "keywords": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "founded": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "technologies": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "similar": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "revenue": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "sic": {
                        "$ref": "#/components/schemas/FilterPremium"
                    },
                    "naics": {
                        "$ref": "#/components/schemas/FilterPremium"
                    }
                }
            },
            "Filter": {
                "type": "object",
                "description": "Include/exclude filter options",
                "properties": {
                    "include": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "maxItems": 50,
                        "description": "Values to include in the filter"
                    },
                    "exclude": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "maxItems": 50,
                        "description": "Values to exclude from the filter"
                    }
                }
            },
             "FilterPremium": {
                "type": "object",
                "description": "Include/exclude filter options. `Premium only`.",
                "properties": {
                    "include": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "maxItems": 50,
                        "description": "Values to include in the filter"
                    },
                    "exclude": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "maxItems": 50,
                        "description": "Values to exclude from the filter"
                    }
                }
            },
            "RevealSearchResponse": {
                "type": "object",
                "required": ["success", "data"],
                "properties": {
                    "success": {
                        "type": "boolean",
                        "description": "Indicates if the request was successful"
                    },
                    "data": {
                        "$ref": "#/components/schemas/RevealData"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/RevealMeta"
                    },
                    "message": {
                        "type": "string",
                        "description": "Optional message"
                    }
                }
            },
            "RevealMeta": {
                "type": "object",
                "required": ["total", "page", "limit", "pages"],
                "properties": {
                    "total": {
                        "type": "integer",
                        "description": "Total number of companies found"
                    },
                    "page": {
                        "type": "integer",
                        "description": "Current page number"
                    },
                    "limit": {
                        "type": "integer",
                        "description": "Number of results per page"
                    },
                    "pages": {
                        "type": "integer",
                        "description": "Total number of pages"
                    },
                    "filters": {
                        "type": "object",
                        "description": "Applied filters for the search",
                        "additionalProperties": {
                            "type": "object",
                            "properties": {
                                "include": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    },
                                    "description": "Values included in the filter"
                                },
                                "exclude": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    },
                                    "description": "Values excluded from the filter"
                                }
                            }
                        }
                    }
                }
            },
            "RevealData": {
                "type": "object",
                "required": ["companies", "total", "page", "limit", "pages"],
                "properties": {
                    "companies": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Company"
                        },
                        "description": "Array of company results"
                    },
                    "total": {
                        "type": "integer",
                        "description": "Total number of companies found"
                    },
                    "page": {
                        "type": "integer",
                        "description": "Current page number"
                    },
                    "limit": {
                        "type": "integer",
                        "description": "Number of results per page"
                    },
                    "pages": {
                        "type": "integer",
                        "description": "Total number of pages"
                    }
                }
            },
            "Company": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "Company name"
                    },
                    "description": {
                        "type": "string",
                        "description": "Company description"
                    },
                    "country": {
                        "type": "string",
                        "description": "Country where the company is located"
                    },
                    "state": {
                        "type": "string",
                        "description": "State/province where the company is located"
                    },
                    "city": {
                        "type": "string",
                        "description": "City where the company is located"
                    },
                    "street_address": {
                        "type": "string",
                        "description": "Street address of the company"
                    },
                    "postal_code": {
                        "type": "string",
                        "description": "Postal/ZIP code"
                    },
                    "industry": {
                        "type": "string",
                        "description": "Industry sector"
                    },
                    "company_size": {
                        "type": "string",
                        "description": "Number of employees",
                        "example": "101-500"
                    },
                    "type": {
                        "type": "string",
                        "description": "Company type (e.g., Private, Public)",
                        "example": "Private"
                    },
                    "founded": {
                        "type": "string",
                        "description": "Year the company was founded"
                    },
                    "website_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Company website URL"
                    },
                    "total_emails": {
                        "type": "integer",
                        "description": "Total number of email addresses found for this company"
                    },
                    "revenue": {
                        "type": "string",
                        "description": "Annual revenue range",
                        "example": "$10M-$50M"
                    },
                    "phone_number": {
                        "type": "boolean",
                        "description": "Indicates if a phone number is available"
                    },
                    "linkedin_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "LinkedIn company page URL"
                    },
                    "facebook_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Facebook company page URL"
                    },
                    "twitter_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Twitter company page URL"
                    },

                    "instagram_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Instagram company page URL"
                    },
                    "github_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "GitHub company page URL"
                    },
                    "youtube_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "YouTube company page URL"
                    },
                    "pinterest_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Pinterest company page URL"
                    },
                    "tiktok_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "TikTok company page URL"
                    },
                    "total_similar": {
                        "type": "integer",
                        "description": "Number of similar companies found"
                    }
                }
            },
            "Account": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "user_id": {
                                "type": "number"
                            },
                            "secret_token": {
                                "type": "string"
                            },
                            "role": {
                                "type": "number"
                            },
                            "confirmed": {
                                "type": "boolean"
                            },
                            "blocked": {
                                "type": "boolean"
                            },
                            "first_name": {
                                "type": "string"
                            },
                            "last_name": {
                                "type": "string"
                            },
                            "email": {
                                "type": "string"
                            },
                            "phone": {
                                "type": "string"
                            },
                            "image": {
                                "type": "string"
                            },
                            "deleted": {
                                "type": "boolean"
                            },
                            "provider": {
                                "type": "string"
                            },
                            "timezone": {
                                "type": "string"
                            },
                            "newsletter": {
                                "type": "boolean"
                            },
                            "activity": {
                                "type": "boolean"
                            },
                            "title": {},
                            "country": {
                                "type": "string"
                            },
                            "created_at": {
                                "type": "string"
                            },
                            "ip": {
                                "type": "string"
                            },
                            "issued": {
                                "type": "string"
                            },
                            "expired": {
                                "type": "string"
                            },
                            "expired_subscription": {
                                "type": "string"
                            },
                            "pricing": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "pricing_id": {
                                        "type": "number"
                                    },
                                    "available_searches": {
                                        "type": "number"
                                    },
                                    "available_verifications": {
                                        "type": "number"
                                    },
                                    "available_phones": {
                                        "type": "number"
                                    },
                                    "available_leads": {
                                        "type": "number"
                                    },
                                    "available_list": {
                                        "type": "number"
                                    },
                                    "available_attr": {
                                        "type": "number"
                                    },
                                    "available_keys": {
                                        "type": "number"
                                    },
                                    "available_teams": {
                                        "type": "number"
                                    },
                                    "available_b2b": {
                                        "type": "number"
                                    },
                                    "available_sources": {
                                        "type": "number"
                                    },
                                    "available_email_count": {
                                        "type": "number"
                                    },
                                    "frequency": {
                                        "type": "string"
                                    },
                                    "price_monthly": {
                                        "type": "string"
                                    },
                                    "price_yearly": {
                                        "type": "string"
                                    },
                                    "update_url": {},
                                    "cancel_url": {}
                                }
                            },
                            "teams": {
                                "type": "object",
                                "properties": {
                                    "team_id": {},
                                    "role": {},
                                    "workspace": {},
                                    "export": {},
                                    "bulks": {},
                                    "limit": {
                                        "type": "object",
                                        "properties": {
                                            "search": {},
                                            "verifier": {}
                                        }
                                    },
                                    "owner": {}
                                }
                            },
                            "requests": {
                                "type": "object",
                                "properties": {
                                    "domains": {
                                        "type": "object",
                                        "properties": {
                                            "available": {
                                                "type": "number"
                                            },
                                            "used": {
                                                "type": "number"
                                            }
                                        }
                                    },
                                    "verifications": {
                                        "type": "object",
                                        "properties": {
                                            "available": {
                                                "type": "number"
                                            },
                                            "used": {
                                                "type": "number"
                                            }
                                        }
                                    },
                                    "phones": {
                                        "type": "object",
                                        "properties": {
                                            "available": {
                                                "type": "number"
                                            },
                                            "used": {
                                                "type": "number"
                                            }
                                        }
                                    },
                                    "b2b": {
                                        "type": "object",
                                        "properties": {
                                            "available": {
                                                "type": "number"
                                            },
                                            "used": {
                                                "type": "number"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "DomainSearch": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "organization": {
                                "type": "object",
                                "properties": {
                                    "website_url": {
                                        "type": "string"
                                    },
                                    "organization": {
                                        "type": "string"
                                    },
                                    "location": {
                                        "type": "object",
                                        "properties": {
                                            "country": {
                                                "type": "string"
                                            },
                                            "city": {
                                                "type": "string"
                                            },
                                            "state": {
                                                "type": "string"
                                            },
                                            "street_address": {
                                                "type": "string"
                                            },
                                            "postal_code": {
                                                "type": "string"
                                            }
                                        },
                                        "required": [
                                            "country",
                                            "city",
                                            "state",
                                            "street_address",
                                            "postal_code"
                                        ]
                                    },
                                    "social_links": {
                                        "type": "object",
                                        "properties": {
                                            "twitter_url": {
                                                "type": "string"
                                            },
                                            "facebook_url": {
                                                "type": "string"
                                            },
                                            "linkedin_url": {
                                                "type": "string"
                                            },
                                            "instagram_url": {
                                                "type": "string"
                                            },
                                            "github_url": {
                                                "type": "string"
                                            },
                                            "youtube_url": {
                                                "type": "string"
                                            },
                                            "pinterest_url": {
                                                "type": "string"
                                            },
                                            "tiktok_url": {
                                                "type": "string"
                                            }
                                        },
                                        "required": [
                                            "twitter_url",
                                            "facebook_url",
                                            "linkedin_url",
                                            "instagram_url",
                                            "github_url",
                                            "youtube_url",
                                            "pinterest_url",
                                            "tiktok_url"
                                        ]
                                    },
                                    "disposable": {
                                        "type": "boolean"
                                    },
                                    "webmail": {
                                        "type": "boolean"
                                    },
                                    "phone_number": {
                                        "type": "boolean"
                                    },
                                    "industries": {
                                        "type": "string"
                                    },
                                    "founded": {
                                        "type": "string"
                                    },
                                    "company_size": {
                                        "type": "string"
                                    },
                                    "company_type": {
                                        "type": "string"
                                    },
                                    "revenue": {
                                        "type": "string"
                                    },
                                    "accept_all": {
                                        "type": "boolean"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "pattern": {
                                        "type": "string"
                                    },
                                    "total_similar": {
                                        "type": "number"
                                    },
                                    "keywords": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        }
                                    },
                                    "ranking": {
                                        "type": "number"
                                    },
                                    "whois": {
                                        "type": "object",
                                        "properties": {
                                            "registrar_name": {
                                                "type": "string"
                                            },
                                            "created_date": {
                                                "type": "string"
                                            },
                                            "referral_url": {
                                                "type": "string"
                                            }
                                        },
                                        "required": [
                                            "registrar_name",
                                            "created_date",
                                            "referral_url"
                                        ]
                                    },
                                    "last_updated": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "website_url",
                                    "organization",
                                    "location",
                                    "social_links",
                                    "disposable",
                                    "webmail",
                                    "phone_number",
                                    "industries",
                                    "founded",
                                    "company_size",
                                    "company_type",
                                    "revenue",
                                    "accept_all",
                                    "description",
                                    "pattern",
                                    "total_similar",
                                    "keywords",
                                    "ranking",
                                    "whois",
                                    "last_updated"
                                ]
                            },
                            "emails": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "email": {
                                            "type": "string"
                                        },
                                        "first_name": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "last_name": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "full_name": {
                                            "type": "string"
                                        },
                                        "gender": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "phone_number": {
                                            "type": "boolean"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "country": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "position": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "department": {
                                            "type": "string"
                                        },
                                        "seniority": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "twitter": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "linkedin": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "score": {
                                            "type": "number"
                                        },
                                        "verification": {
                                            "type": "object",
                                            "properties": {
                                                "date": {
                                                    "type": "string"
                                                },
                                                "status": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "sources": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "uri": {
                                                        "type": "string"
                                                    },
                                                    "website_url": {
                                                        "type": "string"
                                                    },
                                                    "extracted_on": {
                                                        "type": "string"
                                                    },
                                                    "last_seen_on": {
                                                        "type": "string"
                                                    },
                                                    "still_on_page": {
                                                        "type": "boolean"
                                                    }
                                                },
                                                "required": [
                                                    "uri",
                                                    "website_url",
                                                    "extracted_on",
                                                    "last_seen_on",
                                                    "still_on_page"
                                                ]
                                            }
                                        }
                                    },
                                    "required": [
                                        "email",
                                        "full_name",
                                        "phone_number",
                                        "type",
                                        "department",
                                        "seniority",
                                        "twitter",
                                        "score",
                                        "verification",
                                        "sources"
                                    ]
                                }
                            }
                        },
                        "required": ["organization", "emails"]
                    },
                    "meta": {
                        "type": "object",
                        "properties": {
                            "total": {
                                "type": "number"
                            },
                            "pageSize": {
                                "type": "number"
                            },
                            "current": {
                                "type": "number"
                            },
                            "total_pages": {
                                "type": "number"
                            },
                            "params": {
                                "type": "object",
                                "properties": {
                                    "domain": {
                                        "type": "string"
                                    },
                                    "company": {
                                        "type": "string"
                                    },
                                    "page": {
                                        "type": "number"
                                    },
                                    "limit": {
                                        "type": "number"
                                    },
                                    "department": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "country": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "type": {
                                        "type": "string"
                                    },
                                    "live": {
                                        "type": "boolean"
                                    }
                                },
                                "required": [
                                    "domain",
                                    "company",
                                    "page",
                                    "limit",
                                    "department",
                                    "country",
                                    "type",
                                    "live"
                                ]
                            }
                        },
                        "required": [
                            "total",
                            "pageSize",
                            "current",
                            "total_pages",
                            "params"
                        ]
                    }
                },
                "required": ["data", "meta"]
            },
            "EmailFinder": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "email": {
                                "type": "string"
                            },
                            "first_name": {
                                "type": "string"
                            },
                            "last_name": {
                                "type": "string"
                            },
                            "full_name": {
                                "type": "string"
                            },
                            "website_url": {
                                "type": "string"
                            },
                            "company": {
                                "type": "string"
                            },
                            "position": {},
                            "country": {},
                            "gender": {},
                            "twitter": {},
                            "linkedin": {
                                "type": "string"
                            },
                            "score": {
                                "type": "number"
                            },
                            "accept_all": {
                                "type": "boolean"
                            },
                            "phone_number": {
                                "type": "boolean"
                            },
                            "disposable": {
                                "type": "boolean"
                            },
                            "webmail": {
                                "type": "boolean"
                            },
                            "verification": {
                                "type": "object",
                                "properties": {
                                    "date": {
                                        "type": "string"
                                    },
                                    "status": {
                                        "type": "string"
                                    }
                                },
                                "required": ["date", "status"]
                            },
                            "sources": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "uri": {
                                            "type": "string"
                                        },
                                        "website_url": {
                                            "type": "string"
                                        },
                                        "extracted_on": {
                                            "type": "string"
                                        },
                                        "last_seen_on": {
                                            "type": "string"
                                        },
                                        "still_on_page": {
                                            "type": "boolean"
                                        }
                                    },
                                    "required": [
                                        "uri",
                                        "website_url",
                                        "extracted_on",
                                        "last_seen_on",
                                        "still_on_page"
                                    ]
                                }
                            },
                            "phone_data": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "valid": {
                                            "type": "boolean"
                                        },
                                        "local_format": {
                                            "type": "string"
                                        },
                                        "intl_format": {
                                            "type": "string"
                                        },
                                        "e164_format": {
                                            "type": "string"
                                        },
                                        "rfc3966_format": {
                                            "type": "string"
                                        },
                                        "country_code": {
                                            "type": "string"
                                        },
                                        "line_type": {
                                            "type": "string"
                                        },
                                        "carrier": {
                                            "type": "string"
                                        },
                                        "timezones": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        }
                                    },
                                    "required": [
                                        "valid",
                                        "local_format",
                                        "intl_format",
                                        "e164_format",
                                        "rfc3966_format",
                                        "country_code",
                                        "line_type",
                                        "carrier",
                                        "timezones"
                                    ]
                                }
                            }
                        },
                        "required": [
                            "email",
                            "first_name",
                            "last_name",
                            "full_name",
                            "website_url",
                            "company",
                            "position",
                            "country",
                            "gender",
                            "twitter",
                            "linkedin",
                            "score",
                            "accept_all",
                            "phone_number",
                            "disposable",
                            "webmail",
                            "verification",
                            "sources",
                            "phone_data"
                        ]
                    }
                }
            },
            "EmailVerifier": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "email": {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string"
                                    },
                                    "result": {
                                        "type": "string"
                                    },
                                    "status": {
                                        "type": "string"
                                    },
                                    "score": {
                                        "type": "number"
                                    },
                                    "smtp_provider": {
                                        "type": "string"
                                    },
                                    "mx": {
                                        "type": "object",
                                        "properties": {
                                            "records": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "required": ["records"]
                                    },
                                    "mx_check": {
                                        "type": "boolean"
                                    },
                                    "smtp_server": {
                                        "type": "boolean"
                                    },
                                    "smtp_check": {
                                        "type": "boolean"
                                    },
                                    "accept_all": {
                                        "type": "boolean"
                                    },
                                    "greylisted": {
                                        "type": "boolean"
                                    },
                                    "block": {
                                        "type": "boolean"
                                    },
                                    "gibberish": {
                                        "type": "boolean"
                                    },
                                    "disposable": {
                                        "type": "boolean"
                                    },
                                    "webmail": {
                                        "type": "boolean"
                                    },
                                    "regex": {
                                        "type": "boolean"
                                    },
                                    "whois": {
                                        "type": "object",
                                        "properties": {
                                            "registrar_name": {
                                                "type": "string"
                                            },
                                            "referral_url": {
                                                "type": "string"
                                            },
                                            "created_date": {
                                                "type": "string"
                                            }
                                        },
                                        "required": [
                                            "registrar_name",
                                            "referral_url",
                                            "created_date"
                                        ]
                                    }
                                },
                                "required": [
                                    "email",
                                    "result",
                                    "status",
                                    "score",
                                    "smtp_provider",
                                    "mx",
                                    "mx_check",
                                    "smtp_server",
                                    "smtp_check",
                                    "accept_all",
                                    "greylisted",
                                    "block",
                                    "gibberish",
                                    "disposable",
                                    "webmail",
                                    "regex",
                                    "whois"
                                ]
                            },
                            "sources": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "uri": {
                                            "type": "string"
                                        },
                                        "website_url": {
                                            "type": "string"
                                        },
                                        "extracted_on": {
                                            "type": "string"
                                        },
                                        "last_seen_on": {
                                            "type": "string"
                                        },
                                        "still_on_page": {
                                            "type": "boolean"
                                        }
                                    },
                                    "required": [
                                        "uri",
                                        "website_url",
                                        "extracted_on",
                                        "last_seen_on",
                                        "still_on_page"
                                    ]
                                }
                            }
                        },
                        "required": ["email", "sources"]
                    }
                }
            },
            "EnrichmentPersonAPI": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "object",
                        "properties": {
                            "fullName": {
                                "type": "string"
                            },
                            "givenName": {
                                "type": "string"
                            },
                            "familyName": {
                                "type": "string"
                            }
                        }
                    },
                    "email": {
                        "type": "string"
                    },
                    "location": {
                        "type": "string"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "utcOffset": {
                        "type": "number"
                    },
                    "geo": {
                        "type": "object",
                        "properties": {
                            "city": {
                                "type": "string"
                            },
                            "state": {
                                "type": "string"
                            },
                            "stateCode": {
                                "type": "string"
                            },
                            "country": {
                                "type": "string"
                            },
                            "countryCode": {
                                "type": "string"
                            },
                            "lat": {
                                "type": "number"
                            },
                            "lng": {
                                "type": "number"
                            }
                        }
                    },
                    "bio": {
                        "type": "string"
                    },
                    "site": {
                        "type": "string"
                    },
                    "avatar": {
                        "type": "string"
                    },
                    "employment": {
                        "type": "object",
                        "properties": {
                            "domain": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "title": {
                                "type": "string"
                            },
                            "role": {
                                "type": "string"
                            },
                            "subRole": {
                                "type": "string"
                            },
                            "seniority": {
                                "type": "string"
                            }
                        }
                    },
                    "facebook": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            }
                        }
                    },
                    "github": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "avatar": {
                                "type": "string"
                            },
                            "company": {
                                "type": "string"
                            },
                            "blog": {
                                "type": "string"
                            },
                            "followers": {
                                "type": "number"
                            },
                            "following": {
                                "type": "number"
                            }
                        }
                    },
                    "twitter": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "bio": {
                                "type": "string"
                            },
                            "followers": {
                                "type": "number"
                            },
                            "following": {
                                "type": "number"
                            },
                            "statuses": {
                                "type": "number"
                            },
                            "favorites": {
                                "type": "number"
                            },
                            "location": {
                                "type": "string"
                            },
                            "site": {
                                "type": "string"
                            },
                            "avatar": {
                                "type": "string"
                            }
                        }
                    },
                    "linkedin": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            }
                        }
                    },
                    "gravatar": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            },
                            "urls": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "value": {
                                            "type": "string"
                                        },
                                        "title": {
                                            "type": "string"
                                        }
                                    }
                                }
                            },
                            "avatar": {
                                "type": "string"
                            },
                            "avatars": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "url": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "fuzzy": {
                        "type": "boolean"
                    },
                    "emailProvider": {
                        "type": "boolean"
                    },
                    "indexedAt": {
                        "type": "string"
                    },
                    "phone": {
                        "type": "string"
                    },
                    "activeAt": {
                        "type": "string"
                    },
                    "inactiveAt": {
                        "type": "string"
                    }
                }
            },
            "EnrichmentCompanyAPI": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "legalName": {
                        "type": "string"
                    },
                    "domain": {
                        "type": "string"
                    },
                    "domainAliases": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "site": {
                        "type": "object",
                        "properties": {
                            "phoneNumbers": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "emailAddresses": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "category": {
                        "type": "object",
                        "properties": {
                            "sector": {
                                "type": "string"
                            },
                            "industryGroup": {
                                "type": "string"
                            },
                            "industry": {
                                "type": "string"
                            },
                            "subIndustry": {
                                "type": "string"
                            },
                            "sicCode": {
                                "type": "string"
                            },
                            "sic4Codes": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "naicsCode": {
                                "type": "string"
                            },
                            "naics6Codes": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "description": {
                        "type": "string"
                    },
                    "foundedYear": {
                        "type": "number"
                    },
                    "location": {
                        "type": "string"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "utcOffset": {
                        "type": "number"
                    },
                    "geo": {
                        "type": "object",
                        "properties": {
                            "streetNumber": {
                                "type": "string"
                            },
                            "streetName": {
                                "type": "string"
                            },
                            "subPremise": {},
                            "streetAddress": {
                                "type": "string"
                            },
                            "city": {
                                "type": "string"
                            },
                            "postalCode": {
                                "type": "string"
                            },
                            "state": {
                                "type": "string"
                            },
                            "stateCode": {
                                "type": "string"
                            },
                            "country": {
                                "type": "string"
                            },
                            "countryCode": {
                                "type": "string"
                            },
                            "lat": {
                                "type": "number"
                            },
                            "lng": {
                                "type": "number"
                            }
                        }
                    },
                    "logo": {
                        "type": "string"
                    },
                    "facebook": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            },
                            "likes": {
                                "type": "number"
                            }
                        }
                    },
                    "linkedin": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            }
                        }
                    },
                    "twitter": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "bio": {
                                "type": "string"
                            },
                            "followers": {
                                "type": "number"
                            },
                            "following": {
                                "type": "number"
                            },
                            "location": {
                                "type": "string"
                            },
                            "site": {
                                "type": "string"
                            },
                            "avatar": {
                                "type": "string"
                            }
                        }
                    },
                    "crunchbase": {
                        "type": "object",
                        "properties": {
                            "handle": {
                                "type": "string"
                            }
                        }
                    },
                    "emailProvider": {
                        "type": "boolean"
                    },
                    "type": {
                        "type": "string"
                    },
                    "ticker": {},
                    "identifiers": {
                        "type": "object",
                        "properties": {
                            "usEIN": {}
                        }
                    },
                    "phone": {},
                    "metrics": {
                        "type": "object",
                        "properties": {
                            "alexaUsRank": {
                                "type": "number"
                            },
                            "alexaGlobalRank": {
                                "type": "number"
                            },
                            "trafficRank": {
                                "type": "string"
                            },
                            "employees": {
                                "type": "number"
                            },
                            "employeesRange": {
                                "type": "string"
                            },
                            "marketCap": {},
                            "raised": {
                                "type": "number"
                            },
                            "annualRevenue": {},
                            "estimatedAnnualRevenue": {
                                "type": "string"
                            },
                            "fiscalYearEnd": {}
                        }
                    },
                    "indexedAt": {
                        "type": "string"
                    },
                    "tech": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "techCategories": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "parent": {
                        "type": "object",
                        "properties": {
                            "domain": {}
                        }
                    },
                    "ultimateParent": {
                        "type": "object",
                        "properties": {
                            "domain": {}
                        }
                    }
                }
            },
            "EnrichmentCombinedAPI": {
                "type": "object",
                "properties": {
                    "person": {
                        "$ref": "#/components/schemas/EnrichmentPersonAPI"
                    },
                    "company": {
                        "type": "object",
                        "$ref": "#/components/schemas/EnrichmentCompanyAPI"
                    }
                }
            },
            "EmailCount": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "total": {
                                "type": "integer",
                                "format": "int32"
                            },
                            "personal_emails": {
                                "type": "integer",
                                "format": "int32"
                            },
                            "generic_emails": {
                                "type": "integer",
                                "format": "int32"
                            },
                            "department": {
                                "type": "object",
                                "properties": {
                                    "engineering": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "finance": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "hr": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "it": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "marketing": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "operations": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "management": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "sales": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "legal": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "support": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "communication": {
                                        "type": "integer",
                                        "format": "int32"
                                    }
                                }
                            },
                            "seniority": {
                                "type": "object",
                                "properties": {
                                    "junior": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "senior": {
                                        "type": "integer",
                                        "format": "int32"
                                    },
                                    "executive": {
                                        "type": "integer",
                                        "format": "int32"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "Location": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "total": {
                                    "type": "number"
                                }
                            },
                            "required": ["name", "total"]
                        }
                    }
                }
            },
            "EmailSources": {
                "type": "object",
                "properties": {
                    "email": {
                        "type": "string"
                    },
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "uri": {
                                    "type": "string"
                                },
                                "extracted_on": {
                                    "type": "string"
                                },
                                "last_seen_on": {
                                    "type": "string"
                                },
                                "still_on_page": {
                                    "type": "boolean"
                                },
                                "website_url": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            },
            "Format": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "format": {
                                    "type": "string"
                                },
                                "percentage": {
                                    "type": "number"
                                }
                            },
                            "required": ["format", "percentage"]
                        }
                    }
                }
            },
            "DomainSimilar": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "website_url": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            },
            "DomainTechnology": {
                "type": "object",
                "properties": {
                    "domain": {
                        "type": "string"
                    },
                    "data": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "slug": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "icon": {
                                    "type": "string"
                                },
                                "website": {
                                    "type": "string"
                                },
                                "categories": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "number"
                                        },
                                        "slug": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "PhoneFinder": {
                "type": "object",
                "properties": {
                    "data": {
                        "oneOf": [
                            {
                                "type": "object",
                                "properties": {
                                    "email": {
                                        "type": "string"
                                    },
                                    "domain": {
                                        "type": "string"
                                    },
                                    "valid": {
                                        "type": "boolean"
                                    },
                                    "local_format": {
                                        "type": "string"
                                    },
                                    "intl_format": {
                                        "type": "string"
                                    },
                                    "e164_format": {
                                        "type": "string"
                                    },
                                    "rfc3966_format": {
                                        "type": "string"
                                    },
                                    "country_code": {
                                        "type": "string"
                                    },
                                    "line_type": {
                                        "type": "string"
                                    },
                                    "carrier": {},
                                    "timezones": {
                                        "type": "string"
                                    }
                                }
                            },
                            {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "email": {
                                            "type": "string"
                                        },
                                        "domain": {
                                            "type": "string"
                                        },
                                        "valid": {
                                            "type": "boolean"
                                        },
                                        "local_format": {
                                            "type": "string"
                                        },
                                        "intl_format": {
                                            "type": "string"
                                        },
                                        "e164_format": {
                                            "type": "string"
                                        },
                                        "rfc3966_format": {
                                            "type": "string"
                                        },
                                        "country_code": {
                                            "type": "string"
                                        },
                                        "line_type": {
                                            "type": "string"
                                        },
                                        "carrier": {},
                                        "timezones": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        ]
                    }
                }
            },
            "Lead": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "firstName": {
                        "type": "string"
                    },
                    "lastName": {
                        "type": "string"
                    },
                    "company": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "attributes": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/LeadAttribute"
                        }
                    }
                },
                "required": ["id", "email"]
            },
            "LeadAttribute": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "required": ["id", "name", "value"]
            },
            "LeadsList": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "leads": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Lead"
                        }
                    }
                },
                "required": ["id", "name"]
            },
            "Key": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": ["id", "key"]
            },
            "Usage": {
                "type": "object",
                "properties": {
                    "requests": {
                        "type": "integer"
                    },
                    "limit": {
                        "type": "integer"
                    },
                    "resetAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": ["requests", "limit", "resetAt"]
            },
            "Log": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "endpoint": {
                        "type": "string"
                    },
                    "method": {
                        "type": "string"
                    },
                    "status": {
                        "type": "integer"
                    },
                    "timestamp": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": ["id", "endpoint", "method", "status", "timestamp"]
            },
            "Success": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "status": {
                                "type": "boolean"
                            },
                            "message": {
                                "type": "string"
                            },
                            "code": {
                                "type": "number"
                            }
                        }
                    }
                }
            },
            "Errors": {
                "type": "object",
                "description": "Standard error envelope returned by the API.",
                "properties": {
                    "errors": {
                        "type": "object",
                        "description": "Error details for the failed request.",
                        "properties": {
                            "type": {
                                "type": "string",
                                "description": "Machine-readable error type."
                            },
                            "message": {
                                "type": "string",
                                "description": "Human-readable error message."
                            },
                            "code": {
                                "type": "number",
                                "description": "HTTP status code associated with the error."
                            }
                        },
                        "required": ["type", "message", "code"],
                        "example": {
                            "type": "params_invalid",
                            "message": "The domain parameter is required.",
                            "code": 400
                        }
                    }
                },
                "required": ["errors"]
            },
            "BulkDef": {
                "type": "object",
                "required": ["name"],
                "properties": {
                    "name": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 200,
                        "description": "Name of the bulk operation"
                    },
                    "list": {
                        "type": "string",
                        "description": "List of items to process (domains, emails, etc.)"
                    },
                    "sources": {
                        "type": "boolean",
                        "description": "Include sources in results"
                    },
                    "notifie": {
                        "type": "boolean",
                        "description": "Send notifications"
                    },
                    "verify": {
                        "type": "boolean",
                        "description": "Enable verification"
                    },
                    "total": {
                        "type": "integer",
                        "description": "Total number of items"
                    },
                    "delimiter": {
                        "type": "string",
                        "description": "CSV delimiter character"
                    },
                    "valid": {
                        "type": "boolean",
                        "description": "Valid flag"
                    },
                    "column": {
                        "type": "integer",
                        "description": "Column number for processing"
                    }
                }
            },
            "BulkPutRename": {
                "type": "object",
                "required": ["name"],
                "properties": {
                    "name": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 200,
                        "description": "New name for the bulk operation"
                    }
                }
            },
            "BulkPostSearch": {
                "type": "object",
                "required": ["maximum", "email_type", "department"],
                "properties": {
                    "maximum": {
                        "type": "string",
                        "enum": ["1", "5", "10", "20", "50", "100"],
                        "description": "Maximum results per domain"
                    },
                    "email_type": {
                        "type": "object",
                        "description": "Type of emails to search for",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": ["all", "personal", "generic"],
                                "description": "Email type filter"
                            },
                            "priority_type": {
                                "type": "string",
                                "enum": ["only", "priority"],
                                "description": "Priority type filter"
                            }
                        }
                    },
                    "department": {
                        "type": "object",
                        "description": "Department filter",
                        "properties": {
                            "name": {
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "enum": [
                                        "all",
                                        "engineering",
                                        "sales",
                                        "finance",
                                        "hr",
                                        "it",
                                        "marketing",
                                        "operations",
                                        "management",
                                        "executive",
                                        "legal",
                                        "support",
                                        "communication",
                                        "software",
                                        "security",
                                        "pr",
                                        "warehouse",
                                        "diversity",
                                        "administrative",
                                        "facilities",
                                        "accounting"
                                    ]
                                },
                                "minItems": 1,
                                "uniqueItems": true,
                                "description": "List of departments to include"
                            },
                            "priority_type": {
                                "type": "string",
                                "enum": ["only", "priority"],
                                "description": "Priority type filter"
                            }
                        }
                    }
                }
            },
            "BulkPostFinder": {
                "type": "object",
                "properties": {
                    "column_first": {
                        "type": "integer",
                        "description": "First name column number"
                    },
                    "column_last": {
                        "type": "integer",
                        "description": "Last name column number"
                    },
                    "column_name": {
                        "type": "integer",
                        "description": "Full name column number"
                    },
                    "column_domain": {
                        "type": "integer",
                        "description": "Domain column number (required)"
                    },
                    "skip": {
                        "type": "boolean",
                        "description": "Skip first row (header)"
                    }
                }
            },
            "BulkPhoneValidator": {
                "type": "object",
                "properties": {
                    "column_phone": {
                        "type": "integer",
                        "description": "Phone number column"
                    },
                    "column_country": {
                        "type": "integer",
                        "description": "Country column"
                    }
                }
            },
            "BulkItem": {
                "type": "object",
                "properties": {
                    "bulk_id": {
                        "type": "integer",
                        "format": "int64",
                        "description": "Unique identifier for the bulk operation"
                    },
                    "name": {
                        "type": "string",
                        "description": "Name of the bulk operation"
                    },
                    "maximum": {
                        "type": "string",
                        "description": "Maximum results setting"
                    },
                    "email_type": {
                        "type": "string",
                        "description": "Email type filter"
                    },
                    "department": {
                        "type": "string",
                        "description": "Department filter"
                    },
                    "sources": {
                        "type": "boolean",
                        "description": "Sources included"
                    },
                    "file_name": {
                        "type": "string",
                        "description": "Generated filename"
                    },
                    "total": {
                        "type": "integer",
                        "description": "Total results"
                    },
                    "total_list": {
                        "type": "integer",
                        "description": "Total items in list"
                    },
                    "status": {
                        "type": "boolean",
                        "description": "Completion status"
                    },
                    "chart": {
                        "type": "object",
                        "description": "Chart data"
                    },
                    "table": {
                        "type": "object",
                        "description": "Table data"
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Creation timestamp"
                    },
                    "user_id": {
                        "type": "integer",
                        "format": "int64",
                        "description": "User ID who created the bulk"
                    },
                    "launched": {
                        "type": "boolean",
                        "description": "Whether the bulk has been launched"
                    },
                    "used": {
                        "type": "boolean",
                        "description": "Whether results have been downloaded"
                    },
                    "time_track": {
                        "type": "string",
                        "description": "Time tracking information"
                    },
                    "progress": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100,
                        "description": "Progress percentage"
                    },
                    "verify": {
                        "type": "boolean",
                        "description": "Verification enabled"
                    },
                    "verify_cost": {
                        "type": "integer",
                        "description": "Verification cost"
                    },
                    "total_emails": {
                        "type": "integer",
                        "description": "Total emails found"
                    },
                    "processed": {
                        "type": "integer",
                        "description": "Number of items processed"
                    },
                    "expired_at": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Expiration timestamp"
                    },
                    "expired": {
                        "type": "boolean",
                        "description": "Whether the bulk has expired"
                    },
                    "bulk_type": {
                        "type": "string",
                        "description": "Type of bulk operation"
                    }
                }
            },
            "BulkProgress": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "boolean",
                        "description": "Current status"
                    },
                    "progress": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 100,
                        "description": "Progress percentage"
                    },
                    "processed": {
                        "type": "integer",
                        "description": "Number of items processed"
                    }
                }
            },
            "PaginationMeta": {
                "type": "object",
                "properties": {
                    "total": {
                        "type": "integer",
                        "description": "Total number of items"
                    },
                    "pageSize": {
                        "type": "integer",
                        "description": "Items per page"
                    },
                    "current": {
                        "type": "integer",
                        "description": "Current page number"
                    },
                    "total_pages": {
                        "type": "number",
                        "description": "Total number of pages"
                    }
                }
            },
            "DataID": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "format": "int64",
                        "description": "Created resource ID"
                    }
                }
            },
            "Data": {
                "type": "object",
                "properties": {
                    "status": {
                        "type": "boolean",
                        "description": "Operation status"
                    },
                    "message": {
                        "type": "string",
                        "description": "Status message"
                    },
                    "code": {
                        "type": "integer",
                        "description": "HTTP status code"
                    }
                }
            },
            "Error": {
                "type": "object",
                "description": "Error details object used in reusable error responses.",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "params_invalid",
                            "unknown_record",
                            "unknown_route",
                            "queued",
                            "rate_limit",
                            "api_error",
                            "ip_blocked",
                            "authentication_failed",
                            "csrf_failed"
                        ],
                        "description": "Error type"
                    },
                    "message": {
                        "type": "string",
                        "description": "Error message"
                    },
                    "code": {
                        "type": "integer",
                        "description": "HTTP status code"
                    }
                },
                "required": ["type", "message", "code"],
                "example": {
                    "type": "rate_limit",
                    "message": "Too many requests. Try again later.",
                    "code": 429
                }
            },
            "DomainSuggestionsResponse": {
                "type": "object",
                "required": ["data", "meta"],
                "properties": {
                    "data": {
                        "type": "array",
                        "description": "Array of suggested domain objects",
                        "items": {
                            "$ref": "#/components/schemas/DomainSuggestion"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/SuggestionsMeta"
                    }
                }
            },
            "DomainSuggestion": {
                "type": "object",
                "required": ["name", "domain", "email_count"],
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "The company or organization name associated with the domain",
                        "minLength": 1,
                        "maxLength": 255,
                        "example": "Zapier"
                    },
                    "domain": {
                        "type": "string",
                        "description": "The primary domain name of the suggested company",
                        "format": "hostname",
                        "pattern": "^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]*\\.[a-zA-Z]{2,}$",
                        "example": "zapier.com"
                    },
                    "email_count": {
                        "type": "integer",
                        "description": "The number of email addresses available for this domain",
                        "minimum": 0,
                        "example": 455
                    }
                }
            },
            "SuggestionsMeta": {
                "type": "object",
                "required": ["query", "limit", "total_found"],
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "The original search query used to generate suggestions",
                        "example": "zapier.com"
                    },
                    "limit": {
                        "type": "integer",
                        "description": "The maximum number of suggestions returned in this response",
                        "minimum": 1,
                        "maximum": 50,
                        "example": 5
                    },
                    "total_found": {
                        "type": "integer",
                        "description": "Total number of suggestions found (may be more than returned due to limit)",
                        "minimum": 0,
                        "example": 15
                    },
                    "country": {
                        "type": "string",
                        "description": "Country filter applied to the search",
                        "pattern": "^[A-Z]{2}$",
                        "example": "US",
                        "nullable": true
                    },
                    "industry": {
                        "type": "string",
                        "description": "Industry filter applied to the search",
                        "example": "technology",
                        "nullable": true
                    },
                    "min_emails": {
                        "type": "integer",
                        "description": "Minimum email count filter applied",
                        "minimum": 0,
                        "example": 10,
                        "nullable": true
                    },
                    "processing_time": {
                        "type": "number",
                        "description": "Time taken to process the request in milliseconds",
                        "format": "float",
                        "minimum": 0,
                        "example": 156.7,
                        "nullable": true
                    }
                }
            },
            "LinkedinFinder": {
                "type": "object",
                "description": "LinkedIn Finder API response",
                "properties": {
                    "data": {
                        "oneOf": [
                            {
                                "$ref": "#/components/schemas/LinkedinFinderData"
                            },
                            {
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/LinkedinFinderData"
                                }
                            }
                        ],
                        "description": "Single result or array of results"
                    }
                }
            },
            "LinkedinFinderData": {
                "type": "object",
                "description": "LinkedIn Finder result data",
                "properties": {
                    "website_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Company website URL"
                    },
                    "accept_all": {
                        "type": "boolean",
                        "nullable": true,
                        "description": "Whether the domain accepts all emails"
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "description": "Email address found"
                    },
                    "first_name": {
                        "type": "string",
                        "description": "First name of the person"
                    },
                    "last_name": {
                        "type": "string",
                        "description": "Last name of the person"
                    },
                    "full_name": {
                        "type": "string",
                        "description": "Full name of the person"
                    },
                    "country": {
                        "type": "string",
                        "nullable": true,
                        "description": "Country of the person"
                    },
                    "gender": {
                        "type": "string",
                        "description": "Gender of the person"
                    },
                    "phone_number": {
                        "type": "boolean",
                        "description": "Indicates if a phone number is available"
                    },
                    "position": {
                        "type": "string",
                        "description": "Job position/title"
                    },
                    "twitter": {
                        "type": "string",
                        "nullable": true,
                        "description": "Twitter handle"
                    },
                    "linkedin": {
                        "type": "string",
                        "format": "uri",
                        "description": "LinkedIn profile URL"
                    },
                    "disposable": {
                        "type": "boolean",
                        "description": "Whether the email is from a disposable domain"
                    },
                    "webmail": {
                        "type": "boolean",
                        "description": "Whether the email is from a webmail provider"
                    },
                    "company": {
                        "type": "string",
                        "description": "Company name"
                    },
                    "score": {
                        "type": "number",
                        "description": "Confidence score of the result",
                        "minimum": 0,
                        "maximum": 100
                    },
                    "verification": {
                        "$ref": "#/components/schemas/LinkedinFinderVerification"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/LinkedinFinderSource"
                        },
                        "description": "Sources where the email was found"
                    },
                    "info": {
                        "$ref": "#/components/schemas/AuthorInfo"
                    }
                }
            },
            "LinkedinFinderSource": {
                "type": "object",
                "description": "Source information for email discovery",
                "properties": {
                    "uri": {
                        "type": "string",
                        "format": "uri",
                        "description": "Source URI"
                    },
                    "website_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Website URL of the source"
                    },
                    "extracted_on": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Date when the email was first extracted"
                    },
                    "last_seen_on": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Date when the email was last seen"
                    },
                    "still_on_page": {
                        "type": "boolean",
                        "description": "Whether the email is still present on the page"
                    }
                }
            },
            "LinkedinFinderVerification": {
                "type": "object",
                "description": "Email verification status",
                "properties": {
                    "date": {
                        "type": "string",
                        "format": "date-time",
                        "description": "Date of verification"
                    },
                    "status": {
                        "type": "string",
                        "description": "Verification status",
                        "enum": ["valid", "invalid", "accept_all", "unknown"]
                    }
                }
            },
            "AuthorInfo": {
                "type": "object",
                "description": "Author information from content sources",
                "properties": {
                    "url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Author profile URL"
                    },
                    "title": {
                        "type": "string",
                        "description": "Page or article title"
                    },
                    "og_image": {
                        "type": "string",
                        "format": "uri",
                        "description": "Open Graph image URL"
                    },
                    "description": {
                        "type": "string",
                        "description": "Page or author description"
                    },
                    "full_name": {
                        "type": "string",
                        "description": "Full name of the author"
                    },
                    "first_name": {
                        "type": "string",
                        "description": "First name of the author"
                    },
                    "last_name": {
                        "type": "string",
                        "description": "Last name of the author"
                    },
                    "article_domain": {
                        "type": "string",
                        "description": "Domain where the article was found"
                    },
                    "same_as_domain": {
                        "type": "string",
                        "description": "Related domain identifier"
                    },
                    "linkedin": {
                        "type": "string",
                        "format": "uri",
                        "description": "LinkedIn profile URL"
                    },
                    "twitter": {
                        "type": "string",
                        "description": "Twitter handle"
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "description": "Email address"
                    },
                    "image": {
                        "type": "string",
                        "format": "uri",
                        "description": "Author image URL"
                    },
                    "gravatar": {
                        "type": "boolean",
                        "description": "Whether author has a Gravatar"
                    },
                    "emails": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "format": "email"
                        },
                        "description": "List of associated email addresses"
                    },
                    "author_score": {
                        "type": "number",
                        "nullable": true,
                        "description": "Author credibility score"
                    }
                }
            }
        },
        "responses": {
            "BulkListResponse": {
                "description": "List of bulk operations",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "data": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/BulkItem"
                                    }
                                },
                                "meta": {
                                    "$ref": "#/components/schemas/PaginationMeta"
                                }
                            }
                        }
                    }
                }
            },
            "BulkDetailResponse": {
                "description": "Bulk operation details",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "data": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/BulkItem"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "BulkCreateResponse": {
                "description": "Bulk operation created successfully",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "data": {
                                    "$ref": "#/components/schemas/DataID"
                                }
                            }
                        }
                    }
                }
            },
            "BulkProgressResponse": {
                "description": "Bulk operation progress",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/BulkProgress"
                        }
                    }
                }
            },
            "SuccessResponse": {
                "description": "Operation completed successfully",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "data": {
                                    "$ref": "#/components/schemas/Data"
                                }
                            }
                        }
                    }
                }
            },
            "ValidationError": {
                "description": "Validation error",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "errors": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        },
                        "example": {
                            "errors": {
                                "type": "params_invalid",
                                "message": "The provided parameters are invalid.",
                                "code": 422
                            }
                        }
                    }
                }
            },
            "NotFoundError": {
                "description": "Resource not found",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "errors": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        },
                        "example": {
                            "errors": {
                                "type": "unknown_record",
                                "message": "The requested resource was not found.",
                                "code": 404
                            }
                        }
                    }
                }
            },
            "RateLimitError": {
                "description": "Rate limit exceeded",
                "content": {
                    "application/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "errors": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        },
                        "example": {
                            "errors": {
                                "type": "rate_limit",
                                "message": "Rate limit exceeded. Retry after the reset window.",
                                "code": 429
                            }
                        }
                    }
                }
            }
        },
        "securitySchemes": {
            "Tomba-Api-Key": {
                "type": "apiKey",
                "description": "Tomba API key passed in the `X-Tomba-Key` header.",
                "name": "X-Tomba-Key",
                "in": "header"
            },
            "Tomba-Api-Secret": {
                "type": "apiKey",
                "description": "Tomba API secret passed in the `X-Tomba-Secret` header.",
                "name": "X-Tomba-Secret",
                "in": "header"
            }
        }
    }
}