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

# Update an insurance contract

`PATCH /v2/insurance_contracts/{id}`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/insurance_contracts/{id}`
- Auth: OAuth 2
  - Authorization code: `https://oauth.qonto.com/oauth2/auth`
  - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `insurance_contract.write`

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.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)