Batch Submit Hiring Manager Contacts

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/contacts/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_ids": [
    "<string>"
  ],
  "functions": [
    "<string>"
  ],
  "relationships": [
    "<string>"
  ],
  "exclude": {},
  "reveal_email": true,
  "reveal_phone": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/contacts/batch"

payload = {
    "job_ids": ["<string>"],
    "functions": ["<string>"],
    "relationships": ["<string>"],
    "exclude": {},
    "reveal_email": True,
    "reveal_phone": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_ids: ['<string>'],
    functions: ['<string>'],
    relationships: ['<string>'],
    exclude: {},
    reveal_email: true,
    reveal_phone: true
  })
};

fetch('https://api.hirebase.org/v2/jobs/contacts/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/contacts/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_ids' => [
        '<string>'
    ],
    'functions' => [
        '<string>'
    ],
    'relationships' => [
        '<string>'
    ],
    'exclude' => [
        
    ],
    'reveal_email' => true,
    'reveal_phone' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hirebase.org/v2/jobs/contacts/batch"

	payload := strings.NewReader("{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/contacts/batch")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/contacts/batch")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}"

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

{
  "tasks": [
    {
      "job_id": "<string>",
      "task_id": "<string>",
      "state": "<string>"
    }
  ],
  "errors": [
    {
      "job_id": "<string>",
      "code": "<string>",
      "detail": "<string>"
    }
  ]
}

POST

jobs

contacts

batch

Batch Submit Hiring Manager Contacts

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/contacts/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_ids": [
    "<string>"
  ],
  "functions": [
    "<string>"
  ],
  "relationships": [
    "<string>"
  ],
  "exclude": {},
  "reveal_email": true,
  "reveal_phone": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/contacts/batch"

payload = {
    "job_ids": ["<string>"],
    "functions": ["<string>"],
    "relationships": ["<string>"],
    "exclude": {},
    "reveal_email": True,
    "reveal_phone": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_ids: ['<string>'],
    functions: ['<string>'],
    relationships: ['<string>'],
    exclude: {},
    reveal_email: true,
    reveal_phone: true
  })
};

fetch('https://api.hirebase.org/v2/jobs/contacts/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/contacts/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_ids' => [
        '<string>'
    ],
    'functions' => [
        '<string>'
    ],
    'relationships' => [
        '<string>'
    ],
    'exclude' => [
        
    ],
    'reveal_email' => true,
    'reveal_phone' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hirebase.org/v2/jobs/contacts/batch"

	payload := strings.NewReader("{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/contacts/batch")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/contacts/batch")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_ids\": [\n    \"<string>\"\n  ],\n  \"functions\": [\n    \"<string>\"\n  ],\n  \"relationships\": [\n    \"<string>\"\n  ],\n  \"exclude\": {},\n  \"reveal_email\": true,\n  \"reveal_phone\": true\n}"

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

{
  "tasks": [
    {
      "job_id": "<string>",
      "task_id": "<string>",
      "state": "<string>"
    }
  ],
  "errors": [
    {
      "job_id": "<string>",
      "code": "<string>",
      "detail": "<string>"
    }
  ]
}

Requires the Hiring Manager API add-on, like Hiring Manager Contacts.

Queue up to 100 postings in one request instead of one request each. Every posting becomes its own contacts_extraction task, researched and billed exactly like a single submit: $0.30 for each search that finds at least one contact, plus any reveals found, settled when each task finishes. Postings that find no one, or fail, cost nothing. The whole batch counts as one request against your rate limit. Poll the tasks with List Tasks, which returns every task with its result in one call, or with Get Task Status one by one. Task reads have their own budget of 600 requests per minute.

Endpoint

POST /v2/jobs/contacts/batch

Request Body

string[]

required

1 to 100 Hirebase job ids (_id from any Search Jobs result). Duplicates are queued once. Expired postings are accepted on the same terms as a single submit.

string[]

Only return people in these functions, on every posting. Same values and behaviour as on Hiring Manager Contacts.

string[]

Only return people with these relationships to the role (hiring_manager, function_leader, recruiter, hr, executive, other), on every posting. Same values and behaviour as on Hiring Manager Contacts.

object

People you already have (linkedin_urls, emails; up to 10,000 entries in total), applied to every posting in the batch. Send it once per batch rather than splitting it. See Hiring Manager Contacts.

boolean

default:"false"

Also look up a work email for every contact found, on every posting. $0.05 per email actually found.

boolean

default:"false"

Also look up a direct phone number for every contact found, on every posting. $0.40 per number actually found.

Response

object[]

One entry per posting that was queued, in the order you sent them.

Show properties

string

The posting.

string

Task to poll.

string

Always "queued".

object[]

One entry per id that was not queued. Nothing is charged for these.

Show properties

string

The id you sent.

string

job_not_found: no live or archived posting has this id.

string

The reason in words.

Example

curl -X POST "https://api.hirebase.org/v2/jobs/contacts/batch" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "job_ids": ["6a6efd8c5c1df030c3de5da7", "6a7bb93280574f78dddadccc", "linkedin-4012345"] }'

import time, requests

H = {"x-api-key": "YOUR_API_KEY"}
job_ids = ["6a6efd8c5c1df030c3de5da7", "6a7bb93280574f78dddadccc"]  # up to 100
batch = requests.post("https://api.hirebase.org/v2/jobs/contacts/batch", headers=H,
                      json={"job_ids": job_ids}).json()
pending = {t["task_id"] for t in batch["tasks"]}

while pending:
    time.sleep(30)
    tasks = requests.get("https://api.hirebase.org/v2/tasks/", headers=H,
                         params={"task_type": "contacts_extraction", "limit": 1000}).json()
    for task in tasks:
        if task["id"] in pending and task["state"] in ("finished", "failed"):
            pending.discard(task["id"])
            if task["state"] == "finished":
                print(task["input"]["job_id"], len(task["result"]["contacts"]), "contacts")
            elif task["retryable"]:
                print(task["input"]["job_id"], "temporary failure, submit again")
            else:
                print(task["input"]["job_id"], "skipped:", task["error_code"])

Response

{
  "tasks": [
    { "job_id": "6a6efd8c5c1df030c3de5da7", "task_id": "7b2bc000-02d7-420b-8654-36a8e54f6e4f", "state": "queued" },
    { "job_id": "6a7bb93280574f78dddadccc", "task_id": "c614df14-a990-46ed-8c99-2ac3fc193258", "state": "queued" }
  ],
  "errors": [
    {
      "job_id": "linkedin-4012345",
      "detail": "No live or archived posting has the id 'linkedin-4012345'. Use the _id of a Hirebase job.",
      "code": "job_not_found"
    }
  ]
}

Error Responses

402 Payment Required

Your last Hiring Manager API charge failed; nothing in the batch is queued. Same body and fix as on Hiring Manager Contacts.

403 Forbidden

Your key doesn’t have the Hiring Manager API add-on (X-Billing-Code: feature_missing).

422 Unprocessable Entity

job_ids is empty, has more than 100 ids, or the body has an unknown field.

Jobs API

Expired & Historical Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Batch Submit Hiring Manager Contacts

Endpoint

Request Body

Response

Example

Error Responses

​Endpoint

​Request Body

​Response

​Example

​Error Responses

Endpoint

Request Body

Response

Example

Error Responses