API Versioning

API versioning ensures backward compatibility and allows us to introduce improvements without breaking existing integrations.

The current version of the Fanvue API is 2025-06-26.

Version Header

All API requests must include the X-Fanvue-API-Version header to specify which version of the API you want to use.

$
curl -H "X-Fanvue-API-Version: 2025-06-26" \
>
  -H "X-Fanvue-API-Key: your-api-key" \
>
  https://api.fanvue.com/users/me

Error Responses

400 Bad Request - When requesting an unsupported version:

1
{
2
  "error": "Unsupported API version",
3
  "message": "API version '2024-01-01' is not supported"
4
}

410 Gone - When requesting a sunset (removed) version:

1
{
2
  "error": "API version no longer supported",
3
  "message": "API version '2024-01-01' was sunset on 2024-12-31T00:00:00.000Z",
4
  "nextVersion": "2025-06-26"
5
}

Dive deeper

For advanced version management strategies, migration patterns, and production best practices, check out our Version Management Strategies.