---
title: "Application overview"
icon: "file-lines"
description: "Application statuses, update rules, and key constraints"
---

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

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.

<CardGroup cols={3}>
  <Card title="Create application" icon="code" href="/api-reference/application/post-customers-applications">
    `POST` /customers/\{customer_id\}/applications/
  </Card>
  <Card title="Get latest application" icon="code" href="/api-reference/application/get-customers-applications-latest">
    `GET` /customers/\{customer_id\}/applications/latest/
  </Card>
  <Card title="Update application" icon="code" href="/api-reference/application/patch-customers-applications-latest">
    `PATCH` /customers/\{customer_id\}/applications/latest/
  </Card>
</CardGroup>

## Essentials

<Steps>
  <Step title="Set 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, `amount` represents the additional funds requested (response includes `is_topup: true`).
  </Step>
  <Step title="Check the status">
    Poll `GET /applications/latest/` or use webhooks (`application_status_changed`) to track progress.
    The `is_closed` field tells you whether the application can still be modified.
  </Step>
  <Step title="Update 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`, or `in_underwriting`).
  </Step>
</Steps>

<Info>
- Wait three months before opening a new application for a declined customer.
</Info>

## Reference

<AccordionGroup>
  <Accordion title="Application statuses">
    | Status | Definition |
    |---|---|
    | `open` | No decision yet, possibly missing information |
    | `action_required` | Uploaded documents may not meet requirements |
    | `awaiting_underwriter` | Documents meet requirements, awaiting Credit Analyst |
    | `in_underwriting` | A Credit Analyst is assessing the application |
    | `offered` | Confirmed offer issued |
    | `funded` | Customer has drawn down |
    | `expired` | Offer expired |
    | `deferred` | Application deferred or timed out |
    | `declined` | iwoca could not make an offer |
    | `talking_to_customer` | Offer given, contact entity switched to customer |
    | `conditional_offer` | Offer subject to special conditions (rare) |
    | `offer_revoked` | Offer revoked (for example, identity verification issue) |
  </Accordion>
  <Accordion title="Open vs closed applications">
    A closed application is one where:
    - iwoca made a decision and returned an offer (`offered`).
    - iwoca declined the customer (`declined`).
    - The application timed out (`deferred`).

    The `is_closed` field indicates whether the application can still be modified.
  </Accordion>
  <Accordion title="Purpose values">
    `stock_purchase`, `bridging_loan`, `marketing`, `equipment_purchase`, `pay_bill`, `pay_staff`, `refinancing_debt`, `financing_client_order`, `pay_tax_bill`, `other`
  </Accordion>
  <Accordion title="Optional fields">
    - `duration` – Object with `amount` (integer) and `unit`.
      Requests use `months`; offer and webhook payloads may return the duration in `days`.
      Valid units: `days`, `months`, `years`.
    - `purpose` – Enum, see values above
  </Accordion>
</AccordionGroup>