Skip to main content
Wiza logo

​
Overview

Add Wiza to any ModuleX agent or workflow. Find, enrich, and verify B2B contact data with Wiza — prospect search, company enrichment, individual contact reveal (verified emails and phone numbers), and credit-balance lookup against the Wiza REST API (wiza.co/api).
Categories: Sales · Enrichment · Sales Engagement · Auth: API Key · Actions: 4

​
Authentication

​
API Key Authentication

Authenticate using your Wiza API key
1

Step 1

Log in to your Wiza account at https://app.wiza.co
2

Step 2

Open Settings -> API and generate a new API key (or copy an existing one)
3

Step 3

Paste the API key below

​
Required Credentials

FieldDescriptionRequiredFormat
Wiza API KeyYour Wiza API key from Settings -> APIYes-

​
Available Actions

​
Parameters

​
size
integer
Number of sample profiles to return (0-30, default 0 returns total only)
​
filters
object
Full filters object (overrides individual filter params if provided)
​
first_name
array
Exact first names to match (e.g., [“John”, “Jane”])
​
last_name
array
Exact last names to match
​
job_title
array
Job titles to include/exclude (e.g., [{“v”:“CEO”,“s”:“i”}])
​
job_title_level
array
Seniority levels (e.g., [“cxo”, “director”, “manager”])
​
job_role
array
Job role categories (e.g., [“sales”, “engineering”])
​
job_sub_role
array
Detailed role categories (e.g., [“software”, “product”])
​
location
array
Person location filters (city/state/country with include/exclude)
​
skill
array
Professional skills (e.g., [“python”, “marketing”])
​
school
array
Educational institutions
​
major
array
Field of study
​
linkedin_slug
array
LinkedIn profile slugs
​
job_company
array
Current company filters (include/exclude)
​
past_company
array
Past company filters (include/exclude)
​
company_location
array
Company HQ location filters
​
company_industry
array
Company industry filters (include/exclude)
​
company_size
array
Company headcount brackets (e.g., [“11-50”, “51-200”])
​
company_type
array
Company type (e.g., [“private”, “public”])

​
Response

{
  "$defs": {
    "ProspectProfile": {
      "additionalProperties": false,
      "description": "A single sample profile row in ``prospect_search``.",
      "properties": {
        "full_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Full Name"
        },
        "linkedin_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Linkedin Url"
        },
        "industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Industry"
        },
        "job_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Title"
        },
        "job_title_role": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Title Role"
        },
        "job_title_sub_role": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Title Sub Role"
        },
        "job_company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Company Name"
        },
        "job_company_website": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Company Website"
        },
        "location_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location Name"
        }
      },
      "title": "ProspectProfile",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    },
    "profiles": {
      "items": {
        "$ref": "#/$defs/ProspectProfile"
      },
      "title": "Profiles",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ProspectSearchOutput",
  "type": "object"
}

​
Parameters

​
company_name
string
Company name (e.g., “Wiza”)
​
company_domain
string
Company domain (e.g., “wiza.co”)
​
company_linkedin_id
string
Company LinkedIn ID
​
company_linkedin_slug
string
Company LinkedIn slug from the URL

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "company_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Name"
    },
    "company_domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Domain"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "company_industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Industry"
    },
    "company_size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Size"
    },
    "company_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Size Range"
    },
    "company_founded": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Founded"
    },
    "company_revenue_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Revenue Range"
    },
    "company_funding": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Funding"
    },
    "company_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Type"
    },
    "company_description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Description"
    },
    "company_ticker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Ticker"
    },
    "company_last_funding_round": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Last Funding Round"
    },
    "company_last_funding_amount": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Last Funding Amount"
    },
    "company_last_funding_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Last Funding At"
    },
    "company_location": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Location"
    },
    "company_twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Twitter"
    },
    "company_facebook": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Facebook"
    },
    "company_linkedin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Linkedin"
    },
    "company_linkedin_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Linkedin Id"
    },
    "company_street": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Street"
    },
    "company_locality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Locality"
    },
    "company_region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Region"
    },
    "company_postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Postal Code"
    },
    "company_country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Country"
    },
    "credits": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits"
    }
  },
  "required": [
    "success"
  ],
  "title": "CompanyEnrichmentOutput",
  "type": "object"
}

​
Parameters

​
enrichment_level
string
required
Enrichment depth: ‘none’, ‘partial’, ‘phone’, or ‘full’
​
profile_url
string
LinkedIn profile URL (e.g., https://linkedin.com/in/johndoe)
​
full_name
string
Full name (used with company or domain)
​
company
string
Company name (used with full_name)
​
domain
string
Company domain (used with full_name)
​
email
string
Email address (use alone or with other identifiers)
​
accept_work
boolean
Whether to accept work emails (email_options)
​
accept_personal
boolean
Whether to accept personal emails (email_options)

​
Response

{
  "$defs": {
    "RevealEmail": {
      "additionalProperties": false,
      "description": "A single email entry in ``individual_reveal``'s ``emails`` list.",
      "properties": {
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "email_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email Type"
        },
        "email_status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email Status"
        }
      },
      "title": "RevealEmail",
      "type": "object"
    },
    "RevealPhone": {
      "additionalProperties": false,
      "description": "A single phone entry in ``individual_reveal``'s ``phones`` list.",
      "properties": {
        "number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Number"
        },
        "pretty_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pretty Number"
        },
        "type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Type"
        }
      },
      "title": "RevealPhone",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "is_complete": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Is Complete"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    },
    "enrichment_level": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enrichment Level"
    },
    "linkedin_profile_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Linkedin Profile Url"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Title"
    },
    "location": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Location"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "email_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email Type"
    },
    "email_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email Status"
    },
    "emails": {
      "items": {
        "$ref": "#/$defs/RevealEmail"
      },
      "title": "Emails",
      "type": "array"
    },
    "mobile_phone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Mobile Phone"
    },
    "phone_number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Phone Number"
    },
    "phone_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Phone Status"
    },
    "phones": {
      "items": {
        "$ref": "#/$defs/RevealPhone"
      },
      "title": "Phones",
      "type": "array"
    },
    "company_size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Size"
    },
    "company_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Size Range"
    },
    "company_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Type"
    },
    "company_domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Domain"
    },
    "company_locality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Locality"
    },
    "company_region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Region"
    },
    "company_country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Country"
    },
    "company_street": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Street"
    },
    "company_postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Postal Code"
    },
    "company_founded": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Founded"
    },
    "company_funding": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Funding"
    },
    "company_revenue": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Revenue"
    },
    "company_industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Industry"
    },
    "company_subindustry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Subindustry"
    },
    "company_linkedin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Linkedin"
    },
    "company_location": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Location"
    },
    "company_description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Description"
    },
    "credits": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits"
    }
  },
  "required": [
    "success"
  ],
  "title": "IndividualRevealOutput",
  "type": "object"
}

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "email_credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email Credits"
    },
    "phone_credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Phone Credits"
    },
    "export_credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Export Credits"
    },
    "api_credits": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Credits"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCreditsOutput",
  "type": "object"
}

​
Limits & Quotas

  • Rate limit: ~30 requests/minute (43,200/day) per key.
  • Credits: usage is metered in API credits — 2 credits per valid email and 5 per phone on individual_reveal, 2 credits per successful company_enrichment; prospect_search and get_credits consume no credits. Credits are charged only when data is returned.
  • Asynchronous reveals: individual_reveal starts a reveal and polls GET /api/individual_reveals/{id} until the status is terminal (finished/failed) or a 120-second window elapses.
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising. Plan for retries on the agent side based on the error string.

Enrow

Findymail

Icypeas