v2

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-245593419.2 KB
Insurance Contracts

Update an insurance contract

OAuth scope: insurance_contract.write


This endpoint allows you to update an existing insurance contract by its ID.

patch/v2/insurance_contracts/{id}

Path parameters

idstring required

UUID of the insurance contract to update

Headers

X-Qonto-Staging-Tokenstring

Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.

Request body

Example request

{
  "insurance_contract": {
    "name": "ProLiability Plan 2024",
    "contract_id": "12345",
    "origin": "insurance_hub",
    "provider_slug": "axa",
    "type": "business_liability",
    "status": "active",
    "troubleshooting_url": "https://patner.com/troubleshoot",
    "service_url": "https://partner.com/service",
    "expiration_date": "2025-12-31",
    "start_date": "2024-12-31",
    "renew_date": "2025-12-31",
    "payment_frequency": "month",
    "price": {
      "value": "99.99",
      "currency": "EUR"
    }
  }
}

Response

Returns insurance contract updated

Example response

{
  "insurance_contract": {
    "id": "888e4567-e89b-12d3-a456-426614174123",
    "name": "ProLiability Plan 2024",
    "contract_id": "12345",
    "origin": "insurance_hub",
    "provider_slug": "axa",
    "type": "business_liability",
    "status": "active",
    "troubleshooting_url": "https://patner.com/troubleshoot",
    "service_url": "https://partner.com/service",
    "expiration_date": "2025-12-31",
    "start_date": "2024-12-31",
    "renew_date": "2025-12-31",
    "payment_frequency": "month",
    "price": {
      "value": "99.99",
      "currency": "EUR"
    }
  }
}