Get complete history of a deal/contact/lead


  • Grzegorz Pogwizd
    Zendesk team member

    Hi Borna,

    Thanks for reaching out with this question, I'm happy to clarify.

    I'm sorry to disappoint you but Sell does not have API endpoints available for getting historical data on objects (including Leads, Contacts and Deals).

    Only the "last known state" of an object is available to get through the endpoints, and the 'version' attribute that you've noticed in the Search API is not too useful as it's just a value that is automatically incremented with every change of the object. We don't store or expose previous versions of that object though.

    So all in all, you won't be able to run a report basing on historical data, using our APIs, I'm afraid.

    However, there is a possibility to fetch and store all events (including objects changes) in your Sell account, from a certain point in time and going forward, using the Firehose API -

    This API provides a near real-time stream of events, that you can fetch, consume and process on your side. If you decide to just fetch and store those events, you'll basically receive a stack of object versions for later reporting usage.

    I trust this helps and in case of any further questions do not hesitate to let us know. Best regards!

    Grzegorz Pogwizd
    Technical Support Engineer | Zendesk Sell

    Do you need more information? - Our Help Center has it all at
    Do you prefer a live conversation? - Call us at +1 888-670-4887 press 1, Mo-Fr, 8am-5pm, Pacific Time
    Want to talk to other Sell users? - check out our Community at


Please sign in to leave a comment.

Powered by Zendesk