/v1/companies/{number}One company in a single response: register facts, filed accounts, estimates with their working, scores, people, control, charges, filings and outside signals.
The same payload the Compdex company page is built from. Parts your plan does not include, such as the full credit score, are left out rather than filled. Every estimate carries estimate: true, a range, a confidence and a method; a figure the filing did not state is null, never zero.
curl -H "Authorization: Bearer $COMPDEX_API_KEY" \
"https://api.compdex.ai/v1/companies/$COMPANY_NUMBER"{
"apiVersion": "v1",
"company": {
"number": "…", "name": "…", "slug": "…",
"status": "…", "isActive": true,
"depth": "full", // or "register": built from the bulk register until a full read
"sicCodes": ["…"], "town": "…",
"registeredAddress": { "lines": ["…"], "postcode": "…" },
"incorporatedOn": "YYYY-MM-DD", "accountsNextDue": "YYYY-MM-DD", …
},
"financials": [ … ], // one entry per filed period, newest first; unstated lines are null
"profitEstimate": { // or null when there is nothing to estimate from
"estimate": true, "periodEnd": "YYYY-MM-DD",
"value": 0, // the best guess, never a floor (ADR 0338)
"low": 0, "high": 0, "confidence": 0,
"likely": { "low": 0, "high": 0, "confidence": 0 },
"method": "…", "modelVersion": "…", "workings": [ … ]
},
"turnoverEstimate": { … }, // a similar estimate, or null
"changes": [ … ], // year-on-year movements in filed figures
"distributions": [ … ], // tax, dividends and directors' pay per period
"scores": { // the Compdex Health Score: value, band, three parts, drivers, factors
"health": { "value": 0, "band": "A", "parts": [ … ], "drivers": [ … ], "factors": [ … ], … },
"credit": { … }
},
"officers": [ … ], "formerOfficers": [ … ], "pscs": [ … ],
"charges": [ … ], "filings": [ … ], "timeline": [ … ],
"valuation": { … }, "forecasts": [ … ], "peers": [ … ],
"gazetteNotices": [ … ], "paymentReports": [ … ], "tenderAwards": [ … ],
"evidence": { … }, // the source records behind the figures
"underReview": [ … ], // fields with an open dispute
"freshness": { … },
…
}
// The numbers above are placeholders showing each field's type, not figures.| Status | Meaning |
|---|---|
| 200 | The company. |
| 202 | We do not hold this company yet and are reading it from Companies House. The body is { "status": "loading", "retryAfterSeconds": n }; ask again after that wait. |
| 400 | Not a valid company number. |
| 404 | The register has no such company. |
| 503 | A read failed moments ago: { "status": "unavailable", "reason": "…" }. Try again later. |