Bank accounts (Portal)

Get a payout

Fetches one Stripe payout with every balance entry that made it up and a summary of the amount, fees and net, so a bank deposit can be reconciled line by line.

GET
https://api.portal.magicdoor.com/company-app/bank-accounts/{bankAccountId}/payouts/{payoutId}

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

bankAccountIdstringrequired

The bank account the payout was sent to. A Snowflake id sent as a decimal string.

example: 1801556677120004096
payoutIdstringrequired

Stripe's id for the payout, taken from the payout list. An opaque provider token, not a Snowflake id.

example: po_1PxOpaqueStripeId

Response

200 · The payout, its balance entries, and the summary.

idstring

The payout's id at Stripe. An opaque provider token, not a MagicDoor Snowflake id — pass it back verbatim to fetch the payout's details.

stripeAccountIdstring

The Stripe connected account the payout was made from. An opaque provider token.

amountnumber

How much the payout moves into the bank account, in dollars and cents.

currencystring

The currency of the payout, as reported by Stripe.

descriptionstring

Stripe's description of the payout. Absent when it has none.

statementDescriptorstring

The text that appears on the bank statement. Absent when none was set.

methodstring

How Stripe sent the money, as Stripe reports it — for example standard or instant.

typestring

The destination type Stripe reports, for example bank_account.

statusstring

The payout's state as Stripe reports it, for example paid, pending, in_transit, canceled or failed.

automaticboolean

true when Stripe created the payout on its own schedule rather than it being requested.

createdstring · date-time

When Stripe created the payout, in the company's timezone.

arrivalDatestring · date-time

When Stripe expects the money to land in the bank account, in the company's timezone.

destinationIdstring

Stripe's id for the account the money was sent to. An opaque provider token. Absent when Stripe does not report one.

itemsPayoutItem[]

Every Stripe balance entry that rolled into this payout, with the property, unit, lease and person behind each one resolved.

summaryobject

What the payout came to in total.

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

404 · The bank account has no Stripe connected account, or Stripe has no payout with that id on it.