FullEnrich

https://docs.fullenrich.com/api/v2
Admin
FullEnrich is a B2B data enrichment API that aggregates data from 20+ providers to find and verify...
Tokens:102,319
Snippets:355
Trust Score:9
Update:12 hours ago
Show doc for...
Tokens:
Raw
### Example response for GET /account/credits

Source: https://docs.fullenrich.com/api/v2/account/credits/get

Shows a successful 200 response with the current credit balance.

```json
{
  "balance": 5000
}
```

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

### Go example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses the net/http package to send a GET request to the bulk reverse email endpoint. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

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

### Ruby Net::HTTP example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses Net::HTTP to send a GET request to the bulk reverse email endpoint. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

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

### Search Company API v2 - Java Unirest Example

Source: https://docs.fullenrich.com/api/v2/company/search/post

Sends a POST request to the FullEnrich company search endpoint using the Unirest HTTP client in Java. The request body is identical to the Go example, with filters for names, domains, professional network IDs/URLs, keywords, specialties, technologies, industries, types, headquarters locations, founded years, headcounts, and company IDs. Requires a valid bearer token in the Authorization header.

```Java
HttpResponse<String> response = Unirest.post("https://app.fullenrich.com/api/v2/company/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"offset\": 20,\n  \"limit\": 20,\n  \"search_after\": \"WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=\",\n  \"names\": [\n    {\n      \"value\": \"Microsoft\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"domains\": [\n    {\n      \"value\": \"microsoft.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"professional_network_ids\": [\n    {\n      \"value\": 1234,\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"professional_network_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"keywords\": [\n    {\n      \"value\": \"innovative and practical products\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"specialties\": [\n    {\n      \"value\": \"AI safety\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"technologies\": [\n    {\n      \"value\": \"Fullenrich\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"headquarters_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"founded_years\": [\n    {\n      \"min\": 2015,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"headcounts\": [\n    {\n      \"min\": 100,\n      \"max\": 500,\n      \"exclude\": false\n    }\n  ],\n  \"company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ]\n}")
  .asString();
```

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

### Custom parameter example for webhook payload

Source: https://docs.fullenrich.com/api/v2/implement-in-product/getting-started

Use the `custom` parameter when creating an enrichment to include a User ID, Enrichment ID, or any other value to match results to internal data. This value is sent back exactly as provided inside the `custom` object in the webhook payload.

```json
"custom": {
    "user_id": "12584"
}
```

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

### Go example for company lookup

Source: https://docs.fullenrich.com/api/v2/company/lookup/post

Uses net/http to POST the payload. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/company/lookup"

	payload := strings.NewReader("{\n  \"domain\": \"anthropic.com\",\n  \"professional_network_url\": \"https://www.linkedin.com/company/anthropic\",\n  \"professional_network_id\": 1883877\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

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

### JavaScript fetch POST to /api/v2/people/search

Source: https://docs.fullenrich.com/api/v2/people/search/post

Use this JavaScript example to call the FullEnrich People Search endpoint with a comprehensive set of filters. The request includes pagination parameters (offset, limit, search_after) and various filters such as current_company_names, person_skills, and current_position_titles. The response is logged to the console, and errors are caught and logged.

```javascript
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    offset: 0,
    limit: 20,
    search_after: 'WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=',
    current_company_names: [
      {value: 'Anthropic', exact_match: true, exclude: false},
      {value: 'OpenAI', exact_match: true, exclude: false}
    ],
    current_company_domains: [{value: 'google.com', exact_match: true, exclude: false}],
    current_company_professional_network_ids: [{value: 1234, exact_match: true, exclude: false}],
    current_company_professional_network_urls: [
      {
        value: 'https://www.linkedin.com/company/fullenrich',
        exact_match: true,
        exclude: false
      }
    ],
    current_company_specialties: [{value: 'artificial intelligence', exact_match: true, exclude: false}],
    current_company_industries: [
      {value: 'Software Development', exact_match: false, exclude: false},
      {value: 'Computer Hardware Manufacturing', exact_match: false, exclude: false}
    ],
    current_company_technologies: [{value: 'Notion', exact_match: false, exclude: false}],
    past_company_names: [{value: 'Meta', exact_match: true, exclude: false}],
    past_company_domains: [{value: 'facebook.com', exact_match: true, exclude: false}],
    current_company_types: [{value: 'Public Company', exact_match: true, exclude: false}],
    current_company_headquarters: [
      {value: 'San Francisco', exact_match: false, exclude: false},
      {value: 'New York', exact_match: false, exclude: false}
    ],
    current_company_headcounts: [{min: 50, max: 200, exclude: false}, {min: 1000, max: 5000, exclude: false}],
    current_company_founded_years: [{min: 2020, max: 2024, exclude: false}],
    current_company_ids: [
      {
        value: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
        exclude: false,
        exact_match: true
      }
    ],
    person_ids: [
      {
        value: '746e4816-19c8-54d8-b558-65a5a52cc85c',
        exclude: false,
        exact_match: true
      }
    ],
    person_names: [{value: 'John Smith', exact_match: false, exclude: false}],
    person_professional_network_ids: [{value: 1234, exact_match: true, exclude: false}],
    person_professional_network_urls: [
      {
        value: 'https://www.linkedin.com/in/john-doe',
        exact_match: true,
        exclude: false
      }
    ],
    person_locations: [
      {value: 'San Francisco', exact_match: false, exclude: false},
      {value: 'California', exact_match: false, exclude: false}
    ],
    person_languages: [
      {value: 'English', exact_match: false, exclude: false},
      {value: 'French', exact_match: false, exclude: false}
    ],
    person_skills: [
      {value: 'JavaScript', exact_match: false, exclude: false},
      {value: 'Python', exact_match: false, exclude: false},
      {value: 'Project Management', exact_match: false, exclude: false}
    ],
    current_position_seniority_level: [
      {value: 'Director', exact_match: false, exclude: false},
      {value: 'VP', exact_match: false, exclude: false}
    ],
    current_position_job_functions: [{value: 'Software Development', exact_match: false, exclude: false}],
    current_position_sub_functions: [{value: 'Freelancer', exact_match: false, exclude: false}],
    current_position_titles: [
      {value: 'Chief Technology Officer', exact_match: false, exclude: false},
      {value: 'VP of Engineering', exact_match: false, exclude: false}
    ],
    past_position_titles: [{value: 'Software Engineer', exact_match: false, exclude: false}],
    current_position_years_in: [{min: 0, max: 1, exclude: false}],
    current_company_years_at: [{min: 2, max: 5, exclude: false}],
    person_universities: [
      {value: 'Stanford University', exact_match: false, exclude: false},
      {value: 'MIT', exact_match: false, exclude: false}
    ],
    current_company_days_since_last_job_change: [{min: 0, max: 90, exclude: false}]
  })
};

fetch('https://app.fullenrich.com/api/v2/people/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

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

### Example 200 response for GET /contact/enrich/bulk/{enrichment_id}

Source: https://docs.fullenrich.com/api/v2/contact/enrich/bulk/get

Example JSON response with status 200 for a finished bulk enrichment. Contains cost in credits, input data, custom user_id, contact info with emails and phones, and profile details.

```json
{
  "id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a",
  "name": "Sales Operations in London",
  "status": "FINISHED",
  "cost": {
    "credits": 14
  },
  "data": [
    {
      "input": {
        "first_name": "John",
        "last_name": "Snow",
        "company_domain": "example.com",
        "company_name": "Example Inc",
        "professional_network_url": "https://www.linkedin.com/in/demoge/"
      },
      "custom": {
        "user_id": "12584"
      },
      "contact_info": {
        "most_probable_work_email": {
          "email": "john.snow@example.com",
          "status": "DELIVERABLE"
        },
        "most_probable_personal_email": {
          "email": "johnsnow@gmail.com",
          "status": "DELIVERABLE"
        },
        "most_probable_phone": {
          "number": "+1 555-123-4567",
          "region": "US",
          "line_type": "MOBILE",
          "line_status": "ACTIVE",
          "ownership_match": "CONFIRMED",
          "ownership_match_confidence": 90,
          "connect_rate": "HIGHEST"
        },
        "work_emails": [
          {
            "email": "john.snow@example.com",
            "status": "DELIVERABLE"
          }
        ],
        "personal_emails": [
          {
            "email": "johnsnow@gmail.com",
            "status": "DELIVERABLE"
          }
        ],
        "phones": [
          {
            "number": "+1 555-123-4567",
            "region": "US",
            "line_type": "MOBILE",
            "line_status": "ACTIVE",
            "ownership_match": "CONFIRMED",
            "ownership_match_confidence": 90,
            "connect_rate": "HIGHEST"
          },
          {
            "number": "+33 1 42 86 82 82",
            "region": "FR",
            "line_type": "LANDLINE",
            "line_status": "ACTIVE"
          }
        ]
      },
      "profile": {
        "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
        "full_name": "John Snow",
        "first_name": "John",
        "last_name": "Snow",
        "professional_network": {
          "url": "https://www.linkedin.com/company/example-inc",
          "handle": "example-inc",
          "connection_count": 12000
        }
      },
      "logo_url": "https://app.fullenrich.com/logo/company/handle/example-inc"
    }
  ]
}
```

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

### Go example for POST /company/lookup

Source: https://docs.fullenrich.com/api/v2/company/lookup/post

Uses net/http to POST JSON payload to the company lookup endpoint. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/company/lookup"

	payload := strings.NewReader("{\n  \"domain\": \"anthropic.com\",\n  \"professional_network_url\": \"https://www.linkedin.com/company/anthropic\",\n  \"professional_network_id\": 1883877\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

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

### GET /contact/reverse/email/bulk/{enrichment_id}

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Retrieves the result of a reverse email lookup using the enrichment ID returned when the lookup was started. This endpoint is not needed if you are using a webhook, which is the recommended method to get results as soon as enrichment is done.

```APIDOC
## GET /contact/reverse/email/bulk/{enrichment_id}

### Description
Retrieves the result of a reverse email lookup using the enrichment ID returned when the lookup was started. This endpoint is not needed if you are using a webhook, which is the recommended method to get results as soon as enrichment is done.

### Method
GET

### Endpoint
/contact/reverse/email/bulk/{enrichment_id}

### Parameters
#### Path Parameters
- **enrichment_id** (string) - Required - The unique identifier returned when the reverse lookup was started

#### Authorizations
- **Authorization** (string, header) - Required - Bearer authentication header of the form `Bearer <token>`, where `<token>` is your auth token.

### Response
#### Success Response (200)
The response contains the enrichment result with person and company details. Example fields include:
- **person** (object) - Person details including name, email, and employment history
- **company** (object) - Company details including name, domain, and locations
- **all** (array) - List of employment entries with title, dates, and company information

#### Response Example
```json
{
  "person": {
    "employment_history": {
      "current": {
        "title": "Head of Sales Operations",
        "is_current": true,
        "start_at": "2022-03-15T00:00:00Z",
        "company": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "name": "Example Inc",
          "domain": "example.com",
          "website": "https://www.example.com",
          "description": "Leading example company",
          "year_founded": 2010,
          "headcount": 250,
          "company_type": "Privately Held",
          "locations": {
            "headquarters": {
              "line1": "123 Market St",
              "line2": "San Francisco, CA 94105, US",
              "city": "San Francisco",
              "region": "California",
              "country": "United States",
              "country_code": "US"
            },
            "offices": [
              {
                "line1": "456 Broadway",
                "line2": "New York, NY 10013, US"
              }
            ]
          },
          "industry": {
            "main_industry": "Software Development"
          },
          "social_profiles": {
            "professional_network": {
              "url": "https://www.linkedin.com/company/example-inc",
              "handle": "example-inc",
              "connection_count": 12000
            }
          },
          "logo_url": "https://app.fullenrich.com/logo/company/handle/example-inc"
        }
      },
      "all": [
        {
          "title": "Head of Sales Operations",
          "is_current": true,
          "start_at": "2022-03-15T00:00:00Z",
          "company": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Example Inc",
            "domain": "example.com",
            "website": "https://www.example.com",
            "description": "Leading example company",
            "year_founded": 2010,
            "headcount": 250,
            "company_type": "Privately Held",
            "locations": {
              "headquarters": {
                "line1": "123 Market St",
                "line2": "San Francisco, CA 94105, US",
                "city": "San Francisco",
                "region": "California",
                "country": "United States",
                "country_code": "US"
              },
              "offices": [
                {
                  "line1": "456 Broadway",
                  "line2": "New York, NY 10013, US"
                }
              ]
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "professional_network": {
                "url": "https://www.linkedin.com/company/example-inc",
                "handle": "example-inc",
                "connection_count": 12000
              }
            },
            "logo_url": "https://app.fullenrich.com/logo/company/handle/example-inc"
          }
        },
        {
          "title": "Sales Manager",
          "is_current": false,
          "start_at": "2019-07-01T00:00:00Z",
          "end_at": "2022-03-01T00:00:00Z",
          "company": {
            "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "name": "Previous Corp",
            "domain": "previouscorp.com",
            "website": "https://www.previouscorp.com",
            "description": "Enterprise software solutions",
            "year_founded": 2005,
            "headcount": 500,
            "company_type": "Privately Held",
            "locations": {
              "headquarters": {
                "line1": "789 5th Ave",
                "line2": "New York, NY 10022, US",
                "city": "New York",
                "region": "New York",
                "country": "United States",
                "country_code": "US"
              },
              "offices": []
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "professional_network": {
                "url": "https://www.linkedin.com/company/previous-corp",
                "handle": "previous-corp",
                "connection_count": 8000
              }
            },
            "logo_url": "https://app.fullenrich.com/logo/company/handle/previous-corp"
          }
        }
      ]
    }
  }
}
```

```

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

### Java Unirest example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses the Unirest library to send a GET request to the bulk reverse email endpoint. Returns the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

### Python requests example to search companies

Source: https://docs.fullenrich.com/api/v2/company/search/post

Uses the requests library to POST the same search payload to the FullEnrich API. The payload includes filters for names, domains, industries, headcounts, and more. Requires an Authorization Bearer token and prints the response text.

```python
import requests

url = "https://app.fullenrich.com/api/v2/company/search"

payload = {
    "offset": 20,
    "limit": 20,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=",
    "names": [
        {
            "value": "Microsoft",
            "exact_match": True,
            "exclude": False
        }
    ],
    "domains": [
        {
            "value": "microsoft.com",
            "exact_match": True,
            "exclude": False
        }
    ],
    "professional_network_ids": [
        {
            "value": 1234,
            "exact_match": True,
            "exclude": False
        }
    ],
    "professional_network_urls": [
        {
            "value": "https://www.linkedin.com/company/fullenrich",
            "exact_match": True,
            "exclude": False
        }
    ],
    "keywords": [
        {
            "value": "innovative and practical products",
            "exact_match": False,
            "exclude": False
        }
    ],
    "specialties": [
        {
            "value": "AI safety",
            "exact_match": False,
            "exclude": False
        }
    ],
    "technologies": [
        {
            "value": "Fullenrich",
            "exact_match": False,
            "exclude": False
        }
    ],
    "industries": [
        {
            "value": "Software Development",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "Computer Hardware Manufacturing",
            "exact_match": False,
            "exclude": False
        }
    ],
    "types": [
        {
            "value": "Public Company",
            "exact_match": True,
            "exclude": False
        }
    ],
    "headquarters_locations": [
        {
            "value": "San Francisco",
            "exact_match": False,
            "exclude": False
        }
    ],
    "founded_years": [
        {
            "min": 2015,
            "max": 2024,
            "exclude": False
        }
    ],
    "headcounts": [
        {
            "min": 100,
            "max": 500,
            "exclude": False
        }
    ],
    "company_ids": [
        {
            "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "exclude": False,
            "exact_match": True
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

```

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

### Search People with Go

Source: https://docs.fullenrich.com/api/v2/people/search/post

Go example for the Search People endpoint. It constructs a POST request with a JSON payload and prints the response body or any error.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/people/search"

	payload := strings.NewReader("{\n  \"offset\": 0,\n  \"limit\": 20,\n  \"search_after\": \"WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=\",\n  \"current_company_names\": [\n    {\n      \"value\": \"Anthropic\",\n      \"exact_match\": true,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"OpenAI\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_domains\": [\n    {\n      \"value\": \"google.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_professional_network_ids\": [\n    {\n      \"value\": 1234,\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_professional_network_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_specialties\": [\n    {\n      \"value\": \"artificial intelligence\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_technologies\": [\n    {\n      \"value\": \"Notion\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_names\": [\n    {\n      \"value\": \"Meta\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"past_company_domains\": [\n    {\n      \"value\": \"facebook.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headquarters\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"New York\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_headcounts\": [\n    {\n      \"min\": 50,\n      \"max\": 200,\n      \"exclude\": false\n    },\n    {\n      \"min\": 1000,\n      \"max\": 5000,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_founded_years\": [\n    {\n      \"min\": 2020,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"current_company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_ids\": [\n    {\n      \"value\": \"746e4816-19c8-54d8-b558-65a5a52cc85c\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ],\n  \"person_names\": [\n    {\n      \"value\": 
```

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

### Python requests example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses the requests library to perform a GET request to the bulk reverse email endpoint. Prints the response text.

```python
import requests

url = "https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

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

### PHP cURL example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses PHP cURL to send a GET request to the bulk reverse email endpoint. Outputs the response or a cURL error.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

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

### Go: Verify webhook signature with HMAC-SHA1

Source: https://docs.fullenrich.com/api/v2/general/webhooks

Use this Go example to verify the X-Signature-SHA1 header on incoming webhooks. It computes an HMAC-SHA1 hash of the raw request body using your FullEnrich API key and compares it with the header using hmac.Equal. Includes an http.HandlerFunc that reads the raw body and returns 401 on invalid signature.

```Go
package main

import (
	"crypto/hmac"
	"crypto/sha1"
	"encoding/hex"
	"io"
	"net/http"
)

func isValidWebhook(rawBody []byte, signatureHeader, apiKey string) bool {
	mac := hmac.New(sha1.New, []byte(apiKey))
	mac.Write(rawBody)
	expected := hex.EncodeToString(mac.Sum(nil))

	return hmac.Equal([]byte(expected), []byte(signatureHeader))
}

func webhookHandler(apiKey string) http.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) {
		rawBody, err := io.ReadAll(r.Body)
		if err != nil {
			http.Error(w, "Cannot read body", http.StatusBadRequest)
			return
		}

		signature := r.Header.Get("X-Signature-SHA1")
		if !isValidWebhook(rawBody, signature, apiKey) {
			http.Error(w, "Invalid signature", http.StatusUnauthorized)
			return
		}

		// ... handle the verified payload (parse rawBody as JSON)
		w.WriteHeader(http.StatusOK)
	}
}
```

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

### JavaScript fetch example for bulk reverse email

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Uses the Fetch API to make a GET request to the bulk reverse email endpoint. Logs the JSON response or error.

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.fullenrich.com/api/v2/contact/reverse/email/bulk/{enrichment_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

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

### Go net/http GET /account/keys/verify

Source: https://docs.fullenrich.com/api/v2/account/keys/verify/get

Uses Go's net/http to verify the API key. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/account/keys/verify"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

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

### 200 OK Response Example

Source: https://docs.fullenrich.com/api/v2/account/keys/verify/get

Example JSON response returned when the API key is valid. Contains the workspace_id associated with the key.

```json
{
  "workspace_id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a"
}
```

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

### GET /contact/enrich/bulk/{enrichment_id}

Source: https://docs.fullenrich.com/api/v2/contact/enrich/bulk/get

Retrieves the results of a bulk contact enrichment job. Use the enrichment_id returned when the enrichment was started. Optionally, you can force the API to return partial results before the enrichment is complete.

```APIDOC
## [GET] /contact/enrich/bulk/{enrichment_id}

### Description
Retrieves the results of a bulk contact enrichment job. Use the enrichment_id returned when the enrichment was started. Optionally, you can force the API to return partial results before the enrichment is complete.

### Method
GET

### Endpoint
/contact/enrich/bulk/{enrichment_id}

### Parameters
#### Path Parameters
- **enrichment_id** (string) - Required - The unique identifier returned when the enrichment was started

#### Query Parameters
- **forceResults** (boolean) - Optional - Default = False. This parameter forces the API to return what has been found so far, even if the enrichment is not finished. This may result in missing information and is not recommended for regular use.

### Authorizations
- **Authorization** (string, header) - Required - Bearer authentication header of the form `Bearer <token>`, where `<token>` is your auth token.

### Response
#### Success Response (200)
- **id** (string<uuid>) - Example: `"2db5ea61-1752-42cf-8ea1-ab1da060cd0a"`
- **name** (string) - Example: `"Sales Operations in London"`
- **status** (enum<string>) - Available options: `CREATED`, `IN_PROGRESS`, `CANCELED`, `CREDITS_INSUFFICIENT`, `FINISHED`, `RATE_LIMIT`, `UNKNOWN`. Example: `"FINISHED"`
- **data** (object[]) - Show child attributes
- **cost** (object) - Show child attributes

#### Response Example
```json
{
  "id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a",
  "name": "Sales Operations in London",
  "status": "FINISHED",
  "data": [],
  "cost": {}
}
```
```

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

### Example response for bulk reverse email result

Source: https://docs.fullenrich.com/api/v2/contact/reverse/email/bulk/get

Example 200 response showing the structure of a successful reverse email lookup result, including profile data, education, languages, skills, and employment details.

```json
{
  "id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a",
  "name": "Reverse Email Lookup",
  "status": "FINISHED",
  "cost": {
    "credits": 1
  },
  "data": [
    {
      "input": {
        "email": "johnsnow@gmail.com"
      },
      "custom": {
        "user_id": "12584"
      },
      "profile": {
        "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
        "full_name": "John Snow",
        "first_name": "John",
        "last_name": "Snow",
        "headline": "Head of Sales Operations at Example Inc | Revenue Operations, CRM & Sales Enablement",
        "description": "Sales operations leader focused on revenue processes, CRM architecture and sales enablement. I help go-to-market teams scale pipeline with clean data and reliable reporting.",
        "location": {
          "country": "United States",
          "country_code": "US",
          "city": "San Francisco",
          "region": "California"
        },
        "social_profiles": {
          "professional_network": {
            "url": "https://www.linkedin.com/in/demoge/",
            "handle": "demoge",
            "connection_count": 500
          }
        },
        "educations": [
          {
            "school_name": "Stanford University",
            "degree": "Bachelor of Science in Computer Science",
            "start_at": "2015-09-01T00:00:00Z",
            "end_at": "2019-06-01T00:00:00Z"
          }
        ],
        "languages": [
          {
            "language": "English",
            "proficiency": "PROFESSIONAL_WORKING"
          },
          {
            "language": "French",
            "proficiency": "NATIVE_OR_BILINGUAL"
          }
        ],
        "skills": [
          "Sales Operations",
          "Business Development",
          "CRM Management"
        ],
        "employment": {
          "current": {
            "title": "Head of Sales Operations",
            "is_current": true,
            "start_at": "2022-03-15T00:00:00Z",
            "company": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "name": "Example Inc",
              "domain": "example.com",
              "website": "https://www.example.com",
              "description": "Leading example company",
              "year_founded": 2010,
              "headcount": 250,
              "company_type": "Privately Held",
              "locations": {
                "headquarters": {
                  "line1": "123 Market St",
                  "line2": "San Francisco, CA 94105, US",
                  "city": "San Francisco",
                  "region": "California",
```

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

### Example response from company search

Source: https://docs.fullenrich.com/api/v2/company/search/post

Shows the JSON structure returned by the search endpoint, including company details, metadata with total count, credits used, and search_after for pagination.

```json
{
  "companies": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Anthropic",
      "domain": "anthropic.com",
      "website": "https://www.anthropic.com",
      "description": "AI safety and research company building reliable, interpretable, and steerable AI systems.",
      "year_founded": 2021,
      "headcount": 2610,
      "headcount_range": "1001-5000",
      "company_type": "Privately Held",
      "locations": {
        "headquarters": {
          "line1": "548 Market St",
          "line2": "San Francisco, CA 94105, US",
          "city": "San Francisco",
          "region": "California",
          "country": "United States",
          "country_code": "US"
        },
        "offices": [
          {
            "line1": "111 8th Ave",
            "line2": "New York, NY 10011, US"
          }
        ]
      },
      "social_profiles": {
        "professional_network": {
          "id": 1234,
          "url": "https://www.linkedin.com/company/anthropic",
          "handle": "anthropic",
          "connection_count": 125000
        }
      },
      "specialties": [
        "artificial intelligence",
        "machine learning",
        "AI safety"
      ],
      "technologies": [
        {
          "name": "Fullenrich",
          "logo_url": "https://app.fullenrich.com/logo/technologies/id/3uwxkma9y03lj"
        }
      ],
      "industry": {
        "main_industry": "Software Development"
      },
      "logo_url": "https://app.fullenrich.com/logo/company/handle/anthropic"
    }
  ],
  "metadata": {
    "total": 20523,
    "credits": 22.5,
    "offset": 0,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="
  }
}
```

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

### Ruby Net::HTTP example for company lookup

Source: https://docs.fullenrich.com/api/v2/company/lookup/post

Uses Net::HTTP to POST the payload. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://app.fullenrich.com/api/v2/company/lookup")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"anthropic.com\",\n  \"professional_network_url\": \"https://www.linkedin.com/company/anthropic\",\n  \"professional_network_id\": 1883877\n}"

response = http.request(request)
puts response.read_body

```
Tokens:
Raw