# Monitoring - One Platform Organizations Integration API

Monitoring - Public endpoints to integrate Organization with One Platform

Version: v1

## Security

### OpenIdConnect

Type: oauth2
Token URL: https://auth-preprod.namirial.app/realms/namirial/protocol/openid-connect/token
Scopes:

### BasicAuthentication

Type: http
Scheme: Basic

## Download OpenAPI description

 - [Monitoring - One Platform Organizations Integration API](https://docs.namirial.app/_bundle/@l10n/it/products/oneplatform/apis/oas/organizations.yaml)

## Consumptions

 - [GET /v1/organizations/{id}/consumptions-aggregated/consumers/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumptions/get_v1_organizations_id_consumptions-aggregated_consumers_consumerid.md): Security policies: OrganizationsConsumptionsView
 - [GET /v1/organizations/{id}/consumptions-aggregated/business-relations/{businessRelationId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumptions/get_v1_organizations_id_consumptions-aggregated_business-relations_businessrelationid.md): Security policies: OrganizationsConsumptionsView
 - [GET /v1/organizations/{id}/consumptions/latest](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumptions/get_v1_organizations_id_consumptions_latest.md): It will return the latest consumptions for a business relation using query filtersSecurity policies: OrganizationsConsumptionsView
## Business Relations

 - [GET /v1/organizations/{id}/business-relations](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/business-relations/get_v1_organizations_id_business-relations.md): Security policies: OrganizationOrGlobalBusinessRelationView
 - [GET /v1/organizations/{id}/business-relations/consumer-paths/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/business-relations/get_v1_organizations_id_business-relations_consumer-paths_consumerid.md): Security policies: OrganizationsBusinessRelationsConsumerPathsView
 - [GET /v1/organizations/{id}/business-relations/consumer-path-items](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/business-relations/get_v1_organizations_id_business-relations_consumer-path-items.md): Security policies: OrganizationsBusinessRelationsConsumerPathsView
 - [GET /v1/organizations/{id}/business-relations/contracts-consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/business-relations/get_v1_organizations_id_business-relations_contracts-consumers.md): Security policies: OrganizationOrGlobalContractView
## Consumers

 - [GET /v2/organizations/{id}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v2_organizations_id_consumers.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [POST /v2/organizations/{id}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/post_v2_organizations_id_consumers.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [GET /v2/organizations/{id}/consumers/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v2_organizations_id_consumers_consumerid.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [PUT /v2/organizations/{id}/consumers/{consumerId}/general-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v2_organizations_id_consumers_consumerid_general-infos.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/birth-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_birth-infos.md): Security policies: OrganizationsConsumersBirthInfoEdit
 - [PUT /v2/organizations/{id}/consumers/{consumerId}/residence-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v2_organizations_id_consumers_consumerid_residence-infos.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/billing-details](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_billing-details.md): Security policies: OrganizationsConsumersBillingDetailsEdit, OrganizationsConsumersContactInfosEdit
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/contact-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_contact-infos.md): Security policies: OrganizationsConsumersContactInfosEdit
 - [PUT /v2/organizations/{id}/consumers/{consumerId}/tax-details](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v2_organizations_id_consumers_consumerid_tax-details.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/additional-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_additional-infos.md): Security policies: OrganizationsConsumersAdditionalInfosEdit
 - [GET /v1/organizations/{id}/consumers/{consumerId}/users](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v1_organizations_id_consumers_consumerid_users.md): Security policies: OrganizationsConsumerDetailsView
 - [GET /v2/organizations/{id}/contracts/{contractId}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v2_organizations_id_contracts_contractid_consumers.md): ⚠️ UNSTABLE ENDPOINT — This v2 endpoint is under active development. The contract (fields, request/response structure, behavior) may change without notice. All integrations consuming this endpoint mus
 - [GET /v1/organizations/{id}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v1_organizations_id_consumers.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API GET '/v2/organizations/{id}/consumers' instead.Security policies: OrganizationsConsumersView
 - [POST /v1/organizations/{id}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/post_v1_organizations_id_consumers.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API POST '/v2/organizations/{id}/consumers' instead.Security policies: OrganizationsConsumersCreate
 - [GET /v1/organizations/{id}/consumers/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v1_organizations_id_consumers_consumerid.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API GET '/v2/organizations/{id}/consumers/{consumerId}' instead.Security policies: OrganizationsConsumerDetailsView
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/general-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_general-infos.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-07-01, use API PUT '/v2/organizations/{id}/consumers/{consumerId}/general-infos' instead.Security policies: OrganizationsConsumersG
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/residence-infos](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_residence-infos.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API PUT '/v2/organizations/{id}/consumers/{consumerId}/residence-infos' instead.Security policies: OrganizationsConsumer
 - [PUT /v1/organizations/{id}/consumers/{consumerId}/tax-details](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/put_v1_organizations_id_consumers_consumerid_tax-details.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API PUT '/v2/organizations/{id}/consumers/{consumerId}/tax-details' instead.Security policies: OrganizationsConsumersTax
 - [GET /v1/organizations/{id}/contracts/{contractId}/consumers](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/consumers/get_v1_organizations_id_contracts_contractid_consumers.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2027-06-01, use API GET '/v2/contracts/{contractId}/consumers' instead.⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2
## Contract Items

 - [GET /v1/organizations/{id}/contract-item-rules](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_contract-item-rules.md): Security policies: OrganizationOrGlobalContractView
 - [GET /v1/organizations/{id}/contracts/{contractId}/contract-item-rules](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_contracts_contractid_contract-item-rules.md): Security policies: OrganizationOrGlobalContractView
 - [POST /v1/organizations/{id}/contracts/{contractId}/contract-items](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/post_v1_organizations_id_contracts_contractid_contract-items.md): Security policies: OrganizationOrGlobalContractCreate
 - [GET /v1/organizations/{id}/contracts/{contractId}/contract-items](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_contracts_contractid_contract-items.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [GET /v1/organizations/{id}/contract-items/{contractItemId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_contract-items_contractitemid.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid.md): Security policies: OrganizationOrGlobalContractEdit
 - [DELETE /v1/organizations/{id}/contract-items/{contractItemId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/delete_v1_organizations_id_contract-items_contractitemid.md): Contract items cannot be deleted once the contract they belong to has been signedSecurity policies: OrganizationOrGlobalContractEdit
 - [GET /v1/organizations/{id}/contract-items/{contractItemId}/onboarding-info](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_contract-items_contractitemid_onboarding-info.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/billing-model-parameters](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_billing-model-parameters.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/sku-parameters](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_sku-parameters.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/end-date](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_end-date.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/user-id](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_user-id.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/subscription-id](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_subscription-id.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/status/active](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_status_active.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/provisioning-dry-run](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_provisioning-dry-run.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [PUT /v1/organizations/{id}/contract-items/{contractItemId}/status/expired](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/put_v1_organizations_id_contract-items_contractitemid_status_expired.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2026-12-01.Security policies: OrganizationOrGlobalContractEdit
 - [GET /v1/organizations/{id}/consumers/{consumerId}/contracts/{contractId}/contract-items](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_consumers_consumerid_contracts_contractid_contract-items.md): 🗑️ DEPRECATED (Will no longer be available in the next release) 🗑️: This API is DEPRECATED and will be removed on 2026-04-01, use API GET '/v1/organizations/{id}/contracts/{contractId}/contract-item
 - [GET /v1/organizations/{id}/consumers/{consumerId}/contract-items/{contractItemId}/signed-doc](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contract-items/get_v1_organizations_id_consumers_consumerid_contract-items_contractitemid_signed-doc.md): 🗑️ DEPRECATED (Will no longer be available in the next release) 🗑️: This API is DEPRECATED and will be removed on 2026-04-01, use API GET '/v1/organizations/{id}/contract-items/{contractItemId}/sign
## Contracts

 - [GET /v1/organizations/{id}/contracts](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/get_v1_organizations_id_contracts.md): Security policies: OrganizationOrGlobalContractView
 - [POST /v1/organizations/{id}/contracts](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/post_v1_organizations_id_contracts.md): Security policies: OrganizationOrGlobalContractCreate
 - [GET /v1/organizations/{id}/contracts/{contractId}/service-activation-group](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/get_v1_organizations_id_contracts_contractid_service-activation-group.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [GET /v1/organizations/{id}/contracts/{contractId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/get_v1_organizations_id_contracts_contractid.md): Security policies: OrganizationContractOrGlobalContractDetailsView
 - [PUT /v1/organizations/{id}/contracts/{contractId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/put_v1_organizations_id_contracts_contractid.md): Security policies: OrganizationOrGlobalContractEdit
 - [DELETE /v1/organizations/{id}/contracts/{contractId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/delete_v1_organizations_id_contracts_contractid.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contracts/{contractId}/status/final](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/put_v1_organizations_id_contracts_contractid_status_final.md): The main requirement to go in "Final" status is to be in “Draft” status and not have any "Pending" itemsSecurity policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contracts/{contractId}/status/expired](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/put_v1_organizations_id_contracts_contractid_status_expired.md): The contract must be in Completed statusSecurity policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/contracts/{contractId}/end-date](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/put_v1_organizations_id_contracts_contractid_end-date.md): 🗑️ DEPRECATED (Will no longer be available in the next release) 🗑️: This API is DEPRECATED and will be removed on 2026-05-01. Reason: The end date of a contract has been removed. It doesn't do anyth
 - [GET /v1/organizations/{id}/consumers/{consumerId}/contracts](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/get_v1_organizations_id_consumers_consumerid_contracts.md): 🗑️ DEPRECATED (Will no longer be available in the next release) 🗑️: This API is DEPRECATED and will be removed on 2026-04-01, use API GET '/v1/organizations/{id}/contracts' instead.Security policies
 - [GET /v1/organizations/{id}/consumers/{consumerId}/contracts/{contractId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/get_v1_organizations_id_consumers_consumerid_contracts_contractid.md): 🗑️ DEPRECATED (Will no longer be available in the next release) 🗑️: This API is DEPRECATED and will be removed on 2026-04-01, use API GET '/v1/organizations/{id}/contracts/{contractId}' instead.Secu
 - [PUT /v1/organizations/{id}/contracts/{contractId}/status/pending](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/contracts/put_v1_organizations_id_contracts_contractid_status_pending.md): ⚠️ DEPRECATED ⚠️: This API is DEPRECATED and will be removed on 2026-11-01, use API PUT '/v1/contracts/{contractId}/status/final' instead.Security policies: OrganizationOrGlobalContractEdit
## Counters

 - [GET /v1/organizations/{id}/counters-aggregated/consumers/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/counters/get_v1_organizations_id_counters-aggregated_consumers_consumerid.md): Security policies: OrganizationsCountersView
## Product Metrics

 - [GET /v1/organizations/{id}/product-metrics/consumers/{consumerId}](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/product-metrics/get_v1_organizations_id_product-metrics_consumers_consumerid.md): Security policies: OrganizationsMetricsView
## Service Activation Groups

 - [PUT /v1/organizations/{id}/service-activation-groups/{serviceActivationGroupId}/confirm](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/service-activation-groups/put_v1_organizations_id_service-activation-groups_serviceactivationgroupid_confirm.md): Security policies: OrganizationOrGlobalContractEditByOrganization
 - [POST /v1/organizations/{id}/service-activation-groups](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/service-activation-groups/post_v1_organizations_id_service-activation-groups.md): Security policies: OrganizationOrGlobalContractCreate
 - [PUT /v1/organizations/{id}/service-activation-groups/{serviceActivationGroupId}/add-contracts](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/service-activation-groups/put_v1_organizations_id_service-activation-groups_serviceactivationgroupid_add-contracts.md): Security policies: OrganizationOrGlobalContractEdit
 - [PUT /v1/organizations/{id}/service-activation-groups/{serviceActivationGroupId}/remove-contracts](https://docs.namirial.app/it/products/oneplatform/apis/oas/organizations/service-activation-groups/put_v1_organizations_id_service-activation-groups_serviceactivationgroupid_remove-contracts.md): Security policies: OrganizationOrGlobalContractEdit
