Get company
curl --request GET \
--url https://app.jolts.xyz/api/companies/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://app.jolts.xyz/api/companies/{id}"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://app.jolts.xyz/api/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://app.jolts.xyz/api/companies/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.jolts.xyz/api/companies/{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>",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.jolts.xyz/api/companies/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.jolts.xyz/api/companies/{id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.asString();{
"company": {
"id": 23,
"name": "Sequoia Freight",
"domains": [
{
"id": 23,
"hostname": "sequoia.example.test"
}
],
"observations": [
{
"id": 23,
"kind": "procurement_request",
"observed_fact": "Issued a request for fleet charging equipment at a new depot.",
"why_it_may_matter": "This observed company activity may be relevant to the search objective; verify fit against the evidence.",
"demand_class": "explicit_request",
"country": "US",
"confidence": 1,
"occurred_at": "2026-09-18T00:00:00Z",
"observed_at": "2026-09-25T02:47:06Z",
"expires_at": null,
"evidence": [
{
"source_uri": "https://sequoia.example.test/tenders/fleet-charging",
"excerpt": "Issued a request for fleet charging equipment at a new depot.",
"occurred_at": "2026-09-18T00:00:00Z",
"observed_at": "2026-09-25T02:47:06Z"
}
]
}
],
"limitations": [
"limited_source_coverage"
]
}
}{
"usage": {
"id": 981239949,
"status": "pending",
"request_key": "company",
"request_units": 0,
"delivered_units": 0,
"fresh_evidence_units": 0
},
"request_allowance": {
"window_seconds": 10800,
"window_remaining": 198,
"weekly_remaining": 998
}
}{
"error": {
"code": "invalid_api_key",
"message": "Provide a valid API credential."
}
}{
"error": {
"code": "subscription_required",
"message": "An active or trialing subscription is required."
}
}{
"error": {
"code": "company_not_found",
"message": "No deliverable company has that ID."
}
}{
"error": {
"code": "invalid_search",
"message": "background must be a boolean"
}
}{
"error": {
"code": "request_limit_reached",
"message": "The subscription request limit has been reached.",
"retry_at": "2026-09-25T05:00:00Z",
"retry_after_seconds": 60
}
}Companies
Get company
Metered known-company lookup using the same operation as GET /api/companies and MCP get_companies. Requires Idempotency-Key; identical retries share settlement across interfaces. Returns at most three current observations and supported domains, not a complete profile. Does not acquire data or call AI. Unknown companies return 404 after settling one request and zero deliveries.
Examples use fictional test data and illustrative IDs, dates, and allowances. They are not live prospects or current account balances.
GET
/
api
/
companies
/
{id}
Get company
curl --request GET \
--url https://app.jolts.xyz/api/companies/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://app.jolts.xyz/api/companies/{id}"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://app.jolts.xyz/api/companies/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://app.jolts.xyz/api/companies/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.jolts.xyz/api/companies/{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>",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.jolts.xyz/api/companies/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.jolts.xyz/api/companies/{id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.asString();{
"company": {
"id": 23,
"name": "Sequoia Freight",
"domains": [
{
"id": 23,
"hostname": "sequoia.example.test"
}
],
"observations": [
{
"id": 23,
"kind": "procurement_request",
"observed_fact": "Issued a request for fleet charging equipment at a new depot.",
"why_it_may_matter": "This observed company activity may be relevant to the search objective; verify fit against the evidence.",
"demand_class": "explicit_request",
"country": "US",
"confidence": 1,
"occurred_at": "2026-09-18T00:00:00Z",
"observed_at": "2026-09-25T02:47:06Z",
"expires_at": null,
"evidence": [
{
"source_uri": "https://sequoia.example.test/tenders/fleet-charging",
"excerpt": "Issued a request for fleet charging equipment at a new depot.",
"occurred_at": "2026-09-18T00:00:00Z",
"observed_at": "2026-09-25T02:47:06Z"
}
]
}
],
"limitations": [
"limited_source_coverage"
]
}
}{
"usage": {
"id": 981239949,
"status": "pending",
"request_key": "company",
"request_units": 0,
"delivered_units": 0,
"fresh_evidence_units": 0
},
"request_allowance": {
"window_seconds": 10800,
"window_remaining": 198,
"weekly_remaining": 998
}
}{
"error": {
"code": "invalid_api_key",
"message": "Provide a valid API credential."
}
}{
"error": {
"code": "subscription_required",
"message": "An active or trialing subscription is required."
}
}{
"error": {
"code": "company_not_found",
"message": "No deliverable company has that ID."
}
}{
"error": {
"code": "invalid_search",
"message": "background must be a boolean"
}
}{
"error": {
"code": "request_limit_reached",
"message": "The subscription request limit has been reached.",
"retry_at": "2026-09-25T05:00:00Z",
"retry_after_seconds": 60
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Minimum string length:
1Path Parameters
Required range:
x >= 1Response
Current supported company details.
Show child attributes
Show child attributes