---
title: "Update an insurance contract"
method: PATCH
path: "/v2/insurance_contracts/{id}"
tags: ["Insurance Contracts"]
---

# Update an insurance contract

`PATCH /v2/insurance_contracts/{id}`

OAuth scope: `insurance_contract.write`

---

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

## Path parameters

- `id` string, required

## Headers

- `X-Qonto-Staging-Token` string

## Request body

- InsuranceContractUpdatePayload
  - `insurance_contract` InsuranceContractPartnerData, required — Insurance contract data provided by Partner
    - `name` string — Name of the insurance contract signed by the customer
    - `contract_id` string — ID of the contract created by partner
    - `origin` 'insurance_hub' | 'qonto_other' | 'stello' — Insurance contract origin
    - `provider_slug` string — Identifier representing insurance provider
    - `type` string — Defined category of insurance taken by the customer
    - `status` 'active' | 'pending_payment' | 'pending_others' | 'action_required' | 'expired' | 'archived' — Insurance contract status
    - `troubleshooting_url` string — Link for troubleshooting when contract status is not active
    - `service_url` string — Static link for customer to access their insurance management portal
    - `expiration_date` string, date — Date when the contract terminates unless it is renewed
    - `start_date` string — Date when the insurance contract becomes active and coverage begins
    - `renew_date` string — Date when the policy is scheduled for renewal
    - `payment_frequency` 'month' | 'quarter' | 'annual' — Payment frequency
    - `price` object — Price of the insurance
      - `value` string
      - `currency` string

## Response `200`

Returns insurance contract updated

- InsuranceContract
  - `insurance_contract` object, required — Insurance contract data provided by Partner
    - `id` string — UUID of the insurance contract
    - `name` string — Name of the insurance contract signed by the customer
    - `contract_id` string — ID of the contract created by partner
    - `origin` 'insurance_hub' | 'qonto_other' | 'stello' — Insurance contract origin
    - `provider_slug` string — Identifier representing insurance provider
    - `type` string — Defined category of insurance taken by the customer
    - `status` 'active' | 'pending_payment' | 'pending_others' | 'action_required' | 'expired' | 'archived' — Insurance contract status
    - `troubleshooting_url` string — Link for troubleshooting when contract status is not active
    - `service_url` string — Static link for customer to access their insurance management portal
    - `expiration_date` string, date — Date when the contract terminates unless it is renewed
    - `start_date` string — Date when the insurance contract becomes active and coverage begins
    - `renew_date` string — Date when the policy is scheduled for renewal
    - `payment_frequency` 'month' | 'quarter' | 'annual' — Payment frequency
    - `price` object — Price of the insurance
      - `value` string
      - `currency` string

## Other responses

- `400` — Returns a bad request error
- `401` — Returns an unauthorized error
- `403` — Returns a forbidden error
- `404` — Returns a not found error

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)