MagicDoorAPI
SupportOpen MagicDoor
Rental applications

Get Genie's take on an application

Returns MagicDoor's AI summary of an application: an overall verdict, a one-line recommendation, strength and concern bullets, and rollups of landlord verification and co-applicants. Requires the rental_applications:read permission.

GET
https://services.magicdoor.com/leasing/company-portal/rental-applications/{id}/genie-take

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

idstringrequired

The rental application to work with. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Response

200 · The AI summary. Also returned, with `tone` set to `undetermined` and empty bullet lists, when the summary could not be produced.

applicationIdstring

The rental application this summary is about.

toneenum<string>

The overall verdict. undetermined means no evaluation has been produced yet, or producing one failed — in that case recommendation is empty and both bullet lists are empty.

approvecautiondeclineundetermined
recommendationstring

One-sentence recommendation. An empty string when tone is undetermined.

strengthsBullet[]

Points in the applicant's favour.

concernsBullet[]

Points against the applicant, same shape as strengths.

landlordVerificationobject

How the applicant's previous landlords have responded.

coApplicantsobject

Rollup of the co-applicants on this application's group.

generatedAtstring · date-time

When this summary was computed, in UTC — unlike most timestamps in this API, it is not converted to the company's timezone.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:read` permission.

404 · No rental application with this id exists, or it belongs to another company. Both cases look identical so that ids cannot be probed across companies.

Cached for ten minutes

The summary is held for ten minutes per application, so two calls in quick succession return the same generatedAt. Editing the application clears the cache.