---
title: "Get illustrations by account ID"
method: GET
path: "/instalment-illustrations/account/{account_id}"
tags: ["Instalments"]
---

# Get illustrations by account ID

`GET /instalment-illustrations/account/{account_id}`

## Request

- Base URL: `http://<host-url>`
- URL: `http://<host-url>/instalment-illustrations/account/{account_id}`
- Auth: HTTP bearer

Retrieves all installment illustrations for an account by its ID.

## Path parameters

- `account_id` integer, required

## Headers

- `unique-request-id` string

## Response `200`

Generated loan illustrations successfully.

- IllustrationDto[]
  - `account_id` integer: Account ID
  - `amount_per_cycle` number: Repayment amount per cycle
  - `cancellation_fee_amount` number: The fixed fee amount for cancelling the instalment loan, if configured
  - `cancellation_fee_calculation` 'HIGHER' | 'LOWER': HIGHER or LOWER, determines whether higher or lower of cancellation amount or cancellation percentage is charged
  - `cancellation_fee_percentage` number: The cancellation fee calculated as a percentage of the outstanding instalment loan, if configured
  - `eligible_transaction_reference` string: The eligible transaction on which this illustration is based
  - `first_repayment_date` string, date: First repayment due date
  - `id` integer: Illustration ID
  - `instalment_finance_option` integer: Finance option ID
  - `interest_calculation_method` 'FLAT' | 'REDUCING_BALANCE': Flat or reducing balance
  - `interest_rate` number: Interest rate percentage
  - `last_repayment_date` string, date: Last repayment due date
  - `late_fee_amount` number: The late payment fee fixed amount, if configured
  - `late_fee_calculation` 'HIGHER' | 'LOWER': HIGHER or LOWER, determines whether higher or lower of late payment amount or late payment percentage is charged
  - `late_fee_percentage` number: The late payment fee calculated as a percentage of the loan amount, if configured
  - `merchant_category_code` string: Not currently in use
  - `merchant_name` string: Not currently in use
  - `number_cycles` integer: Number of cycles or the loan tenure
  - `processing_fee` number: The one off processing fee, if configured
  - `product_id` integer: Product ID
  - `termination_fee_amount` number: The fixed fee amount for termination of the instalment loan, if configured
  - `termination_fee_calculation` 'HIGHER' | 'LOWER': HIGHER or LOWER, determines whether higher or lower of termination amount or termination percentage is charged
  - `termination_fee_percentage` number: The termination payment fee calculated as a percentage of the loan amount, if configured
  - `total_interest` number: Total interest for the loan
  - `total_principal` number: Loan amount

## Other responses

- `400`: Bad Request
- `500`: Server Error

---

[API](https://skmtc.dev/paymentology/apis/paycredit-api.md) - [All operations](https://skmtc.dev/paymentology/apis/paycredit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/paycredit-api/revisions/cc56df9c933b?raw)