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

# API Changelog

> Changes to the Current API: new endpoints, request/response changes, deprecations, and fixes. Subscribe via RSS to stay ahead of anything that affects your integration.

This is the changelog for the [Current API](/introduction) (`https://api.getcurrent.ca/v1`).
We note every change that a consumer could perceive — new fields, changed
behavior, deprecations, and fixes — and label anything **breaking** clearly.

**Subscribe:** an RSS feed for this page is generated automatically at
[`/changelog/rss.xml`](https://docs.getcurrent.ca/changelog/rss.xml). Point your
reader (or a Slack RSS integration) at it to get notified of API changes.

<Info>
  Breaking changes are announced here **before** they ship, and API-key holders
  are emailed directly. If a change isn't marked **Breaking**, it is additive and
  safe to adopt at your own pace.
</Info>

<Update label="2026-07-28" tags={["Added"]}>
  ## Search & verify a stored business by id

  `POST /search` and `POST /verify` now accept a reference to one of your stored
  business records instead of re-supplying its details. Reference it by our id
  with **`businessId`**, or by your own id on the record with the new
  **`businessExternalId`** — the request fields (name/website for search; legal
  name, jurisdiction, registration number, address, people for verify) are
  hydrated from that record. Any field you also send overrides the record for
  that request only; the stored record is never modified.

  * `name` (search) and `legalName` / `jurisdiction` / `registrationNumber`
    (verify) become optional when a reference is provided.
  * An unknown or foreign id returns `404 NOT_FOUND`. Supplying both `businessId`
    and `businessExternalId` that point at different records returns `400`.
  * A `businessId`-linked search compares its results against the record (the
    comparison / discrepancy view), same as a batch search.

  **Clarification:** on `/verify`, the existing `externalId` field is your
  reference id recorded as metadata on the verification **result** — it is not a
  business lookup and never modifies the business record. Use the new
  `businessExternalId` to look a business up by your own id.

  All changes are additive — existing requests are unaffected.
</Update>

<Update label="2026-07-16" tags={["Announcement"]}>
  ## API changelog is live

  We now publish a dedicated changelog for the Current API. Going forward, every
  release that touches the `/v1` surface — endpoints, request or response
  shapes, webhooks, rate limits, or auth — gets an entry here, categorized as
  **Breaking**, **Added**, **Changed**, **Deprecated**, or **Fixed**.

  Nothing about the API has changed in this entry — this is the starting point.
  The current surface is documented in the [API Reference](/api-reference/create-search).
</Update>