How do you handle API versioning?

We currently maintain two API versions: V1 and V2. V2 is our latest version with enhanced features including probability values, extended country support, and improved accuracy. V1 remains available for backward compatibility but we recommend migrating to V2 for new integrations. All API endpoints include the version in the URL path (e.g., /v2/name). We guarantee that older API versions still continue to work. Migration guides are available in our API documentation. Breaking changes are always communicated well in advance.