---
title: "API Installment Status List"
method: GET
path: "/installment/status/list"
tags: ["API Installment Status List"]
---

# API Installment Status List

`GET /installment/status/list`

Service used list policy installments

## Query parameters

- `documentNumber` string
- `dueDate` string
- `policyCode` string
- `status` 'ALL' | 'OPEN' | 'PAID'

## Headers

- `X-Application-Id` string, required
- `X-Company-Id` string, required
- `X-Sucursal-Code` string, required
- `X-Susep-Code` string, required
- `X-Trace-Id` string
- `X-User-Id` string, required

## Response `200`

OK

- PolicyDto[]
  - `broker` BrokerDto
    - `code` string
    - `document` Document
      - `documentType` DocumentType
        - `description` string
        - `id` integer
      - `number` string
    - `id` integer
    - `name` string
    - `sucursalCode` string
    - `susepCode` string
    - `type` BrokerTypeDto
      - `description` string
      - `id` string
  - `customer` CustomerDto
    - `documents` DocumentDto[]
      - `number` string
      - `type` DocumentTypeDto
        - `description` string
        - `id` integer
    - `name` string
    - `socialName` string
  - `id` integer
  - `installments` InstallmentDto[]
    - `billingType` BillingTypeDto
      - `description` string
      - `id` integer
    - `expirationDate` string
    - `id` integer
    - `paymentDate` string
    - `price` PriceDto
      - `amount` number, double
      - `amountFormatted` string
      - `currency` string
    - `quantity` integer
    - `status` StatusDto
      - `description` string
      - `id` integer
  - `issueDate` string
  - `period` PeriodDto
    - `effectiveDate` string
    - `expirationDate` string
  - `policyCode` string
  - `totalPrice` TotalPriceDto
    - `amount` number, double
    - `amountFormatted` string
    - `currency` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Instalments not found
- `405` — Data input not supplied or invalid
- `406` — Exception

---

[API](https://skmtc.dev/hdi/apis/api-authentication-and-authorization.md) · [All operations](https://skmtc.dev/hdi/apis/api-authentication-and-authorization/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hdi/api-authentication-and-authorization/revisions/216d39155ad4/schema)