Skip to main content
POST
Approve or deny an application

Authorizations

Authorization
string
header
required

An API key from Settings, API keys. It starts with rc_live_.

Path Parameters

id
string
required

The application's ID.

Body

application/json
decision
enum<string>
required
Available options:
approved,
denied
decision_reason
string

A key from your decision reasons (see List decision reasons): switched on, for this decision and this kind of application. Required when denying, unless decision_reason_code is given.

decision_reason_code
enum<string>

The seven reasons before decision reasons were your own, still taken: each is the key of the built-in reason with the same name. decision_reason is the way to name any reason.

Available options:
housing_unsuitable,
landlord_denied,
insufficient_experience,
incomplete_information,
animal_unavailable,
better_match_found,
other
decided_on
string<date>

Today unless you say.

decision_notes
string

Why, in words.

Response

The application, decided.

application
object
required

The answers on an application. Send only what changes. A yes or no answer is true, false, or null for not asked. Text is trimmed, and empty text is stored as null.