curl --request POST \
  --url https://wiza.co/api/individual_reveals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "individual_reveal": {
    "full_name": "Stephen Hakami",
    "company": "Wiza",
    "domain": "wiza.co"
  },
  "enrichment_level": "partial",
  "email_options": {
    "accept_work": true,
    "accept_personal": false
  }
}
'

{
  "status": {
    "code": 200,
    "message": "🧙 Wiza is working on it!"
  },
  "type": "individual_reveal",
  "data": {
    "id": 32,
    "status": "queued",
    "is_complete": false
  }
}

{
  "status": {
    "code": 400,
    "message": "Please add a valid payment method to start this scan."
  }
}

{
  "status": {
    "code": 429,
    "message": "Queue is full. Try again later."
  }
}

Individual Reveals

Start Individual Reveal

Start an individual reveal. An individual reveal is a single contact enrichment. You can provide a name, company, and domain, or an email, or a LinkedIn profile URL.

Either company (company name) or domain is required when using contact details.

Once the reveal 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 the Get Individual Reveal 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 individual reveal by calling the GET /api/individual_reveals/:id endpoint.

POST

/

api

/

individual_reveals

curl --request POST \
  --url https://wiza.co/api/individual_reveals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "individual_reveal": {
    "full_name": "Stephen Hakami",
    "company": "Wiza",
    "domain": "wiza.co"
  },
  "enrichment_level": "partial",
  "email_options": {
    "accept_work": true,
    "accept_personal": false
  }
}
'

{
  "status": {
    "code": 200,
    "message": "🧙 Wiza is working on it!"
  },
  "type": "individual_reveal",
  "data": {
    "id": 32,
    "status": "queued",
    "is_complete": false
  }
}

{
  "status": {
    "code": 400,
    "message": "Please add a valid payment method to start this scan."
  }
}

{
  "status": {
    "code": 429,
    "message": "Queue is full. Try again later."
  }
}

Authorizations

Authorization

string

header

required

Enter your bearer token (your API key) in the Authorization header in the format Bearer {token}

Body

application/json

individual_reveal

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

enrichment_level

enum<string>

required

Enrichment level of the list.

Enrichment Level	Description
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 email.
phone	Will find phone numbers.
full	Will find email and phone numbers.

Available options:

none,

partial,

phone,

full

email_options

object

Types of emails to return. If not provided, all emails will be returned.

Show child attributes

callback_url

string

URL to send the individual reveal update to. If not provided, the default webhook URL configured in your account settings will be used.

reveal_options

object

Optional advanced reveal options.

Show child attributes

Response

successful

status

object

Show child attributes

type

enum<string>

Available options:

individual_reveal

Example:

"individual_reveal"

data

object

Show child attributes