curl --request POST \
--url https://api.firmable.com/ai-adoption \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "f000000339121"
}
'{
"input": {
"company_id": "f000000339121"
},
"company": {
"firmable_id": "f000000339121",
"company_name": "PGIM",
"country": "US",
"industry_group": "Financial services",
"size_band": "ENTERPRISE",
"overall_level": "STRONG",
"explanation": "AI workforce strong with dedicated AI leadership, basic footprint across Workplace AI assistants, meaningful architecture including Docker, AWS SageMaker, Amazon ECS, basic AI hiring.",
"momentum": {
"label": "EXPANDING",
"signals": [
{
"count": 2,
"kind": "AI hiring",
"latest": "2026-10-13"
}
]
},
"dimensions": {
"architecture": {
"level": "MEANINGFUL",
"headline": "4 of 14 capabilities: Serving, Data pipelines, Containers, CI/CD · Docker, AWS SageMaker, Amazon ECS",
"observability": "HIGH",
"counts_toward_overall": true
},
"footprint": {
"level": "BASIC",
"headline": "1 of 9 categories: General AI assistants · Claude (Anthropic)",
"observability": "HIGH",
"counts_toward_overall": true
},
"hiring": {
"level": "BASIC",
"headline": "3 AI roles in 12 months · none in the last 90 days · 1 leadership · latest Oct 2026",
"observability": "HIGH",
"counts_toward_overall": true
},
"initiatives": {
"level": "NONE",
"headline": null,
"observability": "HIGH",
"counts_toward_overall": true
},
"workforce": {
"level": "STRONG",
"headline": "AI leadership in place · 11 AI specialists, 6 senior · highest level VP/Director",
"observability": "HIGH",
"counts_toward_overall": true
}
},
"evidence_available": {
"architecture": 33,
"footprint": 3,
"hiring": 3,
"initiatives": 5,
"workforce": 20
},
"as_of": "2026-11-10",
"framework_version": "2026.10"
},
"usage": {
"billable": true
}
}AI Adoption API
Get AI Adoption
Returns how far a company has adopted AI
POST
/
ai-adoption
curl --request POST \
--url https://api.firmable.com/ai-adoption \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "f000000339121"
}
'{
"input": {
"company_id": "f000000339121"
},
"company": {
"firmable_id": "f000000339121",
"company_name": "PGIM",
"country": "US",
"industry_group": "Financial services",
"size_band": "ENTERPRISE",
"overall_level": "STRONG",
"explanation": "AI workforce strong with dedicated AI leadership, basic footprint across Workplace AI assistants, meaningful architecture including Docker, AWS SageMaker, Amazon ECS, basic AI hiring.",
"momentum": {
"label": "EXPANDING",
"signals": [
{
"count": 2,
"kind": "AI hiring",
"latest": "2026-10-13"
}
]
},
"dimensions": {
"architecture": {
"level": "MEANINGFUL",
"headline": "4 of 14 capabilities: Serving, Data pipelines, Containers, CI/CD · Docker, AWS SageMaker, Amazon ECS",
"observability": "HIGH",
"counts_toward_overall": true
},
"footprint": {
"level": "BASIC",
"headline": "1 of 9 categories: General AI assistants · Claude (Anthropic)",
"observability": "HIGH",
"counts_toward_overall": true
},
"hiring": {
"level": "BASIC",
"headline": "3 AI roles in 12 months · none in the last 90 days · 1 leadership · latest Oct 2026",
"observability": "HIGH",
"counts_toward_overall": true
},
"initiatives": {
"level": "NONE",
"headline": null,
"observability": "HIGH",
"counts_toward_overall": true
},
"workforce": {
"level": "STRONG",
"headline": "AI leadership in place · 11 AI specialists, 6 senior · highest level VP/Director",
"observability": "HIGH",
"counts_toward_overall": true
}
},
"evidence_available": {
"architecture": 33,
"footprint": 3,
"hiring": 3,
"initiatives": 5,
"workforce": 20
},
"as_of": "2026-11-10",
"framework_version": "2026.10"
},
"usage": {
"billable": true
}
}Description
Returns how far a company has adopted AI: an overall level, a one-line explanation, momentum, and a level for each of five areas (architecture, footprint, hiring, initiatives, workforce).
Ask about one company, or up to 100 in a batch.
See AI Adoption for the full guide.
Request body
| Field | What it is |
|---|---|
company_id | A Firmable company ID, such as f000000339121. |
domain | The company’s domain, such as pgim.com. |
external_id | Optional. Your own ID, up to 200 characters, returned in input. |
records | Optional. Up to 100 rows, each with company_id or domain and an optional external_id. Send it instead of the fields above, not with them. |
company_id or domain. Any other field returns 400.
One company
curl -X POST "https://api.firmable.com/ai-adoption" \
-H "Authorization: Bearer fbl_your_key" \
-H "Content-Type: application/json" \
-d '{ "company_id": "f000000339121" }'
A batch
curl -X POST "https://api.firmable.com/ai-adoption" \
-H "Authorization: Bearer fbl_your_key" \
-H "Content-Type: application/json" \
-d '{
"records": [
{ "company_id": "f000000339121", "external_id": "row-1" },
{ "domain": "linfox.com", "external_id": "row-2" }
]
}'
results array with one answer per company, in the order sent, and
usage.billable_rows.
Response
A single answer hasinput (what you sent), company (the AI adoption, or null when Firmable has
none) and usage.billable. A company that isn’t found also has error.code set to not_found, and
still returns 200. See AI Adoption for an example and
every field.
Evidence
Add?withEvidence=true to get an evidence object with each answer: one entry per area that has
evidence, each with as_of, framework_version, item_count, truncated and items. The value
must be true or false, and it can’t go in the body. See
Get the evidence.
Credits
| Answer | Credits |
|---|---|
| A company found | 1 per 5 companies |
| A company found with evidence | 3 per company |
| A company not found, failed requests | Free |
usage.billable is true
on each answer you pay for.
Before reading anything, Firmable checks your organisation has enough credits to pay for every row
as if each company were found. If not, the call returns 402 and nothing is charged. Customer keys
spend subscription credits, then add-on credits. Developer keys spend
developer credits.
Errors
Errors from this endpoint have this shape:{
"error": {
"code": "invalid_request",
"message": "withEvidence: must be true or false",
"docs_url": "/ai-adoption"
}
}
| Status | Code | When |
|---|---|---|
400 | invalid_request | No company, both company_id and domain, an unknown field, an empty records or more than 100, or withEvidence that isn’t true or false. The message names the field |
401 | A missing or invalid API key | |
402 | insufficient_credits | Your organisation hasn’t enough credits for every row to be found |
403 | forbidden | The key can’t use this endpoint, such as a partner key |
500 | Something went wrong. Try again |
Authorizations
Query Parameters
Body
application/json
Response
One answer, or a batch with results
- Option 1
- Option 2