`version_unsupported`

HTTP	When
400	The `Scripe-Api-Version` header is missing or unknown.

We accept at least the two most recent date-stamped versions at any time. Sunset of older versions is announced via the Scripe-Deprecation response header at least 90 days before the sunset date — see conventions.md §versioning. The error envelope’s details field lists currently-accepted versions when present:

{
  "error": {
    "code": "version_unsupported",
    "message": "The 'Scripe-Api-Version' header is missing or unsupported.",
    "request_id": "req_…",
    "docs_url": "https://docs.scripe.io/api/v1/errors#version_unsupported",
    "details": { "accepted": ["2026-08-01"] }
  }
}

To recover:

Pin a supported version in your client config.
If you’re upgrading, smoke-test in staging against the new version header before you cut over production.
If you got here because we sunset a version, find the deprecation notice in the Scripe-Deprecation header captured before the cutover, or contact support — we always email integrators ahead of any sunset.

Getting started

Resources

Errors

Version unsupported

`version_unsupported`

​version_unsupported

`version_unsupported`