Check funding eligibility for one company
Which kinds of business funding a UK company may qualify for, answered from its record at the UK company register and what you already know. Time in business decides most of it; monthly revenue sharpens the answer and is only needed where a minimum depends on it. Uses the same rules as live matching. Nothing is created, no credit search runs, no lender sees the business, and no lender is ever named. Enabled per partner: ask partnerships@capvant.com to switch it on for your account; until then the route answers 404. Send an Idempotency-Key to make a retry replay the stored answer.
An access token from POST /oauth/token. Valid for one hour. Preferred, because a leaked request log then exposes an hour rather than a permanent credential.
In: header
Header Parameters
The same key and body within 24 hours replays the stored answer (Idempotent-Replayed: true). The same key with a different body is refused.
length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
One company per call. Only the United Kingdom is served today. Nothing is created, no credit search runs and no lender sees the business.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://sandbox.capvant.com/eligibility/check" \ -H "Content-Type: application/json" \ -d '{ "country": "GB", "company": {} }'{ "check_id": "string", "partner_customer_id": "string", "status": "complete", "company": { "company_number": "string", "name": "string", "status": "string", "entity_type": "string", "incorporated_on": "2019-08-24", "months_trading": 0, "industry": { "code": "string", "title": "string" } }, "register_as_of": "2019-08-24", "data_path": "live", "summary": { "band": "likely", "confidence": "high", "headline": "string", "advisory": true }, "families": [ { "family": "working_capital", "label": "string", "band": "likely", "breadth": "limited", "confidence": "high", "missing": [ "monthly_revenue" ], "sharpened_by": [ "monthly_revenue" ], "available_from": "2019-08-24", "reasons": [ "trading_history_too_short" ], "lender_review": true } ], "missing_data": [ { "field": "monthly_revenue", "why": "string", "required": true, "unlocks": [ "working_capital" ] } ], "next_best_action": { "type": "start_request", "field": "monthly_revenue", "date": "2019-08-24", "detail": "string" }, "cautions": [ { "code": "accounts_overdue", "detail": "string", "count": 0 } ], "candidates": [ { "company_number": "string", "name": "string", "postcode_district": "string", "incorporated_year": 0 } ], "rules_version": "string", "disclaimer": "string"}