---
title: "The Organization creates a debt Position."
method: POST
path: "/organizations/{organizationfiscalcode}/debtpositions"
tags: ["Debt Positions API"]
---

# The Organization creates a debt Position.

`POST /organizations/{organizationfiscalcode}/debtpositions`

## Path parameters

- `organizationfiscalcode` string, required

## Query parameters

- `toPublish` boolean

## Request body

- PaymentPositionModel
  - `iupd` string, required
  - `type` 'F' | 'G', required
  - `payStandIn` boolean — feature flag to enable a debt position in stand-in mode
  - `fiscalCode` string, required
  - `fullName` string, required
  - `streetName` string
  - `civicNumber` string
  - `postalCode` string
  - `city` string
  - `province` string
  - `region` string
  - `country` string
  - `email` string
  - `phone` string
  - `switchToExpired` boolean, required — feature flag to enable the debt position to expire after the due date
  - `companyName` string, required
  - `officeName` string
  - `validityDate` string, date-time
  - `paymentDate` string, date-time
  - `status` 'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'
  - `paymentOption` PaymentOptionModel[]
    - `nav` string
    - `iuv` string, required
    - `amount` integer, required
    - `description` string, required
    - `isPartialPayment` boolean, required
    - `dueDate` string, date-time, required
    - `retentionDate` string, date-time
    - `fee` integer
    - `notificationFee` integer
    - `transfer` TransferModel[]
      - `idTransfer` '1' | '2' | '3' | '4' | '5', required
      - `amount` integer, required
      - `organizationFiscalCode` string — Fiscal code related to the organization targeted by this transfer.
      - `remittanceInformation` string, required
      - `category` string, required
      - `iban` string — mutual exclusive with stamp
      - `postalIban` string — optional - can be combined with iban but not with stamp
      - `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
      - `companyName` string
      - `transferMetadata` TransferMetadataModel[] — it can added a maximum of 10 key-value pairs for metadata
        - `key` string, required
        - `value` string, required
    - `paymentOptionMetadata` PaymentOptionMetadataModel[] — it can added a maximum of 10 key-value pairs for metadata
      - `key` string, required
      - `value` string, required

## Response `201`

Request created.

- PaymentPositionModel
  - `iupd` string, required
  - `type` 'F' | 'G', required
  - `payStandIn` boolean — feature flag to enable a debt position in stand-in mode
  - `fiscalCode` string, required
  - `fullName` string, required
  - `streetName` string
  - `civicNumber` string
  - `postalCode` string
  - `city` string
  - `province` string
  - `region` string
  - `country` string
  - `email` string
  - `phone` string
  - `switchToExpired` boolean, required — feature flag to enable the debt position to expire after the due date
  - `companyName` string, required
  - `officeName` string
  - `validityDate` string, date-time
  - `paymentDate` string, date-time
  - `status` 'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'
  - `paymentOption` PaymentOptionModel[]
    - `nav` string
    - `iuv` string, required
    - `amount` integer, required
    - `description` string, required
    - `isPartialPayment` boolean, required
    - `dueDate` string, date-time, required
    - `retentionDate` string, date-time
    - `fee` integer
    - `notificationFee` integer
    - `transfer` TransferModel[]
      - `idTransfer` '1' | '2' | '3' | '4' | '5', required
      - `amount` integer, required
      - `organizationFiscalCode` string — Fiscal code related to the organization targeted by this transfer.
      - `remittanceInformation` string, required
      - `category` string, required
      - `iban` string — mutual exclusive with stamp
      - `postalIban` string — optional - can be combined with iban but not with stamp
      - `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
      - `companyName` string
      - `transferMetadata` TransferMetadataModel[] — it can added a maximum of 10 key-value pairs for metadata
        - `key` string, required
        - `value` string, required
    - `paymentOptionMetadata` PaymentOptionMetadataModel[] — it can added a maximum of 10 key-value pairs for metadata
      - `key` string, required
      - `value` string, required

## Other responses

- `400` — Malformed request.
- `401` — Wrong or missing function key.
- `403` — Forbidden
- `409` — Conflict: duplicate debt position found.
- `500` — Service unavailable.

## Changes

- **2026-02-12** `a54f9d0b71c6` — 6 info
  - the request optional property `paymentOption/items/fee` became read-only
  - the `payStandIn` request property default value changed from `true` to `true`
  - the `switchToExpired` request property default value changed from `false` to `false`
  - the response optional property `paymentOption/items/fee` became read-only for the status `201`
  - …2 more
- **2025-11-07** `228ced2f0bd5` — 6 breaking, 9 warning, 6 info
  - the request property `paymentOption/items/paymentOptionMetadata/items/value` became required
  - the request property `paymentOption/items/transfer/items/transferMetadata/items/value` became required
  - the `paymentOption/items/transfer/items/iban` request property's minLength was increased from `0` to `1`
  - the `paymentOption/items/transfer/items/postalIban` request property's minLength was increased from `0` to `1`
  - …17 more
- **2024-11-22** `40898e9a8f8b` — 3 warning, 2 info
  - the `paymentOption/items/transfer/items/stamp/hashDocument` request property's maxLength was set to `72`
  - removed the request property `aca`
  - removed the optional property `aca` from the response with the `201` status
  - added the new optional request property `paymentOption/items/transfer/items/companyName`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/pagopa/apis/pagopa-api-debt-position/changes/organizations/:organizationfiscalcode/debtpositions/post.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)