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 EUR. The API accepts a wide range, but iwoca's product ceiling is lower — check with your iwoca contact for the current ceiling and validate against it 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.