--- title: "Get report accounts" method: GET path: "/v1/applications/{applicationId}/reports/{reportId}/accounts" tags: ["Reports"] --- # Get report accounts `GET /v1/applications/{applicationId}/reports/{reportId}/accounts` ## Request - Base URL: `https://api.apply.akahu.nz` - URL: `https://api.apply.akahu.nz/v1/applications/{applicationId}/reports/{reportId}/accounts` - Auth: HTTP bearer **Note**: This endpoint is paginated. To list all Account records, it may be necessary to loop through all available pages using the `cursor` returned with each response. ## Path parameters - `applicationId` string, required - `reportId` string, required ## Query parameters - `cursor` string ## Response `200` Success - object - `items` ReportAccount[], required - `_id` string, nullable, required - `type` 'DEPOSITORY' | 'CREDIT CARD' | 'LOAN' | 'TERM DEPOSIT' | 'KIWISAVER' | 'INVESTMENT' | 'UNKNOWN', required: Types of account: - `DEPOSITORY` A regular transactional or savings bank account. - `CREDIT CARD` A credit card or charge card. - `LOAN` A loan account, including line-of-credit accounts such as revolving home loans. - `TERM DEPOSIT` A term deposit. - `KIWISAVER` A KiwiSaver account. - `INVESTMENT` A generic investment account, e.g. A shares portfolio. - `UNKNOWN` An unsupported account type. - `identifier` string, nullable, required: If available, an official identifier such as an NZ bank account number or credit card number. - `name` string, required - `holder` string, nullable, required: The name of the account holder. - `ownership_type` 'SOLE' | 'JOINT' | 'UNKNOWN' - `provider` object, nullable, required: The institution that provides data (eg. a bank, a card issuer). - `_id` string, required - `name` string, required - `logo` string, required: A URL pointing to a logo for this provider. - `periods` object[], required: Periods of data that have been extracted pertaining to this account. - `_source` string, required: The data source that supplied information in this period - `opening_balance` number, nullable, required: The opening balance for the account in this period, if available. - `closing_balance` number, nullable, required: The closing balance for the account in this period, if available. - `limit` number, nullable, required: The credit limit for the account in this period, if available. - `start` string, date-time, required: The start date of the period. - `end` string, date-time, required: The end date of the period. - `loan` object: Any loan information associated with the account. - `purpose` 'HOME' | 'PERSONAL' | 'VEHICLE' | 'BUSINESS' | 'UNKNOWN', required: The purpose of the loan: - `HOME`: This is a home loan facility. - `PERSONAL`: This is a personal loan facility. - `VEHICLE`: This is a vehicle loan facility, if it can be distinguished from a personal loan. - `BUSINESS`: This is a business loan facility. - `UNKNOWN`: We could not determine what this loan is for. - `interest` object, required - `type` 'FLOATING' | 'FIXED' | 'UNKNOWN', required: The type of interest rate: - `FLOATING`: This account has a variable interest rate. - `FIXED`: This account has a fixed interest rate. - `UNKNOWN`: We could not determine the interest type for this account. - `rate` number: The interest rate percentage for this account, e.g. 6.49 for 6.49%. - `expires_at` string, date-time: When the interest rate expires, if available. This is the date after which the interest rate may change. - `interest_only_expires_at` string, date-time: When the interest only period expires, if available. This is the date after which the borrower will need to start repaying the principal in addition to the interest. - `term` AccountLoanTerm: The duration/term of the loan for it to be paid to completion from the start date of the loan. - `years` number - `months` number - `matures_at` string, date-time: Loan maturity date refers to the date on which a borrower's final loan payment is due. - `initial_principal` number: The loan initial principal amount, this was the original amount borrowed. - `repayment` AccountLoanRepayment, required: Loan repayment information for an account. - `structure` 'PRINCIPAL_AND_INTEREST' | 'REVOLVING' | 'INTEREST_ONLY' | 'UNKNOWN', required: The high-level repayment structure of a loan: - `PRINCIPAL_AND_INTEREST`: Regular repayments include both interest and principal. - `REVOLVING`: Sometimes called a “line of credit” or “revolving credit mortgage”. The idea is to help save on interest by reducing your daily loan balance as much as possible. You can do this by direct crediting all your income into the account and then paying your bills and everyday expenses from the account as you need to. Revolving loans have a floating (or variable) interest rate. The interest is calculated on the daily balance of your account, so by keeping the loan as low as you can, for as long as you can, you should pay less interest. - `INTEREST_ONLY`: You don’t repay any of the money you’ve borrowed (principal) until an agreed time. In the meantime you make regular interest payments. - `UNKNOWN`: We could not determine the repayment structure for this account. - `frequency` 'WEEKLY' | 'FORTNIGHTLY' | 'MONTHLY' | 'QUARTERLY' | 'BIANNUALLY' | 'ANNUALLY': The frequency of repayments for a loan: - `WEEKLY`: Repayments are made every week. - `FORTNIGHTLY`: Repayments are made every two weeks. - `MONTHLY`: Repayments are made every month. - `QUARTERLY`: Repayments are made every three months. - `BIANNUALLY`: Repayments are made every six months. - `ANNUALLY`: Repayments are made every year. - `next_date` string, date-time: The date of the next repayment instalment, if available. - `next_amount` number: The amount of the next repayment instalment, if available. - `cursor` string, nullable, required ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `429`: Too Many Requests - `500`: Internal Server Error --- [API](https://skmtc.dev/akahu/apis/akahu-apply-api.md) - [All operations](https://skmtc.dev/akahu/apis/akahu-apply-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akahu/apis/akahu-apply-api/revisions/3f18eb1ead75?raw)