Wiza

https://docs.wiza.co
Admin
Wiza is a data enrichment API platform for finding emails, phone numbers, LinkedIn profiles, and...
Tokens:35,822
Snippets:160
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### Continue Prospect Search API Client Examples

Source: https://docs.wiza.co/api-reference/prospect-lists/continue-prospect-search

Code examples for calling the continue_search endpoint using various programming languages.

```Javascript
const apiKey = "your api key here" // update with your api_key

const listId = 0 // update with the ID of the list you would like to
continue searching


const myHeaders = new Headers();

myHeaders.append('Content-Type', 'application/json');

myHeaders.append('Authorization', `Bearer ${apiKey}`);


const raw = JSON.stringify({
  'id': listId
});


const requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};


fetch('https://wiza.co/api/prospects/continue_search',
requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

```Python
import http.client

import json


api_key = "your api key here" # update with your api_key

list_id = 0 # update with the ID of the list you would like to
continue searching


conn = http.client.HTTPSConnection('wiza.co')

payload = json.dumps({
  'id': list_id
})

authorization = ("Bearer {api_key}").format(api_key=api_key)

headers = {
  'Content-Type': 'application/json',
  'Authorization': authorization
}

conn.request('POST', '/api/prospects/continue_search', payload,
headers)

res = conn.getresponse()

data = res.read()

print(data.decode('utf-8'))
```

```Ruby
require 'uri'

require 'json'

require 'net/http'


api_key = "your api key here" # update with your api_key

list_id = 0 # update with the ID of the list you would like to
continue searching


url = URI('https://wiza.co/api/prospects/continue_search')


https = Net::HTTP.new(url.host, url.port);

https.use_ssl = true

request = Net::HTTP::Post.new(url)

request['Content-Type'] = 'application/json'

request['Authorization'] = "Bearer #{api_key}"

request.body = JSON.dump({
  'id': list_id
})


response = https.request(request)

puts response.read_body
```

```Curl
api_key="your api key here" # update with your api_key

list_id=0 # update with the ID of the list you would like to
continue searching


curl --location 'https://wiza.co/api/prospects/continue_search'
```

--------------------------------

### Individual Reveal Request Examples

Source: https://docs.wiza.co/api-reference/individual-reveals/start-individual-reveal

Examples of JSON request bodies for initiating an individual reveal using different input methods.

```json
individual_reveal:
  full_name: Stephen Hakami
  company: Wiza
  domain: wiza.co
enrichment_level: partial
email_options:
  accept_work: true
  accept_personal: false
```

```json
individual_reveal:
  profile_url: https://www.linkedin.com/in/stephen-hakami-5babb21b0/
enrichment_level: partial
```

```json
individual_reveal:
  email: stephen@wiza.co
enrichment_level: phone
```

--------------------------------

### Webhook Handling Examples

Source: https://docs.wiza.co/using-the-api/webhooks

Examples of how to handle incoming webhook requests in different programming languages. Your endpoint must acknowledge receipt immediately with a 200 status code.

```APIDOC
## Handling Webhook Requests

Respond quickly with a `200` status code to acknowledge receipt. If your processing takes time, accept the webhook first and handle the work asynchronously in a background job.

Use `status.code` to check for success (`200`) or failure (`400`).

### JavaScript Example
```javascript
app.post('/webhook', (req, res) => {
  // Acknowledge receipt immediately
  res.status(200).send('OK');

  // Process asynchronously
  const { status, data } = req.body;

  if (status.code === 200) {
    processReveal(data);
  }
});
```

### Python Example
```python
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def wiza_webhook():
    payload = request.get_json()
    status = payload.get('status', {})
    data = payload.get('data')

    if status.get('code') == 200:
        process_reveal(data)

    # Acknowledge receipt immediately
    return jsonify({'status': 'ok'}), 200
```

### Ruby Example
```ruby
post '/webhook' do
  payload = JSON.parse(request.body.read)
  payload_status = payload['status']
  data = payload['data']

  if payload_status['code'] == 200
    process_reveal(data)
  end

  # Acknowledge receipt immediately
  status 200
  { status: 'ok' }.to_json
end
```
```

--------------------------------

### Webhook Payload Examples

Source: https://docs.wiza.co/using-the-api/webhooks

View the structure of successful and failed webhook responses.

```json
{
  "status": {
    "code": 200,
    "message": "Single reveal finished"
  },
  "type": "individual_reveal",
  "data": {
    "id": 123456,
    "status": "finished",
    "is_complete": true,
    "name": "Stephen Hakami",
    "company": "Wiza",
    "enrichment_level": "partial",
    "linkedin_profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/",
    "title": "Founder, Chief Executive Officer",
    "location": "Toronto, Ontario, Canada",
    "email": "stephen@wiza.co",
    "email_type": "work",
    "email_status": "valid",
    "emails": [
      {
        "email": "stephen@wiza.co",
        "email_type": "work",
        "email_status": "valid"
      }
    ],
    "credits": {
      "email_credits": 1,
      "phone_credits": 0,
      "export_credits": 0,
      "api_credits": {
        "total": 2,
        "email_credits": 2,
        "phone_credits": 0,
        "scrape_credits": 1
      }
    }
  }
}
```

```json
{
  "status": {
    "code": 400,
    "message": "Single reveal failed"
  },
  "type": "individual_reveal",
  "data": {
    "id": 123456,
    "status": "failed",
    "fail_error": "..."
  }
}
```

--------------------------------

### Get Credits

Source: https://docs.wiza.co/api-reference/credits/get-credits

Retrieve the number of credits remaining in your account.

```APIDOC
## GET /api/meta/credits

### Description
Get the number of credits remaining in your account.

### Method
GET

### Endpoint
/api/meta/credits

### Parameters

### Request Body

### Request Example

### Response
#### Success Response (200)
- **credits** (object) - Object containing credit details.
  - **email_credits** (string or integer) - Number of email credits remaining, 'unlimited' if unlimited.
  - **phone_credits** (string or integer) - Number of phone credits remaining, 'unlimited' if unlimited.
  - **export_credits** (integer) - Number of export credits remaining.
  - **api_credits** (number) - Number of API credits remaining.

#### Response Example
```json
{
  "credits": {
    "email_credits": "unlimited",
    "phone_credits": 100,
    "export_credits": 0,
    "api_credits": 100
  }
}
```
```

--------------------------------

### POST /api/lists

Source: https://docs.wiza.co/api-reference/lists/create-list

Creates a list of people to enrich. Upon completion, an update is sent to the configured webhook URL. The status can be checked via GET /api/lists/:id and contacts via GET /api/lists/:id/contacts.

```APIDOC
## POST /api/lists

### Description
Creates a list of people to enrich. Once the list is completed, an update will be posted to the webhook URL as configured in your account settings. The payload will be the same as the response of this endpoint. If you wish to do added authentication, the headers in the webhook request will include `x-auth-key` which will be a SHA256 hash of your api key. You can get the status of the list by calling the `GET /api/lists/:id` endpoint. And you can get the contacts by calling the `GET /api/lists/:id/contacts` endpoint. Please check the status of the list as it may fail sometimes due to LinkedIn rate limiting.

### Method
POST

### Endpoint
/api/lists

### Parameters

### Request Body
- **list** (object) - Required - Details of the list to be created.
  - **name** (string) - Required - Name of the list. e.g. "VP of Sales in San Francisco"
  - **enrichment_level** (string) - Required - Enum: "none", "partial", "full". Enrichment level of the list.
    - "none": Will enrich with contact's data when you provide a Linkedin profile url or email. But will not find emails or phone numbers.
    - "partial": Will find emails.
    - "full": Will find emails and phone numbers.
  - **email_options** (object) - Required - Types of emails to return.
    - **accept_work** (boolean) - Professional email address, i.e. tim.cooke@apple.com
    - **accept_personal** (boolean) - A personal email address, i.e. tcooke1960@gmail.com
    - **accept_generic** (boolean) - A generic email address, i.e. hello@apple.com
  - **items** (array) - Required - List of items to be enriched. Each item can be either contact details or a Linkedin profile URL of any type (Linkedin, Sales Navigator, or Recruiter). There is a limit of 2500 items per list.
    - (object) - Can be ContactDetailsInput, LinkedinProfileInput, or EmailInput.
  - **callback_url** (string) - Optional - URL to send the list update to. If not provided, the default webhook URL configured in your account settings will be used.

### Request Example
```json
{
  "list": {
    "name": "VP of Sales in San Francisco",
    "enrichment_level": "partial",
    "email_options": {
      "accept_work": true,
      "accept_personal": true,
      "accept_generic": true
    },
    "items": [
      {
        "full_name": "Stephen Hakami",
        "company": "Wiza",
        "domain": "wiza.co"
      },
      {
        "profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/"
      },
      {
        "email": "stephen@wiza.co"
      }
    ]
  }
}
```

### Response
#### Success Response (200)
- **list** (object) - Description of the created list.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Create a List with Ruby

Source: https://docs.wiza.co/api-reference/lists/create-list

This Ruby code snippet shows how to create a list via the Wiza API using Net::HTTP. Ensure you have the 'uri' and 'json' gems installed and replace the placeholder API key.

```Ruby
require "uri"
require "json"
require "net/http"

api_key = "your api key here" # update with your api_key

url = URI("https://wiza.co/api/lists")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer #{api_key}"
request.body = JSON.dump({
  "list": {
    "name": "List name",
    "enrichment_level": "partial",
    "email_options": {
      "accept_work": true,
      "accept_personal": true,
      "accept_generic": true
    },
    "items": [
      {
        "full_name": "Stephen Hakami",
        "company": "Wiza",

```

--------------------------------

### Legacy Endpoints - Get List

Source: https://docs.wiza.co/

Retrieves the status and details of a previously created list.

```APIDOC
## GET /lists/{list_id}

### Description
Retrieves the status and details of a previously created list.

### Method
GET

### Endpoint
/lists/{list_id}

### Parameters
#### Path Parameters
- **list_id** (string) - Required - The unique identifier of the list.

### Response
#### Success Response (200)
- **list_id** (string) - The unique identifier for the list.
- **name** (string) - The name of the list.
- **status** (string) - The current status of the list (e.g., 'processing', 'completed').
- **enriched_contacts_count** (integer) - The number of contacts that have been enriched.

#### Response Example
```json
{
  "list_id": "list_abcde",
  "name": "Q1 Leads",
  "status": "completed",
  "enriched_contacts_count": 100
}
```
```

--------------------------------

### Start Individual Reveal Request

Source: https://docs.wiza.co/using-the-api/find-mobile-phone-number

Initiate a phone enrichment request by sending a POST request to the individual_reveals endpoint.

```json
{
  "individual_reveal": {
    "profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/"
  },
  "enrichment_level": "phone"
}
```

--------------------------------

### GET /contacts

Source: https://docs.wiza.co/api-reference/lists/get-list-contacts

Retrieves a list of contact and company information.

```APIDOC
## GET /contacts

### Description
Retrieves a list of contact records containing professional details, company information, and social profile links.

### Method
GET

### Endpoint
/contacts

### Response
#### Success Response (200)
- **data** (array) - List of contact objects
  - **list_name** (string) - Name of the list
  - **email** (string) - Contact email address
  - **full_name** (string) - Full name of the contact
  - **title** (string) - Job title
  - **linkedin** (string) - LinkedIn profile URL
  - **company** (string) - Company name
  - **company_domain** (string) - Company website domain

#### Response Example
{
  "data": [
    {
      "list_name": "from api1",
      "email": "stephen@wiza.co",
      "full_name": "Stephen Hakami",
      "title": "Founder, Chief Executive Officer",
      "linkedin": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/",
      "company": "Wiza",
      "company_domain": "wiza.co"
    }
  ]
}
```

--------------------------------

### Retrieve a list by ID

Source: https://docs.wiza.co/api-reference/lists/get-list

Use these examples to fetch list details from the Wiza API. Ensure you replace the placeholder API key and list ID with your actual credentials.

```Javascript
const apiKey = "your api key here" // update with your api_key

const listId = 0 // update with the id of the list that you would
like returned


const myHeaders = new Headers();

myHeaders.append('Authorization', `Bearer ${apiKey}`);


const requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};


fetch(`https://wiza.co/api/lists/${listId}`, requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

```Python
import http.client


api_key = "your api key here" # update with your api_key

list_id = 0 # update with the id of the list that you would like
returned


conn = http.client.HTTPSConnection('wiza.co')

authorization = ("Bearer {api_key}").format(api_key=api_key)

payload = ''

headers = { 'Authorization': authorization }

url = ("/api/lists/{list_id}").format(list_id=list_id)

conn.request('GET', url, payload, headers)

res = conn.getresponse()

data = res.read()

print(data.decode('utf-8'))
```

```Ruby
require 'uri'

require 'net/http'


api_key = "your api key here" # update with your api_key

list_id = 0 # update with the id of the list that you would like
returned


url = URI("https://wiza.co/api/lists/#{list_id}")


https = Net::HTTP.new(url.host, url.port);

https.use_ssl = true

request = Net::HTTP::Get.new(url)

request['Authorization'] = "Bearer #{api_key}"


response = https.request(request)

puts response.read_body
```

```Curl
api_key="your api key here" # update with your api_key

list_id=0 # update with the id of the list that you would like
returned


curl --location "https://wiza.co/api/lists/${list_id}" --header
"Authorization: Bearer ${api_key}"
```

--------------------------------

### Initiate Individual Reveal Request

Source: https://docs.wiza.co/using-the-api/find-email-addresses

Send a POST request to the individual_reveals endpoint to start the email discovery process. Specify email preferences using the email_options object.

```json
{
  "individual_reveal": {
    "profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/"
  },
  "enrichment_level": "partial",
  "email_options": {
    "accept_work": true,
    "accept_personal": false
  }
}
```

--------------------------------

### Start Individual Reveal

Source: https://docs.wiza.co/using-the-api/find-linkedin-profile-information

Initiates the process of retrieving LinkedIn profile information by sending a POST request. The response includes an ID that will be used in the next step.

```APIDOC
## POST /api/individual_reveals

### Description
Send a POST request with your API key and set `"enrichment_level": "none"` to retrieve LinkedIn profile information. Wiza retrieves this data in real-time and returns the fields listed under [LinkedIn Profile Information](/overview/data-dictionary#linkedin-profile-information) and [Company Information](/overview/data-dictionary#company-details) in the Data Dictionary.

<Note>
  Not all data points are included by default. To include additional LinkedIn attributes, go to **Settings → Data & Export → Advanced Columns** and enable the desired fields.
</Note>

<Note>
  The request may take 0 - 15 seconds to process, with an average response time of ~5 seconds. The response will include an `id`, which you will use in Step 2 to retrieve the enriched LinkedIn profile data.
</Note>

### Method
POST

### Endpoint
https://wiza.co/api/individual_reveals

### Parameters
#### Request Body
- **api_key** (string) - Required - Your Wiza API key.
- **enrichment_level** (string) - Required - Set to "none" to retrieve basic LinkedIn profile information.

### Request Example
```json
{
  "api_key": "YOUR_API_KEY",
  "enrichment_level": "none"
}
```

### Response
#### Success Response (200)
- **id** (string) - A unique identifier for the reveal, used to retrieve the results in Step 2.

#### Response Example
```json
{
  "id": "reveal_id_12345"
}
```
```

--------------------------------

### Start Individual Reveal

Source: https://docs.wiza.co/using-the-api/find-email-addresses

Initiates the process of finding email addresses for a given LinkedIn profile. It returns an ID that is used to retrieve the results in a subsequent step.

```APIDOC
## POST /api/individual_reveals

### Description
Send a POST request with your API key to retrieve work and/or personal email addresses for a LinkedIn profile. Specify the desired email types using the `email_options` object.

### Method
POST

### Endpoint
`https://wiza.co/api/individual_reveals`

### Parameters
#### Request Body
- **individual_reveal** (object) - Required - Contains the LinkedIn profile URL.
  - **profile_url** (string) - Required - The URL of the LinkedIn profile.
- **enrichment_level** (string) - Required - Specifies the level of enrichment. Use `"partial"` to retrieve emails.
- **email_options** (object) - Required - Specifies which types of emails to retrieve.
  - **accept_work** (boolean) - Optional - Set to `true` to include work emails. Defaults to `false`.
  - **accept_personal** (boolean) - Optional - Set to `true` to include personal emails. Defaults to `false`.

### Request Example
```json
{
  "individual_reveal": {
    "profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/"
  },
  "enrichment_level": "partial",
  "email_options": {
    "accept_work": true,
    "accept_personal": false
  }
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the reveal request, used to retrieve results.

#### Response Example
```json
{
  "id": "some_unique_id"
}
```
```

--------------------------------

### Make an Individual Reveal API Request

Source: https://docs.wiza.co/using-the-api/authorization

Examples of making a POST request to the `/api/individual_reveals` endpoint with the correct Authorization header and JSON payload. Ensure your API key is correctly formatted as a Bearer token.

```curl
curl -X POST https://wiza.co/api/individual_reveals \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "individual_reveal": {
        "profile_url": "https://www.linkedin.com/in/example/"
      },
      "enrichment_level": "partial"
    }'
```

```javascript
const apiKey = "YOUR_API_KEY";

  const response = await fetch("https://wiza.co/api/individual_reveals", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      individual_reveal: {
        profile_url: "https://www.linkedin.com/in/example/"
      },
      enrichment_level: "partial"
    })
  });

  const data = await response.json();
  console.log(data);
```

```python
import requests

api_key = "YOUR_API_KEY"

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

payload = {
    "individual_reveal": {
        "profile_url": "https://www.linkedin.com/in/example/"
    },
    "enrichment_level": "partial"
}

response = requests.post(
    "https://wiza.co/api/individual_reveals",
    headers=headers,
    json=payload
)

print(response.json())
```

```ruby
require "uri"
require "json"
require "net/http"

api_key = "YOUR_API_KEY"

url = URI("https://wiza.co/api/individual_reveals")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer #{api_key}"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  individual_reveal: {
    profile_url: "https://www.linkedin.com/in/example/"
  },
  enrichment_level: "partial"
})

response = https.request(request)
puts response.read_body
```

--------------------------------

### Start Individual Reveal Endpoint

Source: https://docs.wiza.co/using-the-api/bulk-enrichment

Use this endpoint to submit requests for enriching multiple contacts at once. Requests are processed in parallel up to your concurrency limit and queued automatically if the limit is reached.

```APIDOC
## POST /api/individual_reveals

### Description
Enriches multiple contacts simultaneously. Requests are processed in parallel according to the concurrency limit and queued if the limit is exceeded.

### Method
POST

### Endpoint
https://wiza.co/api/individual_reveals
```

--------------------------------

### Get Credits OpenAPI Specification

Source: https://docs.wiza.co/api-reference/credits/get-credits

Defines the GET /api/meta/credits endpoint and the structure of the CreditsResponse object.

```yaml
openapi: 3.0.1
info:
  title: Wiza API Documentation
  version: v1
servers:
  - url: https://wiza.co
    variables:
      defaultHost:
        default: wiza.co
security: []
paths:
  /api/meta/credits:
    get:
      tags:
        - Credits
      summary: Get Credits
      description: Get the number of credits remaining in your account.
      responses:
        '200':
          description: successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditsResponse'
        '401':
          description: Unauthorized
      security:
        - bearer_auth: []
components:
  schemas:
    CreditsResponse:
      type: object
      properties:
        credits:
          type: object
          properties:
            email_credits:
              oneOf:
                - type: string
                - type: integer
              example: 15
              description: Number of email credits remaining, 'unlimited' if unlimited.
            phone_credits:
              oneOf:
                - type: string
                - type: integer
              example: 15
              description: Number of phone credits remaining, 'unlimited' if unlimited.
            export_credits:
              type: integer
              example: 15
              description: Number of export credits remaining.
            api_credits:
              type: number
              example: 15
              description: Number of API credits remaining.
      example:
        credits:
          email_credits: unlimited
          phone_credits: 100
          export_credits: 0
          api_credits: 100
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      description: >-
        Enter your bearer token (your API key) in the **Authorization** header
        in the format `Bearer {token}`
```

--------------------------------

### Create Prospect List in Ruby

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

This Ruby script demonstrates how to create a prospect list using the Wiza API. Remember to replace the placeholder API key with your actual key.

```Ruby
require "uri"
require "json"
require "net/http"

api_key = "your api key here" # update with your api_key

url = URI("https://wiza.co/api/prospects/create_prospect_list")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer #{api_key}"
request.body = JSON.dump({
  "filters": {
    "job_title": [
      {
        "v": "CEO",
        "s": "i"
      }
    ],
    "job_title_level": [
      "CXO"
    ],
    "job_role": [
      "finance"
    ],
    "location": [
      {
        "v": "Toronto, Ontario, Canada",
        "b": "city",
        "s": "i"
      }
    ],
    "company_location": [
      {
        "v": "Ontario, Canada",
        "b": "state",
        "s": "i"
      }
    ],
    "company_size": [
      "1-10",
      "11-50"
    ],
    "company_industry": [
      "financial services"
    ],
    "year_founded_start": "2010",
    "year_founded_end": "2024"
  },
  "list": {
    "name": "Test List",
    "max_profiles": 10
  }
})

response = https.request(request)
puts response.read_body
```

--------------------------------

### Create Prospect List with Filters (Python)

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

This Python code snippet demonstrates how to create a prospect list using the Wiza API. It requires the `http.client` and `json` libraries. Remember to replace 'your api key here' with your actual API key.

```Python
import http.client

import json


api_key = "your api key here" # update with your api_key


conn = http.client.HTTPSConnection("wiza.co")

payload = json.dumps({
  "filters": {
    "job_title": [
      {
        "v": "CEO",
        "s": "i"
      }
    ],
    "job_title_level": [
      "CXO"
    ],
    "job_role": [
      "finance"
    ],
    "location": [
      {

```

--------------------------------

### Create a List with Python

Source: https://docs.wiza.co/api-reference/lists/create-list

This Python script demonstrates how to create a list using the Wiza API. It utilizes the http.client library for making the POST request. Remember to replace 'your api key here' with your actual API key.

```Python
import http.client
import json

api_key = "your api key here" # update with your api_key

conn = http.client.HTTPSConnection("wiza.co")
payload = json.dumps({
  "list": {
    "name": "List name",
    "enrichment_level": "partial",
    "email_options": {
      "accept_work": True,
      "accept_personal": True,
      "accept_generic": True
    },
    "items": [
      {
        "full_name": "Stephen Hakami",
        "company": "Wiza",
        "domain": "wiza.co"
      }, {
        "profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/"
      }, {
        "email": "stephen@wiza.co"
      }
    ]
  }
})
authorization = ("Bearer {api_key}").format(api_key=api_key)
headers = {
  'Content-Type': 'application/json',
  'Authorization': authorization
}
conn.request("POST", "/api/lists", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

--------------------------------

### Create Prospect List using Curl

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

This Curl command shows how to create a prospect list via the Wiza API. Replace 'your api key here' with your actual API key.

```Curl
api_key="your api key here" # update with your api_key


curl --location 'https://wiza.co/api/prospects/create_prospect_list'
--header 'Content-Type: application/json' --header "Authorization:
Bearer ${api_key}" --data '{ 
    "filters": { 
      "job_title": [ 
        { 
          "v": "CEO", 
          "s": "i" 
        } 
      ], 
      "job_title_level": [ 
        "CXO" 
      ], 
      "job_role": [ 
        "finance" 
      ], 
      "location": [ 
        { 
          "v": "Toronto, Ontario, Canada", 
          "b": "city", 
          "s": "i" 
        } 
      ], 
      "company_location": [ 
        { 
          "v": "Ontario, Canada", 
          "b": "state", 
          "s": "i" 
        } 
      ], 
      "company_size": ["1-10","11-50"],
      "company_industry": ["financial services"],
      "year_founded_start": "2010",
      "year_founded_end": "2024"
    }, 
    "list": { 
        "name": "Test List", 
        "max_profiles": 10 
    } 
}'
```

--------------------------------

### Create Prospect List in Python

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

Use this Python snippet to create a prospect list with specific filters. Ensure you replace 'your api key here' with your actual API key and handle the connection and response appropriately.

```Python
import http.client
import json

api_key = "your api key here" # update with your api_key

conn = http.client.HTTPSConnection("wiza.co")

payload = json.dumps({
  "filters": {
    "job_title": [
      {
        "v": "CEO",
        "s": "i"
      }
    ],
    "job_title_level": [
      "CXO"
    ],
    "job_role": [
      "finance"
    ],
    "location": [
      {
        "v": "Toronto, Ontario, Canada",
        "b": "city",
        "s": "i"
      }
    ],
    "company_location": [
      {
        "v": "Ontario, Canada",
        "b": "state",
        "s": "i"
      }
    ],
    "company_size": [
      "1-10",
      "11-50"
    ],
    "company_industry": [
      "financial services"
    ],
    "year_founded_start": "2010",
    "year_founded_end": "2024"
  },
  "list": {
    "name": "Test List",
    "max_profiles": 10
  }
})

authorization = ("Bearer {api_key}").format(api_key=api_key)

headers = {
  'Content-Type': 'application/json',
  'Authorization': authorization
}

conn.request("POST", "/api/prospects/create_prospect_list", payload,
headers)

res = conn.getresponse()

data = res.read()

print(data.decode("utf-8"))
```

--------------------------------

### API Reference - Start Individual Reveal

Source: https://docs.wiza.co/

Enriches a single contact with their details.

```APIDOC
## POST /reveal/individual

### Description
Enriches a single contact with their details.

### Method
POST

### Endpoint
/reveal/individual

### Parameters
#### Request Body
- **email** (string) - Required - The email address of the contact to enrich.
- **linkedin_url** (string) - Required - The LinkedIn profile URL of the contact.

### Request Example
```json
{
  "email": "john.doe@example.com",
  "linkedin_url": "https://www.linkedin.com/in/johndoe/"
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the enrichment job.
- **status** (string) - The current status of the enrichment job (e.g., 'pending', 'processing', 'completed', 'failed').

#### Response Example
```json
{
  "id": "enrichment_job_12345",
  "status": "pending"
}
```
```

--------------------------------

### Create Prospect List with Filters (Javascript)

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

Use this Javascript code to create a prospect list by sending a POST request to the Wiza API. Ensure you replace 'your api key here' with your actual API key. The filters allow for precise targeting of prospects.

```Javascript
const apiKey = "your api key here" // update with your api_key


const myHeaders = new Headers();

myHeaders.append("Content-Type", "application/json");

myHeaders.append("Authorization", `Bearer ${apiKey}`);


const raw = JSON.stringify({
  "filters": {
    "job_title": [
      {
        "v": "CEO",
        "s": "i"
      }
    ],
    "job_title_level": [
      "CXO"
    ],
    "job_role": [
      "finance"
    ],
    "location": [
      {
        "v": "Toronto, Ontario, Canada",
        "b": "city",
        "s": "i"
      }
    ],
    "company_location": [
      {
        "v": "Ontario, Canada",
        "b": "state",
        "s": "i"
      }
    ],
    "company_size": [
      "1-10",
      "11-50"
    ],
    "company_industry": [
      "financial services"
    ],
    "year_founded_start": "2010",
    "year_founded_end": "2024"
  },
  "list": {
    "name": "Test List",
    "max_profiles": 10
  }
});


const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};


fetch("https://wiza.co/api/prospects/create_prospect_list",
requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

--------------------------------

### GET /api/lists/:id

Source: https://docs.wiza.co/api-reference/lists/create-list

Retrieve the current status of a specific enrichment list.

```APIDOC
## GET /api/lists/:id

### Description
Get the status of a specific list by its ID.

### Method
GET

### Endpoint
/api/lists/:id

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the list.
```

--------------------------------

### GET /api/lists/:id/contacts

Source: https://docs.wiza.co/api-reference/lists/create-list

Retrieve the contacts associated with a specific enrichment list.

```APIDOC
## GET /api/lists/:id/contacts

### Description
Retrieve the contacts processed within a specific list.

### Method
GET

### Endpoint
/api/lists/:id/contacts

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the list.
```

--------------------------------

### Legacy Endpoints - Create Prospect List

Source: https://docs.wiza.co/

Creates a list of prospects based on a previous prospect search.

```APIDOC
## POST /prospect/lists

### Description
Creates a list of prospects based on a previous prospect search.

### Method
POST

### Endpoint
/prospect/lists

### Parameters
#### Request Body
- **name** (string) - Required - The name of the prospect list.
- **search_id** (string) - Required - The ID of the prospect search to base the list on.

### Request Example
```json
{
  "name": "Top Engineers SF",
  "search_id": "search_xyz789"
}
```

### Response
#### Success Response (200)
- **list_id** (string) - The unique identifier for the created prospect list.
- **status** (string) - The status of the list creation.

#### Response Example
```json
{
  "list_id": "prospectlist_11223",
  "status": "created"
}
```
```

--------------------------------

### GET /api/individual_reveals/{id}

Source: https://docs.wiza.co/api-reference/individual-reveals/get-individual-reveal

Retrieves the details of an individual reveal by its unique identifier.

```APIDOC
## GET /api/individual_reveals/{id}

### Description
Get the individual reveal by id.

### Method
GET

### Endpoint
/api/individual_reveals/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - id

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **status** (object) - 
  - **code** (integer) - 
  - **message** (string) - 
- **type** (string) - 
- **data** (object) - 
  - **id** (integer) - 
  - **status** (string) - Current status of the individual reveal.
    - `queued`: Accepted and waiting to start.
    - `resolving`: Enrichment in progress.
    - `finished`: Enrichment completed successfully.
    - `failed`: Enrichment completed with errors.
  - **is_complete** (boolean) - 
  - **name** (string) - 
  - **company** (string) - 
  - **enrichment_level** (string) - 
  - **linkedin_profile_url** (string) - 
  - **title** (string) - 
  - **location** (string) - 
  - **email** (string) - 
  - **email_type** (string) - 
  - **email_status** (string) - 
    - `valid`
    - `risky`
    - `unfound`
    - `null`
  - **emails** (array) - 
    - **email** (string) - 
    - **email_type** (string) - 
    - **email_status** (string) - 
      - `valid`
      - `risky`
      - `unfound`

#### Response Example
```json
{
  "status": {
    "code": 200,
    "message": "🧙 Wiza is working on it!"
  },
  "type": "individual_reveal",
  "data": {
    "id": 32,
    "status": "queued",
    "is_complete": false,
    "name": "Stephen Hakami",
    "company": "Wiza",
    "enrichment_level": "partial",
    "linkedin_profile_url": "https://www.linkedin.com/in/stephen-hakami-5babb21b0/",
    "title": "Founder, Chief Executive Officer",
    "location": "Toronto, Ontario, Canada",
    "email": "stephen@wiza.co",
    "email_type": "work",
    "email_status": "valid",
    "emails": [
      {
        "email": "stephen@wiza.co",
        "email_type": "work",
        "email_status": "valid"
      }
    ]
  }
}
```

#### Error Response (401)
Description: Unauthorized

#### Error Response (404)
- **status** (object) - 
  - **code** (integer) - 
  - **message** (string) - 

#### Response Example
```json
{
  "status": {
    "code": 404,
    "message": "Not found"
  }
}
```
```

--------------------------------

### GET /company

Source: https://docs.wiza.co/api-reference/company-enrichment/company-enrichment

Retrieves detailed information about a company and current API credit usage.

```APIDOC
## GET /company

### Description
Retrieves company profile details such as location, social media profiles, and domain information, along with current API credit usage.

### Method
GET

### Endpoint
/company

### Response
#### Success Response (200)
- **company_last_funding_amount** (string) - Last funding amount
- **company_last_funding_at** (string) - Date of last funding
- **company_location** (string) - Full location string
- **company_twitter** (string) - Twitter profile URL
- **company_facebook** (string) - Facebook profile URL
- **company_linkedin** (string) - LinkedIn profile URL
- **company_street** (string) - Street address
- **company_locality** (string) - City or locality
- **company_region** (string) - State or region
- **company_postal_code** (string) - Postal code
- **company_country** (string) - Country
- **domain** (string) - Company domain
- **company_domain** (string) - Company domain
- **company_name** (string) - Company name
- **company_linkedin_id** (string) - LinkedIn ID
- **credits** (object) - Credit usage information

#### Response Example
{
  "company_name": "Wiza",
  "company_domain": "wiza.co",
  "credits": {
    "api_credits": {
      "total": 2,
      "company_credits": 2
    }
  }
}
```

--------------------------------

### POST /api/prospects/create_prospect_list

Source: https://docs.wiza.co/api-reference/prospect-lists/create-prospect-list

Create a list of prospects that match your specified filters. You can define the list name, maximum number of profiles, enrichment level, email options, and duplicate skipping behavior.

```APIDOC
## POST /api/prospects/create_prospect_list

### Description
Create a list of prospects that match your filters.

### Method
POST

### Endpoint
https://wiza.co/api/prospects/create_prospect_list

### Parameters
#### Request Body
- **list** (object) - Required - Contains details about the prospect list.
  - **name** (string) - Required - Name of the list. e.g. "VP of Sales in San Francisco"
  - **max_profiles** (integer) - Required - The number of results to return
  - **enrichment_level** (string) - Optional - Enrichment level of the list. Enum: "none", "partial", "full". Default is "partial".
    - "none": Will enrich with contact data when you provide a Linkedin profile url or email. But will not find emails or phone numbers.
    - "partial": Will find emails.
    - "full": Will find emails and phone numbers.
  - **email_options** (object) - Optional - Types of emails to return.
    - **accept_work** (boolean) - Optional - Professional email address, i.e. tim.cooke@apple.com
    - **accept_personal** (boolean) - Optional - A personal email address, i.e. tcooke1960@gmail.com
    - **accept_generic** (boolean) - Optional - A generic email address, i.e. hello@apple.com
  - **skip_duplicates** (boolean) - Optional - Skip contacts previously found in other api lists. Contacts will be marked as duplicates and not processed.
  - **callback_url** (string) - Optional - URL to send the list update to. If not provided, the default webhook URL configured in your account settings will be used.
- **filters** (object) - Required - Contains the filtering criteria for prospects.
  - **first_name** (array) - Optional - Exact match of first name. Example: ["John", "Jane"]
  - **last_name** (array) - Optional - Exact match of last name. Example: ["Smith"]
  - **job_title** (array) - Optional - Filter by job title.
    - **v** (string) - Required - Job title to search. Example: "CEO"
    - **s** (string) - Required - Whether to include or exclude the job title. Enum: "i" (include), "e" (exclude).

### Request Example
```json
{
  "list": {
    "name": "VP of Sales in San Francisco",
    "max_profiles": 10,
    "enrichment_level": "partial",
    "email_options": {
      "accept_work": true,
      "accept_personal": true,
      "accept_generic": true
    },
    "skip_duplicates": true,
    "callback_url": "https://example.com/callback"
  },
  "filters": {
    "first_name": ["John", "Jane"],
    "last_name": ["Smith"],
    "job_title": [
      {
        "v": "CEO",
        "s": "i"
      }
    ]
  }
}
```

### Response
#### Success Response (200)
- **status** (string) - Indicates the status of the operation.
- **message** (string) - A message describing the result of the operation.
- **list_id** (string) - The ID of the created prospect list.

#### Response Example
```json
{
  "status": "success",
  "message": "Prospect list created successfully.",
  "list_id": "lst_12345abcde"
}
```
```
Tokens:
Raw