Accounting reports

Get an owner package

Fetches one owner package with a fresh download URL for its file. Requires the reports:read permission.

GET
https://services.magicdoor.com/accounting/company-portal/reports/owner-package/{id}

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

Snowflake id of the owner package.

example: 1830472847398413100

Response

200 · The owner package.

idstring

Snowflake id of the package.

ownerIdstring

The owner it was built for.

startDatestring · date-time

First day of the period the package covers. Carries a UTC offset suffix.

endDatestring · date-time

Last moment of the period the package covers. Carries a UTC offset suffix.

includeBillInvoicesboolean

Whether the vendors' own invoice files were bundled in alongside the reports.

reportTypesstring[]

Which reports went into the package. These come back in PascalCase, unlike the camelCase enums used elsewhere in the API.

BalanceSheetCashFlowStatementIncomeStatementOwnerStatement
fileIdstring

The generated file.

fileUrlstring

A URL to download that file. Fetched fresh on every read, so do not store it — read the package again when you need it.

createdstring · date-time

When the package was generated. Carries a UTC offset suffix.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `reports:read` permission.

404 · No owner package with this id belongs to the caller's company, or its file has gone missing.