> For the complete documentation index, see [llms.txt](/llms.txt).

# Check whether a company is eligible to apply for a loan with iwoca

**POST** `https://www.iwoca.co.uk/api/lending/v2.2/eligibility_check/`

Submit a single company's details and get an immediate eligible / not eligible verdict.

## Body
```json
{
  "data": {
    "companies_house_number": "01111112",
    "details": "tier=A",
    "mcc_code": "5411",
    "sic_code": "62012"
  }
}
```

### Body fields
- `data` (object, required)
- `data.companies_house_number` (string, required) — Companies House number of the business being checked.
- `data.details` (string) — Optional free-text metadata to attach to this check - for example, your internal lead tier. Must not contain personal data.
- `data.mcc_code` (string) — Optional MCC code for the business being checked.
- `data.sic_code` (string) — Optional SIC code for the business being checked.

## Responses
### 201 — Eligibility verdict
```json
{
  "data": {
    "eligibility_check_id": "00000000-0000-0000-0000-000000000000",
    "is_eligible": true
  }
}
```

### 400 — Bad Request
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

### 401 — Unauthorized
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

### 403 — Permission Denied
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

### 404 — Not Found
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

### 406 — Not Acceptable
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

### 500 — Unexpected Error
```json
{
  "errors": [
    {
      "code": "string",
      "detail": "string"
    }
  ]
}
```

## Example (curl)
```bash
curl https://www.iwoca.co.uk/api/lending/v2.2/eligibility_check/ \
  --request POST \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "companies_house_number": "01111112",
    "details": "tier=A",
    "mcc_code": "5411",
    "sic_code": "62012"
  }
}'
```