---
title: "invalid_request_parameter"
description: "Error cause: invalid_request_parameter"
canonical: "https://studio.inttegro.dev/e/c-invalid_request_parameter"
format: inttegro-machine-docs/v1
language: "cURL"
reader_profile: optional
reader_manifest: "https://studio.inttegro.dev/machine/curl/readers/index.json"
reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations."
preamble_estimated_tokens: 358
model_token_report: "https://studio.inttegro.dev/machine/token-report.json"
preamble_questions: 5
preamble_source: "general"
recommended_mcp_tools: []
estimated_tokens: 1043
token_estimate_method: "utf8_bytes_divided_by_4"
---

## Machine preamble

**Summary:** Error cause: invalid_request_parameter This cURL representation preserves HTTP paths and JSON wire names.

### Five questions

#### Q1. When should the reader use invalid_request_parameter?

Use this page as orientation before selecting the narrower guide or reference that owns the implementation contract.

#### Q2. What is authoritative on this page?

Use this page for orientation; follow its canonical SDK, guide, API, or MCP links for exact contracts.

#### Q3. What page-specific constraint matters most?

Use the page to choose a canonical next source instead of treating summary material as a complete implementation contract.

#### Q4. Can Inttegro MCP materially help with this task?

No catalog ability is sufficiently specific to recommend for this page. Use the documentation directly; consult the MCP catalog only if the task later requires governed live account context or a supported operation.

#### Q5. How should the reader verify the answer and continue?

Select the narrowest linked guide or reference, apply its stated completion condition, and verify against authoritative resource state when the task changes data. Continue with [missing_request_parameter](https://studio.inttegro.dev/machine/curl/e/c-missing_request_parameter.md) and [change_request_parameters](https://studio.inttegro.dev/machine/curl/e/f-change_request_parameters.md) when those concerns enter scope.

## Document content

# invalid\_request\_parameter

Error cause indicating one or more request parameters contain invalid values that violate format, type, or business logic constraints.

## What this means

The parameter you provided exists in your request and is recognized by the Inttegro API, but its value doesn't meet the endpoint's validation requirements. This is the most common error cause you'll encounter during integration. Validation failures can occur for many reasons: the value is out of the acceptable range (like `page_number: 50` when the maximum is 10), the format is incorrect (a malformed email address or invalid currency code), the type doesn't match expectations (providing a string where an integer is required), or the value violates business logic (attempting to pay an order that's already completed).

For example, scheduling a payout with `currency: "XYZ"` where XYZ isn't a supported currency code, or paying for an order with a `payment_method_id` that has been deleted. The error detail field provides specific information about what's wrong with the parameter and what constraints it violated, enabling you to correct the value and retry successfully.

## Example error response

```json
{
  "error": {
    "type": "invalid_request_parameter",
    "cause": "invalid_request_parameter",
    "code": "1528",
    "message": "payment method not found",
    "detail": "The payment method `pm_xyz789` was not found. Verify the payment_method_id is correct.",
    "fix_code": "change_request_parameters",
    "url": "https://studio.inttegro.com/e/1528"
  }
}
```

## Related errors

- [invalid\_request\_parameter](https://studio.inttegro.dev/machine/curl/e/t-invalid_request_parameter.md) - Error type for this cause
- [change\_request\_parameters](https://studio.inttegro.dev/machine/curl/e/f-change_request_parameters.md) - How to fix
- [missing\_request\_parameter](https://studio.inttegro.dev/machine/curl/e/c-missing_request_parameter.md) - Related validation issue