Typical KYB workflow
- Resolve the company:
/cil_name_search.phpby name (10 results per page) or/cil_secno_search.phpif you already hold the SEC number. - Fan out for registry basics:
/cil_type.php,/cil_status.php,/cil_registration_dates.php,/cil_registered_address.php. - Discover filed periods with
/cil_company_submission.phpacross a year range. - Pull the filings:
/cil_gis.phpfor ownership, capital structure and directors;/cil_afs.phpfor financial-statement text.
The full chain costs 7–8 calls per company — roughly one company per day on the 10-request quota. Budget calls or upgrade the subscription before wiring this into a live KYB flow.
Endpoints
Errors & limits
Success responses wrap payloads as {"success": true, "data": …}. Error shapes are consistent across all nine endpoints:
| Code | Meaning | Example body |
|---|---|---|
| 400 | Missing or invalid parameter | "<<parameter>> parameter is required" |
| 401 | No / invalid subscription credentials | {"message":"Unauthorized","http_status_code":401} |
| 404 | No matching company or filing | "No Result Found!" |
| 429 | Daily quota exhausted | "Quota exceeded! You reached the limit of 10 requests per 1 days" |
| 500 | Upstream fetch failure (submissions endpoint) | "Failed to fetch data from the external API." |
| 503 | Service temporarily unavailable | {"message":"Temporarily Unavailable"} |