Skip to main content

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

HTTPWhen
400A 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: 
{
  "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.