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

# API Updates

<Update label="2026-07-23" description="v2 (Stable) · v1 (Deprecated)">
  ### Announcements

  * **API v2 is now stable** — the Beta tag has been removed. v2 is the recommended and actively developed version going forward.
  * **API v1 is now deprecated** and will no longer be supported after **15 November 2026**. v1 documentation stays online and marked as deprecated until then. See the [v2 documentation](../v2/company/introduction) to migrate.
</Update>

<Update label="2026-07-14" description="v2 (Beta)">
  ### Breaking Changes

  * [Removed inline `enrichEmail`/`enrichMobilePhone` enrichment from the Contact Details endpoints](v2/company/contactDetails) — `email` and `mobilePhone` are now always returned unenriched.
  * Renamed the `id` field to `enrichmentId` on the [Enrichment Status](v2/enrichments/status) response, for consistency with the enrichment-creation endpoints.

  ### Additions

  * Enrichments:
    * [Added a new endpoint to enrich a single contact's email/mobile phone asynchronously](v2/company/contactEnrich)
    * [Added a new endpoint to enrich contacts in bulk asynchronously](v2/company/contactEnrichBulk) — returns `202 Accepted`
    * [Added a new endpoint to poll enrichment status](v2/enrichments/status)

  ### Modifications

  * [Added `jobTitle` to the company contacts list response](v2/company/contacts)
  * [Legal entity document `url` values are normalized to a full URL](v2/legalEntity/documents), with NBB-sourced documents returned as a signed URL; documents are never omitted from the response.
  * Synchronous [contact enrichment](v2/company/contactEnrich) charges now report `X-Bizzy-Credits-Balance`/`X-Bizzy-Credits-Charged` response headers, consistent with the rest of the charged API surface.
</Update>

<Update label="2026-07-13" description="v2 (Beta)">
  ### Breaking Changes

  * [Dropped the `countryCode` path segment from single-entity company and legal entity GET endpoints](v2/company/introduction) — country is now always resolved from the entity itself, with no deprecation alias.
  * [Simplified the company vacancies response to core job fields](v2/company/vacancies) — removed `id`, `companyId`, `locationKey`, `isActive`, `source`, `createdAt`, and `updatedAt`.
  * [Removed the unused `id` field from company technologies](v2/company/technologies)
  * [Removed the raw relevance `score` field from company lookalikes](v2/company/lookalikes)
  * Renamed generic `identifier` object keys to entity-specific names (`companyIdentifier`, `contactIdentifier`, `legalEntityIdentifier`, `listIdentifier`, `savedSearchIdentifier`) across all V2 endpoints.

  ### Modifications

  * [`website` now returns a full URL instead of a bare domain](v2/company/details) on company and legal entity details endpoints.
</Update>

<Update label="2026-07-01" description="v2 (Beta)">
  ### Additions

  * Lists:
    * [Added a new endpoint to fetch lists](v2/lists/overview)
    * [Added a new endpoint to fetch a single list](v2/lists/details)
    * [Added a new endpoint to fetch the items of a list](v2/lists/results)
    * [Added a new endpoint to add items to a list](v2/lists/add-items)
    * [Added a new endpoint to queue a list export](v2/lists/export)
  * Saved Searches:
    * [Added a new endpoint to fetch saved searches](v2/saved-searches/overview)
    * [Added a new endpoint to fetch a single saved search](v2/saved-searches/details)
    * [Added a new endpoint to execute a saved search and fetch its results](v2/saved-searches/results)
  * Exports:
    * [Added a new endpoint to fetch the status of an export](v2/exports/status)
  * Agents:
    * [Added a new endpoint to fetch agents](v2/agents/overview)

  ### Modifications

  * [Expanded the list of supported countries for the V2 API to 33 countries](../v2/supported-countries)
  * Corrected the response documentation across the V2 Company and Legal Entity endpoints
    (identifier `countryCode` field, request body vs. query parameters, and pagination caps).
</Update>

<Update label="2026-04-20" description="v2 (Beta)">
  ### Additions

  * Company:
    * [Added a new endpoint to fetch company updates](v2/company/updates)
    * [Added a new endpoint to fetch company updates in bulk](v2/company/updatesBulk)
  * Legal Entity
    * [Added a new endpoint to fetch legal entity updates](v2/legalEntity/updates)
    * [Added a new endpoint to fetch legal entity updates in bulk](v2/legalEntity/updatesBulk)
</Update>

<Update label="2026-04-14" description="v2 (Beta)">
  ### Additions

  * Company:
    * [Added a new endpoint to fetch company contacts](v2/company/contacts)
    * [Added a new endpoint to fetch company contacts in bulk](v2/company/contactsBulk)
    * [Added a new endpoint to fetch company contact details](v2/company/contactDetails)
    * [Added a new endpoint to fetch company contact details in bulk](v2/company/contactDetailsBulk)
    * [Added a new endpoint to fetch company lookalikes](v2/company/lookalikes)
    * [Added a new endpoint to fetch company lookalikes in bulk](v2/company/lookalikesBulk)
    * [Added a new endpoint to fetch company technologies](v2/company/technologies)
    * [Added a new endpoint to fetch company technologies in bulk](v2/company/technologiesBulk)
    * [Added a new endpoint to fetch company vacancies](v2/company/vacancies)
    * [Added a new endpoint to fetch company vacancies in bulk](v2/company/vacanciesBulk)
    * [Added a new endpoint to fetch company legal entities](v2/company/legalEntities)
  * Legal Entity
    * [Added a new endpoint to fetch legal entity details](v2/legalEntity/details)
    * [Added a new endpoint to fetch legal entity details in bulk](v2/legalEntity/detailsBulk)
    * [Added a new endpoint to fetch legal entity financials](v2/legalEntity/financials)
    * [Added a new endpoint to fetch legal entity financials in bulk](v2/legalEntity/financialsBulk)
    * [Added a new endpoint to fetch legal entity directors](v2/legalEntity/directors)
    * [Added a new endpoint to fetch legal entity directors in bulk](v2/legalEntity/directorsBulk)
    * [Added a new endpoint to fetch legal entity ownership](v2/legalEntity/ownership)
    * [Added a new endpoint to fetch legal entity ownership in bulk](v2/legalEntity/ownershipBulk)
    * [Added a new endpoint to fetch legal entity establishments](v2/legalEntity/establishments)
    * [Added a new endpoint to fetch legal entity establishments in bulk](v2/legalEntity/establishmentsBulk)
    * [Added a new endpoint to fetch legal entity documents](v2/legalEntity/documents)
    * [Added a new endpoint to fetch legal entity documents in bulk](v2/legalEntity/documentsBulk)
</Update>

<Update label="2026-04-13" description="v2 (Beta)">
  ### Additions

  * Company:
    * [Added a new endpoint to search for companies](v2/company/search)
    * [Added a new endpoint to fetch company details](v2/company/details)
    * [Added a new endpoint to fetch company details in bulk](v2/company/detailsBulk)

  ### Modifications

  * Restructured documentation to distinguish between v1 and v2.
</Update>

<Update label="2025-12-10" description="v1">
  ### Additions

  * Company:
    * [Added a new endpoint to fetch company details in bulk](v1/company/detailsBulk)
    * [Added a new endpoint to fetch company financials in bulk](v1/company/financialsBulk)
    * [Added a new endpoint to fetch company relationships in bulk](v1/company/relationshipsBulk)
    * [Added a new endpoint to fetch company lookalikes in bulk](v1/company/lookalikesBulk)
    * [Added a new endpoint to fetch company contacts in bulk](v1/company/contactsBulk)
    * [Added a new endpoint to fetch company contact details in bulk](v1/company/contactDetailsBulk)
  * Lists:
    * [Added a new enpoint to add companies in bulk to a static list](v1/lists/companiesBulk)
    * [Added a new enpoint to add contacts in bulk to a static list](v1/lists/contactsBulk)
    * [Added a new endpoint to queue an export](v1/lists/export)
  * Exports:
    * [Added a new endpoint to fetch the details of an export](v1/export/details)
</Update>

<Update label="2025-06-23" description="v1">
  ### Modifications

  * [Update base URL to https://api.bizzy.ai](../usage/introduction#base-url)
</Update>

<Update label="2025-04-04" description="v1">
  ### Additions

  * Company:
    * [Added a new endpoint to fetch contacts](v1/company/contacts)
    * [Added a new endpoint to fetch contact details](v1/company/contactDetails)
  * Lists:
    * [Added a new endpoint to fetch contacts](v1/lists/contacts)
    * [Added a new endpoint to add a contact to a static list](v1/lists/contact)

  ### Modifications

  * Credit usage:
    * Updated the credit usage page to explain contact enrichments.
</Update>

<Update label="2025-03-28" description="v1">
  ### Additions

  * [Errors are now documented](../v1/errors)
</Update>

<Update label="2024-12-19" description="v1">
  ### Additions

  * Company:
    * [Added a new endpoint to search for companies](v1/company/search)
  * Lists:
    * [Added a new endpoint to add a company to a static list](v1/lists/company)
</Update>

<Update label="2024-11-20" description="v1">
  ### Additions

  * Lists:
    * [Added a new endpoint to fetch lists](v1/lists/overview)
    * [Added a new endpoint to fetch a single list](v1/lists/single)
    * [Added a new endpoint to fetch companies from a list](v1/lists/companies)
</Update>