> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.flare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Flare API Updates

> New updates and improvements

<Note>
  This page lists changes to Flare's API.
  Release notes for the Flare Platform can be found on the [product documentation website](https://docs.flare.io/releases).
</Note>

<Update label="2026-04" description="API - April 2026">
  Added new endpoints to manage [Matching Policies <Icon icon="code" size={16} />](/api-reference/v4/endpoints/list-matching-policies).

  This is useful for customers who want precise control over which events appear in an Identifier’s feed, either by including or excluding events based on keywords, or by scoping results with a specific search query.

  The guide
  [Create And Assign Matching Policies to Identifiers <Icon icon="book" size={16} />](/guides/create-identifiers-with-matching-policies)
  was added with an example usage.

  <Icon icon="warning" size={16} /> This deprecates the use of the 'blacklist' parameter (Ignored Terms) in identifiers. It will continue to work, but could be removed in the future.
</Update>

<Update label="2026-03" description="API - March 2026">
  Added new value for the `include` parameter in the [Global Search Credentials Endpoint <Icon icon="code" size={16} />](/api-reference/v4/endpoints/credentials-global-search).

  Added documentation for the `include` parameter in the [ASTP Search Credentials Endpoint <Icon icon="code" size={16} />](/api-reference/astp/endpoints/post-credentials-search).

  Replaced the `leak` event type for individual `leaked_credential` events. See [Leaked Credentials <Icon icon="book" size={16} />](/event-types/leaked-credential)
</Update>

<Update label="2026-02-08" description="Python SDK - v2.0.0">
  Released version 2.0.0 of the
  [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  This release changes the API of `scroll_events` to yield `ScrollEventsResult` objects.
  This new object exposes `metadata`, `event` and `next` fields.

  The previous API for this method wouldn't expose the `metadata` and forced users of the library
  to implement their own pagination logic.
  This new API ensures all data is available to the caller.
</Update>

<Update label="2026-02" description="CLI - February 2026">
  Released the beta of the
  [Flare API CLI <Icon icon="book" size={16} />](/sdk/cli)
  utility.

  This new command line interface (CLI) program provides Flare API automations such as
  exporting tenant events or credentials to CSV files.
</Update>

<Update label="2026-02" description="API - February 2026">
  Published a new
  [List and Update Identifiers <Icon icon="book" size={16} />](/guides/update-identifiers)
  guide.
</Update>

<Update label="2025-11-19" description="Python SDK - v1.2.0">
  Released version 1.2.0 of the
  [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  This release adds a new `scroll_events` method that can be used to retrieve events from the feed APIs
  without having to manage fetching events individually.

  More information, including full examples, can be found in the
  [Python SDK documentation <Icon icon="book" size={16} />](/sdk/python).
</Update>

<Update label="2025-11" description="API - November 2025">
  Added a [Global Search Credentials Endpoint <Icon icon="code" size={16} />](/api-reference/v4/endpoints/credentials-global-search).
  This new endpoint allows for searching in all of Flare's credentials and counts towards the Global Search quota.
  This is useful for customers that don't have ASTP access.
</Update>

<Update label="2025-10" description="API - October 2025">
  Added documentation for
  [Flare API Event Types <Icon icon="book" size={16} />](/event-types/overview).
</Update>

<Update label="2025-08" description="API - August 2025">
  API endpoints using the `/leaksdb/` prefix were changed to `/astp/`.
  The old prefix remains available as an alias and there are no plans to deprecate it.
</Update>

<Update label="2025-07" description="MCP - July 2025">
  Released the
  [Flare API Documentation MCP Server <Icon icon="book" size={16} />](/sdk/mcp).

  This is useful for developers building Flare API automations with AI-powered integrated development environments (IDE).
</Update>

<Update label="2025-07" description="API - July 2025">
  The [/leaksdb/credentials <Icon icon="code" size={16} />](/api-reference/leaksdb/endpoints/get-credentials-v1)
  and [/leaksdb/v2/credentials <Icon icon="code" size={16} />](/api-reference/leaksdb/endpoints/get-credentials-v2)
  endpoints were marked as deprecated and should be replaced by
  [/astp/v2/credentials/\_search <Icon icon="code" size={16} />](/api-reference/astp/endpoints/post-credentials-search).
</Update>

<Update label="2025-05-15" description="Python SDK - v1.0.0">
  Released version 1.0.0 of the
  [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  This release contains no changes, it simply marks 1.0.0 so that future
  breaking changes can be communicated using semantic versioning.
</Update>

<Update label="2025-05" description="API - May 2025">
  Added a new
  [List Credentials Within a Tenant <Icon icon="book" size={16} />](/guides/tenant-credentials)
  guide.
</Update>

<Update label="2025-04" description="API - April 2025">
  Released a new version of the List All Credentials endpoint,
  [List All Credentials V2 <Icon icon="code" size={16} />](/api-reference/leaksdb/endpoints/get-credentials-v2),
  which supports the
  [Flare standard paging pattern <Icon icon="book" size={16} />](/concepts/paging).

  The old endpoint is still supported and was marked as deprecated:
  [List All Credentials V1 <Icon icon="code" size={16} />](/api-reference/leaksdb/endpoints/get-credentials-v1).
</Update>

<Update label="2025-02-18" description="Python SDK - v0.2.1">
  Released version 0.2.1 of the
  [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  This release adds a `from_env` method to `FlareApiClient`.

  This allows the creation of a client from the following environment variables:

  * `FLARE_API_KEY="<key>"`
  * `FLARE_TENANT_ID="<tenant_id>"`

  Then, the client can be created using:

  ```python theme={null}
  from flareio import FlareApiClient


  client = FlareApiClient.from_env()
  ```

  The following command can be used to upgrade:

  ```shell theme={null}
  pip install flareio>=0.2.1
  ```
</Update>

<Update label="2025-01" description="API - January 2025">
  Modified the
  [retrieve event <Icon icon="code" size={16} />](/api-reference/v2/endpoints/activities/get-activities-)
  endpoint to accept the UID as a query parameter instead of as path parameters.
  This avoids confusion that some users had when using uids that have multiple slashes.
  The old endpoint with path parameters was kept for backwards compatibility.

  Increased
  [basic rate limiting <Icon icon="book" size={16} />](/concepts/rate-limits-and-quotas)
  from 2 requests per second to 4 requests per second.
</Update>

<Update label="2024-12" description="API - December 2024">
  The
  [cookies search endpoint <Icon icon="code" size={16} />](/api-reference/astp/endpoints/post-cookies-search)
  now returns an `uuid` that can be used to uniquely identify cookies.

  The
  [cookies search endpoint <Icon icon="code" size={16} />](/api-reference/astp/endpoints/post-cookies-search)
  now returns an `imported_at` timestamp that indicates when the cookie was imported to
  Flare's database. It also has a new `imported_after` filter that allows for retrieving
  cookies that were imported after a given timestamp. The
  [Cookie Monitoring Guide <Icon icon="book" size={16} />](/guides/cookie-monitoring)
  was updated with an example usage.

  Released new
  [event actions endpoint <Icon icon="code" size={16} />](/api-reference/v4/endpoints/event-actions).
  It allows ignoring, unignoring, remediating and unremediating events.
</Update>

<Update label="2024-10-22" description="Python SDK - v0.1.25">
  Released version 0.1.25 of the
  [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  This release fixes an issue with packaging that caused the Python SDK to
  declare too many Python dependencies, conflicting with libraries installed
  in the environments of some users.

  The following command can be used to upgrade:

  ```shell theme={null}
  pip install flareio>=0.1.25
  ```
</Update>

<Update label="2024-09" description="API - September 2024">
  The API documentation has been revamped for better clarity and structure.

  We’ve added new [use-case guides <Icon icon="book" size={16} />](/introduction/getting-started)
  to help you quickly address specific customer needs.

  Released new
  [global search endpoint <Icon icon="code" size={16} />](/api-reference/v4/endpoints/global-search)
  with simpler-to-use filters.

  Released new
  [credentials search endpoint <Icon icon="code" size={16} />](/api-reference/astp/endpoints/post-credentials-search)
  with simpler-to-use filters and support for Flare's standard paging pattern.

  Released a [Python SDK <Icon icon="book" size={16} />](/sdk/python).

  Released a [Go SDK <Icon icon="book" size={16} />](/sdk/go).
</Update>