We are excited to announce that a set of API v2 endpoints has officially moved out of BETA status and is now stable. These endpoints provide a more efficient and performant way to interact with Pipedrive, replacing specific APIv1 endpoints.

Why This Matters?

• Better Performance: API v2 endpoints are optimized for speed and reliability.
• Lower Token Costs: These endpoints consume fewer API tokens per request, making them a more cost-effective option.
• Improved Stability: As stable endpoints, they are fully supported and ready for production use.

Optimize API Usage with Token-Based Rate Limiting

Since the introduction of Token-Based Rate Limiting last year, we encourage all developers to migrate to available stable API v2 endpoints. Doing so will help you stay within your API token budget while maintaining seamless integration or even allow you to make more requests within the same budget.

  <h2>What's Changing?</h2>
  <p>The following API v2 endpoints are now stable:</p>
  <ul>
    <li><code>GET /api/v2/activities</code></li>
    <li><code>GET /api/v2/activities/:id</code></li>
    <li><code>POST /api/v2/activities</code></li>
    <li><code>PATCH /api/v2/activities/:id</code></li>
    <li><code>DELETE /api/v2/activities/:id</code></li>
    <li><code>GET /api/v2/deals</code></li>
    <li><code>GET /api/v2/deals/:id</code></li>
    <li><code>POST /api/v2/deals</code></li>
    <li><code>PATCH /api/v2/deals/:id</code></li>
    <li><code>DELETE /api/v2/deals/:id</code></li>
    <li><code>GET /api/v2/persons</code></li>
    <li><code>GET /api/v2/persons/:id</code></li>
    <li><code>POST /api/v2/persons</code></li>
    <li><code>PATCH /api/v2/persons/:id</code></li>
    <li><code>DELETE /api/v2/persons/:id</code></li>
    <li><code>GET /api/v2/organizations</code></li>
    <li><code>GET /api/v2/organizations/:id</code></li>
    <li><code>POST /api/v2/organizations</code></li>
    <li><code>PATCH /api/v2/organizations/:id</code></li>
    <li><code>DELETE /api/v2/organizations/:id</code></li>
    <li><code>GET /api/v2/products</code></li>
    <li><code>GET /api/v2/products/:id</code></li>
    <li><code>POST /api/v2/products</code></li>
    <li><code>PATCH /api/v2/products/:id</code></li>
    <li><code>DELETE /api/v2/products/:id</code></li>
    <li><code>GET /api/v2/products/:id/variations</code></li>
    <li><code>GET /api/v2/products/variations</code></li>
    <li><code>POST /api/v2/products/:id/variations</code></li>
    <li><code>PATCH /api/v2/products/:id/variations/:id</code></li>
    <li><code>DELETE /api/v2/products/:id/variations/:id</code></li>
    <li><code>GET /api/v2/deals/:id/products</code></li>
    <li><code>GET /api/v2/deals/products</code></li>
    <li><code>POST /api/v2/persons/:id/products</code></li>
    <li><code>PATCH /api/v2/persons/:id/products</code></li>
    <li><code>DELETE /api/v2/persons/:id/products/:id</code></li>
    <li><code>GET /api/v2/itemSearch</code></li>
    <li><code>GET /api/v2/itemSearch/field</code></li>
    <li><code>GET /api/v2/deals/search</code></li>
    <li><code>GET /api/v2/leads/search</code></li>
    <li><code>GET /api/v2/persons/search</code></li>
    <li><code>GET /api/v2/organizations/search</code></li>
    <li><code>GET /api/v2/products/search</code></li>
    <li><code>GET /api/v2/pipelines</code></li>
    <li><code>GET /api/v2/pipelines/:id</code></li>
    <li><code>POST /api/v2/pipelines</code></li>
    <li><code>PATCH /api/v2/pipelines/:id</code></li>
    <li><code>DELETE /api/v2/pipelines/:id</code></li>
    <li><code>GET /api/v2/stages</code></li>
    <li><code>GET /api/v2/stages/:id</code></li>
    <li><code>POST /api/v2/stages</code></li>
    <li><code>PATCH /api/v2/stages/:id</code></li>
    <li><code>DELETE /api/v2/stages/:id</code></li>
  </ul>
  <p>If you’re still using API v1 for these actions, we strongly recommend switching to API v2 to take advantage of its improved efficiency and reduced token consumption.</p>

  <h2>Additional resources:</h2>
  <ul>
    <li><a href="https://developers.pipedrive.com/docs/api/v1">API Reference</a></li>
    <li><a href="https://pipedrive.readme.io/docs/core-api-concepts-rate-limiting">Developer documentation</a></li>
    <li><a href="https://pipedrive.readme.io/docs/guide-for-optimizing-api-usage">API usage optimization</a></li>
    <li><a href="https://pipedrive.readme.io/docs/pipedrive-api-v2-migration-guide">API v2 Migration Guide</a></li>
  </ul>      
  <p>If you have any questions or comments, feel free to let us know in <a href="https://devcommunity.pipedrive.com/">the Developer’s Community</a>.</p>