> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.scripe.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Invalid request

# `invalid_request`

| HTTP | When                                                  |
| ---- | ----------------------------------------------------- |
| 400  | A required field is missing, or a value is malformed. |

Common cases:

* Required query parameter omitted (e.g. `GET /v1/notes` without
  `projectId`).
* Enum field given an unknown value (e.g. `?status=BOGUS` against
  `/v1/posts`).
* Date filter with the wrong format (`?dateFrom=15/05/2026` — must be
  `YYYY-MM-DD`).
* A request body fails Zod validation (write endpoints, Phase 3+).

The error envelope's `details` field, when present, names the offending
parameter:

```json theme={null}
{
  "error": {
    "code": "invalid_request",
    "message": "Unknown 'status' value(s): BOGUS.",
    "request_id": "req_…",
    "docs_url": "https://docs.scripe.io/api/v1/errors#invalid_request"
  }
}
```

To recover, fix the malformed input and retry. The request did not have
side effects on the server — `invalid_request` is rejected before any
write would have happened.