Migration Checklist

Check usage per endpoint to learn what you actually call — especially whether Person Search appears anywhere.

Flip your test environment integration suite to /v3/ paths. Mock responses have full v3 parity, so failures here are real findings. Discover is the one area where a path swap alone won’t pass — its request body is reshaped.

Wire confidenceScore gating, isCurrent, and staleProfile handling — the highest-value v3 wins.

Use the query mapping table. Hard deadline: January 31, 2028.

Endpoint by endpoint, behind a config flag. Both versions share credits and rate limits, so there’s no billing cliff.

Alert on Deprecation: true in responses to catch any code paths you missed.