`parameter_invalid`

parameter_invalid

Description

The request contains at least one parameter with an invalid value, type, or format.

HTTP Status

400 Bad Request

`doc_url` Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/parameter_invalid

Typical Causes

A field has an unsupported enum value (for example method: "CASH").
A field format is invalid (for example an invalid UUID or date format).
A field value does not satisfy schema constraints.
On POST /v1/support/subscribers/{subscriberId}/requests, subscriberId is not a valid UUID.
On POST /v1/support/subscribers/{subscriberId}/requests, message is missing, empty after trimming, or longer than 5000 characters.
On POST /v1/support/subscribers/{subscriberId}/requests, the request body is malformed JSON or not application/json.
On GET /v1/billing/commissions, page is not a positive integer, perPage is outside 1–100, or type is not inducement or business-commission.
On GET /v1/billing/commissions/{commissionId}/download, commissionId is not a valid UUID.
On POST /v1/total-surrender/policies/{policyId}/declarations, policyId is not a valid UUID, reason is not client-request, regulatory, or compliance, or requestedAt is not a valid ISO date (YYYY-MM-DD).
On POST /v1/total-surrender/policies/{policyId}/declarations, the request body is malformed JSON or not application/json.
On GET /v1/total-surrender/policies/{policyId}/declarations/{declarationId}, policyId or declarationId is not a valid UUID.
On POST /v1/partial-surrender/policies/{policyId}/compartments/{compartmentId}/declarations, policyId or compartmentId is not a valid UUID, amount is missing or invalid, amount.value or amount.scale is not positive, amount.currency is not EUR, or requestedAt is missing or not a valid ISO date (YYYY-MM-DD).
On POST /v1/partial-surrender/policies/{policyId}/compartments/{compartmentId}/declarations, the request body is malformed JSON or not application/json.
On GET /v1/partial-surrender/policies/{policyId}/compartments/{compartmentId}/declarations/{declarationId}, policyId, compartmentId, or declarationId is not a valid UUID.
On GET /v1/death-settlement/policies/{policyId}/standard-beneficiary-designations, policyId is not a valid UUID.
On GET /v1/death-settlement/policies/{policyId}/beneficiary-designation, policyId is not a valid UUID.
On PUT /v1/death-settlement/policies/{policyId}/beneficiary-designation, policyId is not a valid UUID, kind is not standard-designation or custom-designation, standardDesignationId is missing or blank when kind is standard-designation, or text is missing or blank when kind is custom-designation.
On PUT /v1/death-settlement/policies/{policyId}/beneficiary-designation, the request body is malformed JSON or not application/json.
On POST /v1/pay-out/subscribers/{subscriberId}/ibans, subscriberId is not a valid UUID or iban is missing or blank.
On POST /v1/pay-out/subscribers/{subscriberId}/ibans, the request body is malformed JSON or not application/json.
On PATCH /v1/pay-out/subscribers/{subscriberId}/ibans/{iban}/make-default, subscriberId is not a valid UUID or iban is blank.
On POST /v1/user-feedback, comment is missing, empty after trimming, or longer than 2000 characters.
On POST /v1/user-feedback, path is missing, does not start with /, or contains invalid URL path characters.
On POST /v1/user-feedback, the request body is malformed JSON or not application/json.
On POST /v1/subscription/subscribers, name, birth, nationality, taxClassification, address, or email is invalid, or the request body is malformed JSON or not application/json.
On POST /v1/subscription/insurees, name or birth is invalid, or the request body is malformed JSON or not application/json.
On POST /v1/subscription/subscribers/{subscriberId}/subscriptions, subscriberId, productId, or insureeId is not a valid UUID, or the request body is malformed JSON or not application/json.
On POST /v1/subscription/subscriptions/{subscriptionId}/documents, subscriptionId is not a valid UUID, kind is invalid, the uploaded file is missing, empty, or not a PDF, or the multipart form data is malformed.
On DELETE /v1/subscription/subscriptions/{subscriptionId}/documents/{kind}, subscriptionId is not a valid UUID or kind is invalid.
On GET /v1/subscription/subscriptions/{subscriptionId}/form, subscriptionId is not a valid UUID.
On POST /v1/subscription/subscriptions/{subscriptionId}/signed-form, subscriptionId is not a valid UUID, the uploaded file is missing, empty, or not a PDF, or the multipart form data is malformed.
On POST /v1/subscription/subscriptions/{subscriptionId}/e-signing-requests, subscriptionId is not a valid UUID.
On POST /v1/subscription/subscriptions/{subscriptionId}/withdraw, subscriptionId is not a valid UUID.
On compartment-lifecycle endpoints, a path parameter such as policyId, managerId, or compartmentId is not a valid UUID.
On POST /v1/compartment-lifecycle/discretionary-managers, name is missing or blank, or the request body is malformed JSON or not application/json.
On POST /v1/compartment-lifecycle/discretionary-managers/{managerId}/mandates, name or riskLevel is missing or blank, managerId is not a valid UUID, or the request body is malformed JSON or not application/json.
On GET /v1/compartment-lifecycle/mandates, page is not a positive integer, perPage is outside 1-100, managerId is not a valid UUID, or riskLevel is not one of the supported values.
On POST /v1/compartment-lifecycle/policies/{policyId}/compartments, managementMode or name is missing or blank, mandateId is not a valid UUID, or the request body is malformed JSON or not application/json.
On GET /v1/compartment-lifecycle/policies/{policyId}/compartments, policyId is not a valid UUID, page is not a positive integer, or perPage is outside 1-100.
On GET, PATCH, or DELETE /v1/compartment-lifecycle/compartments/{compartmentId}, compartmentId is not a valid UUID.
On PATCH /v1/compartment-lifecycle/compartments/{compartmentId}, the body is empty, contains an invalid mandateId, combines managementMode: "self-invested" with mandateId, omits mandateId for managementMode: "discretionary-management", or is malformed JSON / not application/json.
On PUT /v1/compartment-lifecycle/compartments/{compartmentId}/delegation, compartmentId or mandateId is not a valid UUID, or the request body is malformed JSON or not application/json.
On POST /v1/compartment-lifecycle/compartments/{compartmentId}/transfers, compartmentId or targetCompartmentId is not a valid UUID, amount or funds has an invalid shape, required transfer details for the source management mode are missing, or the request body is malformed JSON or not application/json.

Example

Request:

http

POST /v1/premium-scheduling/single-premium-requests
Content-Type: application/json

{
  "policyId": "8f68c04d-42b6-4375-bec9-1dcf0ff0f385",
  "payerId": "4b7f6518-c699-4d8f-ad6d-f8ff9bf25ed8",
  "method": "CASH",
  "amount": { "value": 100, "currency": "EUR" },
  "iban": "FR7630006000011234567890189"
}

Support Example

Request:

http

POST /v1/support/subscribers/not-a-uuid/requests
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "message": "Need support."
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: subscriberId - Invalid UUID ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Billing Example

Request:

http

GET /v1/billing/commissions?page=0&type=bonus
Authorization: Bearer <access-token>

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: page - Too small: expected number to be >0 ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Total Surrender Example

Request:

http

POST /v1/total-surrender/policies/8f68c04d-42b6-4375-bec9-1dcf0ff0f385/declarations
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "reason": "unknown-reason",
  "requestedAt": "2026-05-15"
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: reason - Invalid option: expected one of \"client-request\"|\"regulatory\"|\"compliance\" ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Partial Surrender Example

Request:

http

POST /v1/partial-surrender/policies/8f68c04d-42b6-4375-bec9-1dcf0ff0f385/compartments/4b7f6518-c699-4d8f-ad6d-f8ff9bf25ed8/declarations
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "amount": {
    "value": 0,
    "scale": 2,
    "currency": "EUR"
  },
  "requestedAt": "2026-05-15"
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: amount.value - Too small: expected number to be >0 ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Death Settlement Example

Request:

http

GET /v1/death-settlement/policies/not-a-uuid/beneficiary-designation
Authorization: Bearer <access-token>

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: policyId - Invalid UUID ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Pay-Out Example

Request:

http

POST /v1/pay-out/subscribers/not-a-uuid/ibans
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "iban": "FR7630006000011234567890189"
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: subscriberId - Invalid UUID ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

User Feedback Example

Request:

http

POST /v1/user-feedback
Content-Type: application/json

{
  "comment": "   ",
  "path": "dashboard"
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: comment - Too small: expected string to have >=1 characters ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

Subscription Example

Request:

http

POST /v1/subscription/subscribers/not-a-uuid/subscriptions
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "productId": "73000000-0000-4000-8000-000000000001",
  "insureeId": "72000000-0000-4000-8000-000000000001"
}

Response:

json

{
  "errors": [
    {
      "code": "parameter_invalid",
      "message": "Param: subscriberId - Invalid UUID ",
      "doc_url": "https://docs.example.com/errors/parameter_invalid"
    }
  ]
}

How To Fix

Inspect the message field in the API response to identify the invalid parameter.
Correct the request payload according to the endpoint schema in the API reference.
Retry the request.

parameter_invalid ​

Description ​

HTTP Status ​

doc_url Format ​

Typical Causes ​

Example ​

Support Example ​

Billing Example ​

Total Surrender Example ​

Partial Surrender Example ​

Death Settlement Example ​

Pay-Out Example ​

User Feedback Example ​

Subscription Example ​

How To Fix ​

`parameter_invalid`

Description

HTTP Status

`doc_url` Format

Typical Causes

Example

Support Example

Billing Example

Total Surrender Example

Partial Surrender Example

Death Settlement Example

Pay-Out Example

User Feedback Example

Subscription Example

How To Fix