Skip to Content
Changelog13/11/2026 · X-Saltra-Mode header and test environment

X-Saltra-Mode header and test environment

13/11/2026

Affects Social Security / RED System (including ETTS) and SEPE requests under /api/v4, and the public MCP server. DEHU, AEAT and the Navarre Tax Office have no fictitious mode.

  • New X-Saltra-Mode header. test makes the request fictitious (nothing is sent to the authority and the response carries sample data) and live makes it real. Any other value returns 422. On the public MCP server the header is set on the MCP connection.
  • Documented test environment. https://dev-api.saltra.es has the same endpoints as production; there, without the header, everything is fictitious, and with X-Saltra-Mode: live the request is really sent with the client’s certificate. In production (https://api.saltra.es), without the header, the request is real. Full table in Environments and test mode.
  • The documentation no longer mentions the test=1 parameter on the endpoints: each one now explains how to make the request fictitious with the header.

What to check in your integration: nothing mandatory. Integrations that already send test=1 keep working unchanged. For new integrations, use X-Saltra-Mode.

Last updated on