# API Versioning (https://docs.chargeflow.io/docs/reference/concepts/api-versioning)



Chargeflow uses date-based, path parameter versioning for its public API. This approach gives you a stable, predictable URL structure and ample time to migrate whenever breaking changes are introduced.

## Using API versions [#using-api-versions]

Select the API version by including the version date in the request path:

```
https://api.chargeflow.io/public/{apiVersion}/...
```

Replace `{apiVersion}` with the version string from the [Available versions](#available-versions) table below. For example:

```bash title="Terminal"
https://api.chargeflow.io/public/2025-04-01/disputes
```

> Always include an explicit version in your requests. This ensures your integration is unaffected by future changes to newer versions.

## Deprecation policy [#deprecation-policy]

During significant updates, Chargeflow may mark specific API methods of a version as deprecated. When a method is marked as deprecated, it indicates that it will no longer be available in upcoming versions. Deprecation notices are communicated in advance, giving you time to migrate before the method is removed.

## Available versions [#available-versions]

| Version      | Release date   | Notes                                   |
| ------------ | -------------- | --------------------------------------- |
| `2024-03-18` | March 18, 2024 | Initial API release                     |
| `2025-04-01` | April 1, 2025  | New endpoints and payload modifications |

<Callout title="Note">
  Use the version string exactly as shown (e.g., `2025-04-01`) in the URL path. Do not use shortened
  or alternate date formats.
</Callout>

## Next steps [#next-steps]

<Cards>
  <Card title="Changelog" href="/docs/reference/changelog">
    What changed in each version.
  </Card>

  <Card title="API Reference" href="/docs/api/2025-04-01/get-started">
    The full endpoint reference for the current version.
  </Card>

  <Card title="Quickstart" href="/docs/merchants/quickstart">
    Make your first versioned request.
  </Card>
</Cards>