Get company
curl --request GET \
--url https://app.jolts.xyz/api/companies/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.jolts.xyz/api/companies/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {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["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": 2,
"name": "<string>",
"domains": [
{
"id": 2,
"hostname": "<string>"
}
],
"observations": [
{
"id": 456,
"kind": "facility_expansion",
"observed_fact": "Example Logistics announced a new distribution warehouse.",
"why_it_may_matter": "A new warehouse may need handling equipment; no purchasing decision is confirmed.",
"demand_class": "proxy",
"country": "CA",
"confidence": 0.8,
"occurred_at": "2026-09-20T00:00:00Z",
"observed_at": "2026-09-21T12:00:00Z",
"expires_at": null,
"evidence": [
{
"source_uri": "https://logistics.example/news/warehouse",
"excerpt": "We are opening a new distribution warehouse.",
"occurred_at": "2026-09-20T00:00:00Z",
"observed_at": "2026-09-21T12:00:00Z"
}
]
}
],
"limitations": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}Companies
Get company
Unmetered, subscription-authorized corpus read. At most three recent current observations and domains supported by those observations; not a complete profile. Does not acquire data or call AI.
GET
/
api
/
companies
/
{id}
Get company
curl --request GET \
--url https://app.jolts.xyz/api/companies/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.jolts.xyz/api/companies/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {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["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": 2,
"name": "<string>",
"domains": [
{
"id": 2,
"hostname": "<string>"
}
],
"observations": [
{
"id": 456,
"kind": "facility_expansion",
"observed_fact": "Example Logistics announced a new distribution warehouse.",
"why_it_may_matter": "A new warehouse may need handling equipment; no purchasing decision is confirmed.",
"demand_class": "proxy",
"country": "CA",
"confidence": 0.8,
"occurred_at": "2026-09-20T00:00:00Z",
"observed_at": "2026-09-21T12:00:00Z",
"expires_at": null,
"evidence": [
{
"source_uri": "https://logistics.example/news/warehouse",
"excerpt": "We are opening a new distribution warehouse.",
"occurred_at": "2026-09-20T00:00:00Z",
"observed_at": "2026-09-21T12:00:00Z"
}
]
}
],
"limitations": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"retry_after_seconds": 1
},
"usage": {
"id": 2,
"status": "pending",
"request_key": "<string>",
"request_units": 1,
"delivered_units": 1,
"fresh_evidence_units": 1
},
"request_allowance": {
"window_seconds": 1,
"window_remaining": 1,
"weekly_remaining": 1
}
}