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

# The Organization publish a debt Position.

`POST /organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish`

## Request

- Base URL: `https://api.uat.platform.pagopa.it/gpd/debt-positions-service/v3`
- URL: `https://api.uat.platform.pagopa.it/gpd/debt-positions-service/v3/organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `subscription-key`

The Organization publish a debt Position.

## Path parameters

- `organizationfiscalcode` string, required
- `iupd` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Request published.

- PaymentPositionModelV3
  - `iupd` string, required
  - `payStandIn` boolean: feature flag to enable a debt position in stand-in mode
  - `companyName` string, required
  - `officeName` string
  - `paymentDate` string, date-time
  - `status` 'DRAFT' | 'PUBLISHED' | 'VALID' | 'UNPAYABLE' | 'PARTIALLY_PAID' | 'PAID'
  - `paymentOption` PaymentOptionModelV3[], required
    - `description` string
    - `validityDate` string, date-time
    - `retentionDate` string, date-time
    - `switchToExpired` boolean, required: feature flag to enable the payment option to expire after the due date
    - `debtor` DebtorModel, required
      - `type` 'F' | 'G', required
      - `fiscalCode` string, required
      - `fullName` string, required
      - `streetName` string
      - `civicNumber` string
      - `postalCode` string
      - `city` string
      - `province` string
      - `region` string
      - `country` string
      - `email` string
      - `phone` string
    - `installments` InstallmentModel[], required
      - `nav` string
      - `iuv` string, required
      - `amount` integer, required
      - `description` string, required
      - `dueDate` string, date-time, required
      - `fee` integer
      - `notificationFee` integer
      - `status` 'UNPAID' | 'PAID' | 'PARTIALLY_REPORTED' | 'REPORTED' | 'UNPAYABLE' | 'EXPIRED'
      - `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 be added a maximum of 10 key-value pairs for metadata. Metadata keys must be unique within the same transfer.
          - `key` string, required
          - `value` string, required
      - `installmentMetadata` InstallmentMetadataModel[]: It can be added a maximum of 10 key-value pairs for metadata. Metadata keys must be unique within the same installment.
        - `key` string, required
        - `value` string

## Other responses

- `401`: Wrong or missing function key.
- `403`: Forbidden
- `404`: No debt position found.
- `409`: Conflict: debt position is not in publishable state.
- `500`: Service unavailable.

## Changes

- **2026-09-11** (v3) `6f3db9e68367`: 2 info
  - the endpoint scheme security `ApiKey` was removed from the API
  - added the new optional `header` request parameter `X-Request-Id`
- **2026-02-12** (v3) `93e168e2fe0e`: 1 warning, 4 info
  - deleted the `header` request parameter `X-Request-Id`
  - the endpoint scheme security `ApiKey` was added to the API
  - added the new optional `header` request parameter `X-Request-Id` to all path's operations
  - the `payStandIn` response's property default value changed from `true` to `true` for the status `200`
  - …1 more

[Operation history](https://skmtc.dev/pagopa/apis/pagopa-api-debt-position/changes/organizations/:organizationfiscalcode/debtpositions/:iupd/publish/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.dev/pagopa/apis/pagopa-api-debt-position/revisions/83ccf9921613?raw)