Get Installment Detail

Endpoint used to view details and status of an installment that has been created

Request Example

curl --request GET 'https://api.mayar.id/hl/v2/installments/ba82c2dd-06c1-4b6c-bc59-a9c00801c842' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here'

Response Example 200

{
    "statusCode": 200,
    "messages": "success",
    "data": {
        "id": "ba82c2dd-06c1-4b6c-bc59-a9c00801c842",
        "amount": 1500000,
        "interest": 0,
        "interestType": "FLAT",
        "period": "MONTHLY",
        "tenure": 3,
        "dueDate": 11,
        "totalInterest": 0,
        "totalAmount": 1500000,
        "description": "Cicil Produk Kelas Online 3 Bulan",
        "customer": {
            "name": "Budi Santoso",
            "email": "[e-mail]",
            "mobile": "081234567890"
        },
        "status": "unpaid",
        "invoices": [
            {
                "id": "9fe1b9c4-b5d5-4d45-bf1a-5c4849631725",
                "index": 1,
                "amount": 500000,
                "interestAmount": 0,
                "remainingAmount": 1000000,
                "dueDate": "2026-07-11T00:00:00.000Z",
                "status": "unpaid",
                "link": "mkcn4u72ki"
            },
            {
                "id": "977777d6-af25-464e-a8ca-e290b3007275",
                "index": 2,
                "amount": 500000,
                "interestAmount": 0,
                "remainingAmount": 500000,
                "dueDate": "2026-08-11T00:00:00.000Z",
                "status": "unpaid",
                "link": "0ll429zxvsue"
            },
            {
                "id": "1dde3426-f6a4-43d2-a1d9-2cd2fa05eb9a",
                "index": 3,
                "amount": 500000,
                "interestAmount": 0,
                "remainingAmount": 0,
                "dueDate": "2026-09-11T00:00:00.000Z",
                "status": "unpaid",
                "link": "h8fiobqkek"
            }
        ],
        "createdAt": "2026-06-19T17:20:09.521Z"
    }
}

Endpoint:

Production

https://api.mayar.id/hl/v2/installments/{uuId}

https://api.mayar.club/hl/v2/installments/{uuId}

Authorization

Authorization · string · required

Example:

Authorization | Bearer Paste-Your-API-Key-Here

Path Parameters

uuId · string · required

A unique identifier obtained when creating an installment. If accessed through the dashboard, it can be found in the URL on the installment details page.

Example:

ba82c2dd-06c1-4b6c-bc59-a9c00801c842

Response

Successful Response

Main Structure (Root)

statusCode · integer

Status code form API.

messages · string

Status message that describes the status code.

data · object

The installment detail object.

data Structure (Object)

id · string<uuid>

Main installment ID.

amount · integer

Total installment amount.

interest · integer

Interest value.

interestType · string

Type of interest (example: "FLAT").

period · string

Installment period (example: "MONTHLY").

tenure · integer

Installment duration (in months).

dueDate · integer

Due date each month (example: 11).

totalInterest · integer

Total interest across all installments.

totalAmount · integer

Total amount payable across all installments.

description · string

Installment description.

customer · object

Customer details.

status · string

Installment status (example: "unpaid").

invoices · array of object

List of installment invoices.

createdAt · string (ISO 8601)

Creation time in ISO 8601 format.

customer Structure (Object)

name · string

Customer name.

email · string

Customer email address.

mobile · string

Customer phone number.

invoices Structure (Array Of Object)

id · string<uuid>

Invoice ID.

index · integer

Invoice order number.

amount · integer

Invoice amount.

interestAmount · integer

Interest amount for the invoice.

remainingAmount · integer

Remaining balance after this invoice.

dueDate · string (ISO 8601)

Invoice due date in ISO 8601 format.

status · string

Payment status (example: "unpaid").

link · string

Unique invoice link.

Errors

401 Unauthorized · object

Returned with messages: "Unauthorized" when the installment does not belong to the authenticated account.