Owner transfers

Get an owner transfer

Fetches one owner transfer with both sides of the movement and the owner, portfolios, properties, transactions, bank accounts, chart of accounts and files it refers to.

GET
https://api.portal.magicdoor.com/company-app/owners/transfers/{ownerTransferId}

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

ownerTransferIdstringrequired

The owner transfer. A Snowflake id sent as a decimal string.

example: 1840110447398404096

Response

200 · The owner transfer.

idstring

The owner transfer. A Snowflake id sent as a decimal string.

ownerIdstring

The owner whose money is being moved. Both properties must be theirs.

transferDatestring · date

The day the money moved.

amountnumber

How much moved, in dollars and cents. Always positive: it leaves the source property and arrives at the destination property.

sourceobject

The source side of the transfer — where the money leaves.

destinationobject

The destination side of the transfer — where the money arrives.

memostring

A note on the transfer. Absent when none was set.

referencestring

A reference on the transfer. Absent when none was set.

filesobject[]

Files attached to the record.

metadataobject

Free-form key-value pairs kept on the transfer.

createdstring · date-time

When the transfer was created, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

creatorobject

Who created the record.

ownerobject

The owner named by ownerId, as the full owner record.

portfoliosobject[]

The portfolios the lines belong to, resolved.

propertiesobject[]

The properties the lines apply to, resolved.

transactionsobject[]

The accounting transactions behind the allocations, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved. Account and routing numbers are masked to their last four digits.

chartOfAccountsobject[]

The chart of accounts the lines book to, resolved.

hydratedFilesobject[]

The attachments in files, resolved to full file records with signed download URLs.

creatorInfoobject

The person behind creator, resolved. Exactly one of propertyManager, vendor, tenant and owner is present, matching creator.type.

401 · The access token is missing, expired, or does not belong to a property manager.

404 · No owner transfer with that id exists for the caller's company.