Inquire about a job posting's current form
curl --request POST \
--url https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire', 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.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire",
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([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire"
payload := strings.NewReader("{}")
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))
}HttpResponse<String> response = Unirest.post("https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire")
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 = "{}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"application_form": [
{
"block_type": "SECTION",
"label": "Personal Information",
"children": [
{
"block_type": "QUESTION",
"question_id": "6VrjehyBk685vubNydiR1hSn",
"label": "First name",
"description": null,
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": "FIRST_NAME",
"options": null,
"display_when": null
},
{
"block_type": "QUESTION",
"question_id": "Hjsapofs69cx2iAu6MtTfhoh",
"label": "Last name",
"description": null,
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": "LAST_NAME",
"options": null,
"display_when": null
},
{
"block_type": "INFORMATION",
"category": null,
"text": "We will use this information to contact you about your application.",
"display_when": null
}
]
},
{
"block_type": "QUESTION",
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"label": "What is your desired working location?",
"description": "Select your preferred work arrangement",
"required": true,
"category": null,
"question_type": "SINGLE_SELECT",
"unified_key": null,
"options": [
{
"id": "BsnL4pAhNQc26uSc4JopTP3P",
"label": "Remote",
"unified_key": null
},
{
"id": "8T4fcKgzLxbKFUo4saXaoMTG",
"label": "On-site",
"unified_key": null
},
{
"id": "2cJDK3dq4WNjovohSG7dSpfd",
"label": "Hybrid",
"unified_key": null
}
],
"display_when": null
},
{
"block_type": "QUESTION",
"question_id": "2H26BKTbDn2ygN2GfEcCsUP8",
"label": "What timezone are you in?",
"description": "This helps us schedule meetings at convenient times",
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": null,
"options": null,
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
}
},
{
"block_type": "INFORMATION",
"category": null,
"text": "Remote applicants should include their timezone so we can schedule interviews.",
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
}
},
{
"block_type": "QUESTION",
"question_id": "AdM1EuwBKE4pz94SSRHMgmba",
"label": "Which office would you prefer?",
"description": null,
"required": true,
"category": null,
"question_type": "SINGLE_SELECT",
"unified_key": null,
"options": [
{
"id": "EHCqUb5E6xzfjnfHT2LEgmM7",
"label": "San Francisco",
"unified_key": null
},
{
"id": "5RbHT73StFM5tHdF3aVr4do1",
"label": "New York",
"unified_key": null
},
{
"id": "F4rRwGTNeLQZV5VLwstERpsT",
"label": "London",
"unified_key": null
}
],
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "8T4fcKgzLxbKFUo4saXaoMTG"
}
},
{
"block_type": "QUESTION",
"question_id": "FuVZvF26NueKcN46o5euHeGx",
"label": "How many days per week would you like to work in the office?",
"description": null,
"required": true,
"category": null,
"question_type": "NUMBER",
"unified_key": null,
"options": null,
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "2cJDK3dq4WNjovohSG7dSpfd"
}
}
],
"requires_proxy_email": true,
"submission_token": "<example-token>"
}
}
Job postings
Inquire about a job posting's current form
Receive the application form (screening questions) for a job posting and a single-use submission JWT. Store the token with the exact application form returned alongside it. The submission token is valid for 2 days and can be used for one application. The application form may contain conditional questions that are only shown based on answers to previous questions (check the display_when field).
POST
/
ai-apply
/
postings
/
{posting_id}
/
inquire
Inquire about a job posting's current form
curl --request POST \
--url https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire', 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.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire",
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([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire"
payload := strings.NewReader("{}")
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))
}HttpResponse<String> response = Unirest.post("https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kombo.dev/v1/ai-apply/postings/{posting_id}/inquire")
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 = "{}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"application_form": [
{
"block_type": "SECTION",
"label": "Personal Information",
"children": [
{
"block_type": "QUESTION",
"question_id": "6VrjehyBk685vubNydiR1hSn",
"label": "First name",
"description": null,
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": "FIRST_NAME",
"options": null,
"display_when": null
},
{
"block_type": "QUESTION",
"question_id": "Hjsapofs69cx2iAu6MtTfhoh",
"label": "Last name",
"description": null,
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": "LAST_NAME",
"options": null,
"display_when": null
},
{
"block_type": "INFORMATION",
"category": null,
"text": "We will use this information to contact you about your application.",
"display_when": null
}
]
},
{
"block_type": "QUESTION",
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"label": "What is your desired working location?",
"description": "Select your preferred work arrangement",
"required": true,
"category": null,
"question_type": "SINGLE_SELECT",
"unified_key": null,
"options": [
{
"id": "BsnL4pAhNQc26uSc4JopTP3P",
"label": "Remote",
"unified_key": null
},
{
"id": "8T4fcKgzLxbKFUo4saXaoMTG",
"label": "On-site",
"unified_key": null
},
{
"id": "2cJDK3dq4WNjovohSG7dSpfd",
"label": "Hybrid",
"unified_key": null
}
],
"display_when": null
},
{
"block_type": "QUESTION",
"question_id": "2H26BKTbDn2ygN2GfEcCsUP8",
"label": "What timezone are you in?",
"description": "This helps us schedule meetings at convenient times",
"required": true,
"category": null,
"question_type": "TEXT",
"unified_key": null,
"options": null,
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
}
},
{
"block_type": "INFORMATION",
"category": null,
"text": "Remote applicants should include their timezone so we can schedule interviews.",
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
}
},
{
"block_type": "QUESTION",
"question_id": "AdM1EuwBKE4pz94SSRHMgmba",
"label": "Which office would you prefer?",
"description": null,
"required": true,
"category": null,
"question_type": "SINGLE_SELECT",
"unified_key": null,
"options": [
{
"id": "EHCqUb5E6xzfjnfHT2LEgmM7",
"label": "San Francisco",
"unified_key": null
},
{
"id": "5RbHT73StFM5tHdF3aVr4do1",
"label": "New York",
"unified_key": null
},
{
"id": "F4rRwGTNeLQZV5VLwstERpsT",
"label": "London",
"unified_key": null
}
],
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "8T4fcKgzLxbKFUo4saXaoMTG"
}
},
{
"block_type": "QUESTION",
"question_id": "FuVZvF26NueKcN46o5euHeGx",
"label": "How many days per week would you like to work in the office?",
"description": null,
"required": true,
"category": null,
"question_type": "NUMBER",
"unified_key": null,
"options": null,
"display_when": {
"question_id": "EKaumKPGjeA97cb8ystMmkCe",
"answer_equals": "2cJDK3dq4WNjovohSG7dSpfd"
}
}
],
"requires_proxy_email": true,
"submission_token": "<example-token>"
}
}
Authorizations
Path Parameters
The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.
Body
application/json
POST /ai-apply/postings/:posting_id/inquire Request body
The body is of type object.
Response
POST /ai-apply/postings/:posting_id/inquire Positive response
Allowed value:
"success"Show child attributes
Show child attributes
Example:
{ "application_form": [ { "block_type": "SECTION", "label": "Personal Information", "children": [ { "block_type": "QUESTION", "question_id": "6VrjehyBk685vubNydiR1hSn", "label": "First name", "description": null, "required": true, "category": null, "question_type": "TEXT", "unified_key": "FIRST_NAME", "options": null, "display_when": null }, { "block_type": "QUESTION", "question_id": "Hjsapofs69cx2iAu6MtTfhoh", "label": "Last name", "description": null, "required": true, "category": null, "question_type": "TEXT", "unified_key": "LAST_NAME", "options": null, "display_when": null }, { "block_type": "INFORMATION", "category": null, "text": "We will use this information to contact you about your application.", "display_when": null } ] }, { "block_type": "QUESTION", "question_id": "EKaumKPGjeA97cb8ystMmkCe", "label": "What is your desired working location?", "description": "Select your preferred work arrangement", "required": true, "category": null, "question_type": "SINGLE_SELECT", "unified_key": null, "options": [ { "id": "BsnL4pAhNQc26uSc4JopTP3P", "label": "Remote", "unified_key": null }, { "id": "8T4fcKgzLxbKFUo4saXaoMTG", "label": "On-site", "unified_key": null }, { "id": "2cJDK3dq4WNjovohSG7dSpfd", "label": "Hybrid", "unified_key": null } ], "display_when": null }, { "block_type": "QUESTION", "question_id": "2H26BKTbDn2ygN2GfEcCsUP8", "label": "What timezone are you in?", "description": "This helps us schedule meetings at convenient times", "required": true, "category": null, "question_type": "TEXT", "unified_key": null, "options": null, "display_when": { "question_id": "EKaumKPGjeA97cb8ystMmkCe", "answer_equals": "BsnL4pAhNQc26uSc4JopTP3P" } }, { "block_type": "INFORMATION", "category": null, "text": "Remote applicants should include their timezone so we can schedule interviews.", "display_when": { "question_id": "EKaumKPGjeA97cb8ystMmkCe", "answer_equals": "BsnL4pAhNQc26uSc4JopTP3P" } }, { "block_type": "QUESTION", "question_id": "AdM1EuwBKE4pz94SSRHMgmba", "label": "Which office would you prefer?", "description": null, "required": true, "category": null, "question_type": "SINGLE_SELECT", "unified_key": null, "options": [ { "id": "EHCqUb5E6xzfjnfHT2LEgmM7", "label": "San Francisco", "unified_key": null }, { "id": "5RbHT73StFM5tHdF3aVr4do1", "label": "New York", "unified_key": null }, { "id": "F4rRwGTNeLQZV5VLwstERpsT", "label": "London", "unified_key": null } ], "display_when": { "question_id": "EKaumKPGjeA97cb8ystMmkCe", "answer_equals": "8T4fcKgzLxbKFUo4saXaoMTG" } }, { "block_type": "QUESTION", "question_id": "FuVZvF26NueKcN46o5euHeGx", "label": "How many days per week would you like to work in the office?", "description": null, "required": true, "category": null, "question_type": "NUMBER", "unified_key": null, "options": null, "display_when": { "question_id": "EKaumKPGjeA97cb8ystMmkCe", "answer_equals": "2cJDK3dq4WNjovohSG7dSpfd" } } ], "requires_proxy_email": true, "submission_token": "<example-token>" }
Was this page helpful?