$5 free Limited time. Sign up to activate. Get your $5 →
API Improvement

Roles return newest first

A person's current role now always comes first, then past roles by most recent end date.

The roles array on a person now comes back in a fixed order: the current role first, then past roles by most recent end date. The same request returns the same order every time.

Before, roles could come back in any order, and the order could differ between identical calls. Now roles where is_current is true come first, then the rest by end_date, newest first.

If you sorted roles yourself to find someone's current job, you can now read roles[0]. Nothing else in the response changed, and there is no change to credits or rate limits.

The full entry, with the request and response, is on the docs changelog.

Changelog

More changes

  1. APINew

    Work email lookup v2

    Find a person's work email and check that it is deliverable, charged only when an address is found.

  2. APIImprovement

    Phone feedback: is_correct_person is optional

    Report a phone outcome without knowing who answered: is_correct_person is now optional.

  3. APIBreaking

    Autocomplete requires an API key

    Autocomplete endpoints now need your API key and an account-scoped path, like every other endpoint.

  4. APIImprovement

    Personal email returns consumer addresses only

    Personal email lookups now return consumer mailbox addresses only, and charge nothing when none are left.

All changes

Start building

Try what shipped

Get a free API key with $5 in credits and run the new call on your own sample.

  • $5 free credits
  • No credit card
  • Run your sample
Platforms and teams that build on Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut