Application overview
Application statuses, update rules, and key constraints
Create and manage a loan application for a customer. An application specifies how much the customer wants to borrow and progresses through various statuses as iwoca assesses it.
POST /customers/{customer_id}/applications/
GET /customers/{customer_id}/applications/latest/
PATCH /customers/{customer_id}/applications/latest/
Essentials
- 1Set the amount
Required field, in GBP. The API accepts amounts up to £10,000,000, but iwoca's product ceiling is £1,000,000 — validate to £1,000,000 on your front end. If the customer has an existing loan,
amountrepresents the additional funds requested (response includesis_topup: true). - 2Check the status
Poll
GET /applications/latest/or use webhooks (application_status_changed) to track progress. Theis_closedfield tells you whether the application can still be modified. - 3Update if needed
Use
PATCH /applications/latest/to change amount, duration, or purpose. Only works while the application is still open (open,action_required,awaiting_underwriter, orin_underwriting).
- Wait three months before opening a new application for a declined customer.