# PagoPA Agreements API

**Canonical:** https://apis.io/apis/pagopa/pagopa-agreements-api/  
**Provider:** PagoPA — https://apis.io/providers/pagopa/  
**Base URL:** https://api.platform.pagopa.it/bizevents/service/v1  
**Documentation:** https://developer.pagopa.it/it/pago-pa/api/recupero-receipt

PagoPA Agreements API is one of 83 APIs that [PagoPA](https://apis.io/providers/pagopa/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 96 JSON Schema definitions. Tagged areas include agreements. The published artifact set on APIs.io includes an OpenAPI specification and 96 JSON Schemas.

Agreements routes

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/agreements` | List Agreements |
| POST | `/agreements` | Create a new Agreement |
| GET | `/agreements/{agreementId}` | Retrieve an Agreement |
| DELETE | `/agreements/{agreementId}` | Delete an Agreement |
| GET | `/agreements/{agreementId}/purposes` | List Purposes for an Agreement |
| POST | `/agreements/{agreementId}/approve` | Approve an Agreement in Pending state |
| POST | `/agreements/{agreementId}/reject` | Reject an Agreement in Pending state |
| POST | `/agreements/{agreementId}/archive` | Archive an Agreement in Active or Suspended state |
| POST | `/agreements/{agreementId}/submit` | Submit an Agreement in Draft state |
| POST | `/agreements/{agreementId}/suspend` | Suspend an Agreement in Active or Suspended state |
| POST | `/agreements/{agreementId}/unsuspend` | Unsuspend an Agreement in Suspended state |
| POST | `/agreements/{agreementId}/upgrade` | Upgrade an Agreement |
| POST | `/agreements/{agreementId}/clone` | Clone an Agreement |
| POST | `/agreements/{agreementId}/consumerDocuments` | Upload an Agreement Consumer Document |
| GET | `/agreements/{agreementId}/consumerDocuments` | List Agreement Consumer Documents |
| GET | `/agreements/{agreementId}/consumerDocuments/{documentId}` | Download an Agreement Consumer Document |
| DELETE | `/agreements/{agreementId}/consumerDocuments/{documentId}` | Delete an Agreement Consumer Document |
| GET | `/agreements/{agreementId}/contract` | Download Agreement Consumer Contract |

## Machine-readable artifacts (97)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/openapi/pagopa-agreements-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-ct-receipt-model-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-cart-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-get-cart-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-get-mbd-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-get-mdb-receipt-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-create-mbd-request-v2-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-single-flow-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-paginated-payments-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-paginated-flows-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-create-flow-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-single-flow-created-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-paginated-flows-published-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-paginated-flows-created-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-position-model-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payments-model-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-position-model-base-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-positions-info-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-app-info-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-already-paid-payment-option-model-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-file-id-list-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-upload-report-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-upload-status-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-update-transfer-iban-massive-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-position-model-v3-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-position-model-response-v3-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-positions-info-v3-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-flow-list-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-upload-report-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-receipts-info-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-broker-institutions-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-ciibans-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-payment-options-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-new-debt-position-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-debt-position-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-get-generation-request-status-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-template-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-notice-generation-request-item-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-notice-generation-massive-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagopa/refs/heads/main/json-schema/pagopa-notice-generation-massive-resource-schema.json
- …and 57 more, listed in full on the page.

## Other PagoPA APIs (12)

- [pagoPA - Nodo dei Pagamenti SOAP interfaces](https://apis.io/apis/pagopa/pagopa-nodo-dei-pagamenti-soap-interfaces/)
- [PagoPA ACA API](https://apis.io/apis/pagopa/pagopa-aca-api/)
- [PagoPA Activations API](https://apis.io/apis/pagopa/pagopa-activations-api/)
- [PagoPA Attributes API](https://apis.io/apis/pagopa/pagopa-attributes-api/)
- [PagoPA b2b - pagoPA side API](https://apis.io/apis/pagopa/pagopa-b2b-pagopa-side-api/)
- [PagoPA Callback API](https://apis.io/apis/pagopa/pagopa-callback-api/)
- [PagoPA Callback Cancel API](https://apis.io/apis/pagopa/pagopa-callback-cancel-api/)
- [PagoPA Carts API](https://apis.io/apis/pagopa/pagopa-carts-api/)
- [PagoPA Check API](https://apis.io/apis/pagopa/pagopa-check-api/)
- [PagoPA Citizen operation API](https://apis.io/apis/pagopa/pagopa-citizen-operation-api/)
- [PagoPA Clients API](https://apis.io/apis/pagopa/pagopa-clients-api/)
- [PagoPA Create API](https://apis.io/apis/pagopa/pagopa-create-api/)

## Tags

agreements

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pagopa/pagopa-agreements-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pagopa/.