---
title: "Return the list of the organization debt positions. The due dates interval is mutually exclusive with the payment dates interval."
method: GET
path: "/organizations/{organizationfiscalcode}/debtpositions"
tags: ["Debt Positions API"]
---

# Return the list of the organization debt positions. The due dates interval is mutually exclusive with the payment dates interval.

`GET /organizations/{organizationfiscalcode}/debtpositions`

## Path parameters

- `organizationfiscalcode` string, required

## Query parameters

- `limit` integer
- `page` integer
- `due_date_from` string, date
- `due_date_to` string, date
- `payment_date_from` string, date
- `payment_date_to` string, date
- `status` 'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'
- `orderby` 'INSERTED_DATE' | 'IUPD' | 'STATUS' | 'COMPANY_NAME'
- `ordering` 'ASC' | 'DESC'

## Response `200`

Obtained all organization payment positions.

- PaymentPositionsInfo
  - `payment_position_list` PaymentPositionModelBaseResponse[], required
    - `iupd` string
    - `organizationFiscalCode` string
    - `type` 'F' | 'G'
    - `companyName` string
    - `officeName` string
    - `insertedDate` string, date-time
    - `publishDate` string, date-time
    - `validityDate` string, date-time
    - `paymentDate` string, date-time
    - `status` 'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'
    - `lastUpdatedDate` string, date-time
    - `paymentOption` PaymentOptionModelResponse[]
      - `nav` string
      - `iuv` string
      - `organizationFiscalCode` string
      - `amount` integer
      - `description` string
      - `isPartialPayment` boolean
      - `dueDate` string, date-time
      - `retentionDate` string, date-time
      - `paymentDate` string, date-time
      - `reportingDate` string, date-time
      - `insertedDate` string, date-time
      - `paymentMethod` string
      - `fee` integer
      - `notificationFee` integer
      - `pspCompany` string
      - `idReceipt` string
      - `idFlowReporting` string
      - `status` 'PO_UNPAID' | 'PO_PAID' | 'PO_PARTIALLY_REPORTED' | 'PO_REPORTED'
      - `lastUpdatedDate` string, date-time
      - `paymentOptionMetadata` PaymentOptionMetadataModelResponse[]
        - `key` string
        - `value` string
      - `transfer` TransferModelResponse[]
        - `organizationFiscalCode` string
        - `companyName` string
        - `idTransfer` string
        - `amount` integer
        - `remittanceInformation` string
        - `category` string
        - `iban` string
        - `postalIban` string
        - `stamp` Stamp
          - `hashDocument` string, required — Document hash type is stBase64Binary72 as described in https://github.com/pagopa/pagopa-api.
          - `stampType` string, required — The type of the stamp
          - `provincialResidence` string, required — The provincial of the residence
        - `insertedDate` string, date-time
        - `status` 'T_UNREPORTED' | 'T_REPORTED'
        - `lastUpdatedDate` string, date-time
        - `transferMetadata` TransferMetadataModelResponse[]
          - `key` string
          - `value` string
  - `page_info` PageInfo, required
    - `page` integer, required — Page number
    - `limit` integer, required — Required number of items per page
    - `items_found` integer, required — Number of items found. (The last page may have fewer elements than required)
    - `total_pages` integer, required — Total number of pages

## Other responses

- `400` — Malformed request.
- `401` — Wrong or missing function key.
- `403` — Forbidden
- `429` — Too many requests.
- `500` — Service unavailable.

## Changes

- **2025-11-07** `228ced2f0bd5` — 2 info
  - the endpoint scheme security `Authorization` was removed from the API
  - added the non-success response with the status `403`
- **2024-11-22** `40898e9a8f8b` — 2 breaking, 2 warning, 2 info
  - for the `query` request parameter `limit`, default value was changed from `50` to `10`
  - for the `query` request parameter `limit`, the max was decreased from `100.00` to `50.00`
  - removed the optional property `payment_position_list/items/aca` from the response with the `200` status
  - removed the optional property `payment_position_list/items/payStandIn` from the response with the `200` status
  - …2 more
- **2024-04-29** `cb518d74c601` — 2 info
  - the `aca` response's property default value `false` was added for the status `200`
  - the `payStandIn` response's property default value `true` was added for the status `200`
- **2024-04-29** `4932550bd41b` — 2 info
  - added the optional property `payment_position_list/items/aca` to the response with the `200` status
  - added the optional property `payment_position_list/items/payStandIn` to the response with the `200` status
- **2024-03-22** `ce68c38c9d45` — 1 breaking
  - for the `query` request parameter `orderby`, default value was changed from `COMPANY_NAME` to `INSERTED_DATE`

[Change history](https://skmtc.dev/pagopa/apis/pagopa-api-debt-position/changes/organizations/:organizationfiscalcode/debtpositions/get.md)

---

[API](https://skmtc.dev/pagopa/apis/pagopa-api-debt-position.md) · [All operations](https://skmtc.dev/pagopa/apis/pagopa-api-debt-position/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pagopa/pagopa-api-debt-position/revisions/a54f9d0b71c6/schema)