Marmin
BusinessesPartnersProduct Wiki

API versioning overview

Marmin uses a request header to control which API contract applies to each call.

Send `X-MARMIN-VERSION` on every request. The API reference in this section describes the `20260101` contract.

Available versions
VersionDescription
20260101Baseline contract described in these docs.
20260507Latest contract with recent changes — review the API change log and Integrator migration guide before upgrading.
Choosing a version

We recommend always sending the header.

  • To match this documentation: X-MARMIN-VERSION: 20260101

  • To upgrade: X-MARMIN-VERSION: 20260507 — validate your payloads in sandbox before production.

If you omit the header, Marmin uses your organization's default version. Most accounts default to 20260101. If you are unsure, set the header explicitly or contact support@marmin.ai.

Use the same header value for all related calls in one workflow.

Examples

Baseline contract (matches this documentation):

X-MARMIN-VERSION: 20260101

Latest contract:

X-MARMIN-VERSION: 20260507
Invalid values

The version must be a date in YYYYMMDD format (for example, 20260101). An invalid value returns 400 Bad Request.

Next