The top-level loan statuses your company has set up, in the same order
and with the same names as the status screen in the LendingWise portal.
Send an item's id as primaryStatusId when you create or update a
loan file on /api/v4/loans.
Each item's fileTypes lists the loan types the status can be used
with, as ids from /api/v4/loan-types. One status can be set up for
several loan types, and every status you get back is set up for at
least one. By default you only get the statuses that are switched on;
add includeInactive=true to get the switched-off ones too, which is
worth doing if you are displaying older loans that still point at one.
This is not the full list of primaryStatusId values the API will
accept. It shows what the portal shows, and the portal leaves out a
status that is not set up for any switched-on loan type. POST and
PATCH /api/v4/loans still accept that status's id. So:
- Use this list to build a picker. These are the statuses someone
should be choosing from, in your company's own order. - Do not use it to check a value before sending it. An id missing
from this list does not mean the API will refuse it. Send the value
and read the reply. - An id you already hold stays valid — whether it came from
/api/v4/loans, from a webhook, or from your own records, and
whether or not it appears here. Please do not drop or "tidy up" ids
just because this list leaves them out. That is intended behaviour,
so you can rely on it.
Match on id, never on label. id is a permanent record id
(a PSID) and it is the only thing safe to compare against. label is
the name your company chose. It can be renamed at any time from your
own settings screen, and it is null when nobody ever named the
status — that is common enough to plan for: 448 unnamed statuses
exist across 150 companies, and real loans point at them. So label
is fine to show on screen, and code that matches on it, or that assumes
it is never blank, will break on real data.
Order. Statuses come back in the order your company arranged them
in the portal, matching what the portal itself shows: by loan type,
then by your own display order within that loan type, then by name. A
status set up for several loan types takes its position from the first
one it belongs to. A status set up for no switched-on loan type has no
arranged position, so it comes last. The order carries meaning, so do
not re-sort it unless you specifically want a different one.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||

