API version reference

Moov's API versioning follows the format vYYYY.QQ.BB, where

  • YYYY is the year
  • QQ is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)
  • BB is the build number, starting at .00, for subsequent builds in the same quarter.

For example, v2025.01.00 is the initial release of the first quarter of 2025.

Lifecycle

Each quarter's API version is released at the start of that quarter. For example, v2026.04.00 will be released in April 2026. Once released, a version is considered stable and will only receive non-breaking changes.

When a new version is released, work begins on the next quarter's version, which is considered in development. The in development version receives new features, breaking changes, and non-breaking changes throughout the quarter. For example, once v2026.04.00 is officially released in April, v2026.07.00 enters in development and is available for early access.

Note - if no changes are made to the in development API version, that version will be skipped for an official release and will disappear from our public documentation.

If no API version is passed in your header request, Moov will default to v2024.01.00.

Available versions

  • v2026.04.00 (in development)
  • v2026.01.00 (current)
  • v2025.07.00
  • v2025.04.00
  • v2025.01.00
  • v2024.01.00 (default)

The in development version of the API always represents the next quarter's API.

2026.01.00

Added the instant-bank-credit payment method for real-time payments via RTP or FedNow. While rtp-credit will continue to be supported, Moov strongly suggests moving to the instant-bank-credit payment method.

2025.07.00

  • New support tickets allow you to hand off connected account support to Moov, and Moov will respond
  • Granular capabilities allow you to only request the capabilities you need, shortening onboarding time
  • Underwriting dynamically generates based on an account's business profile and requested capabilities
  • New enriched industry taxonomies model
  • Allows Moov to create guest accounts for Tap to Pay processing

2025.04.00

  • Added support for a terminalCard source and the card-present-payment payment method type for in-person payments.

2025.01.00

  • Updated error response status codes.

latest (beta)

Moov's latest API version will have our newest features and updates. The latest version is always considered in beta. Browse the changelog for announcements or browse the API site.

Breaking changes

  • Non-breaking changes may be added to a release even after it becomes stable.
  • Minor breaking changes may be added to a release while it's in beta. Moov attempts to minimize this as much as possible.
  • Brand new features or major breaking changes will be in API version latest. Moov may release new features or major breaking changes for customers who are in specific beta programs or testing various features with us.

See the breaking changes guide for more details.

SDK versioning

SDKs are generated from each API version. SDK versioning will have the following format:

API version SDK version
v2025.07.00 25.7.x
v2026.01.00 26.1.x
v2026.04.00 26.4.0-dev.x

For example, API v2026.04.00 is in development, so the corresponding -dev.x SDK version indicates an in development version of the SDK and should be used with caution.

Summary Beta