429
response, and no rate-limit headers on v1 responses.
That is not an invitation to hammer the API.
Building considerately
Page, don't poll hard
Search endpoints take
start and take. Pull a page at a time rather than looping at
speed over the whole marketplace.Back off on failure
On
5xx or a timeout, retry with exponential backoff — but read the
retry guidance first, because v1 has no idempotency keys.Cache what's stable
Group membership and NDC statistics change slowly. Re-reading them on every operation
is wasted traffic.
Batch NPI updates
groups/npi-update takes an array. Send one call with many NPIs, not many calls.What changes in v2
v2 introduces per-credential and per-pharmacy limits, with standard headers on every response —X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset — and
Retry-After on a 429.
Search requests count double against the allowance, because they’re the expensive ones.
Exact v2 ceilings will be published with the v2 documentation at general availability.