API Updates

​

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 to migrate.

​

Breaking Changes

• Removed inline enrichEmail/enrichMobilePhone enrichment from the Contact Details endpoints — email and mobilePhone are now always returned unenriched.
• Renamed the id field to enrichmentId on the Enrichment 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
  • Added a new endpoint to enrich contacts in bulk asynchronously — returns 202 Accepted
  • Added a new endpoint to poll enrichment status

​

Modifications

• Added jobTitle to the company contacts list response
• Legal entity document url values are normalized to a full URL, with NBB-sourced documents returned as a signed URL; documents are never omitted from the response.
• Synchronous contact enrichment charges now report X-Bizzy-Credits-Balance/X-Bizzy-Credits-Charged response headers, consistent with the rest of the charged API surface.

​

Breaking Changes

• Dropped the countryCode path segment from single-entity company and legal entity GET endpoints — country is now always resolved from the entity itself, with no deprecation alias.
• Simplified the company vacancies response to core job fields — removed id, companyId, locationKey, isActive, source, createdAt, and updatedAt.
• Removed the unused id field from company technologies
• Removed the raw relevance score field from 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 on company and legal entity details endpoints.

​

Additions

• Lists:
  • Added a new endpoint to fetch lists
  • Added a new endpoint to fetch a single list
  • Added a new endpoint to fetch the items of a list
  • Added a new endpoint to add items to a list
  • Added a new endpoint to queue a list export
• Saved Searches:
  • Added a new endpoint to fetch saved searches
  • Added a new endpoint to fetch a single saved search
  • Added a new endpoint to execute a saved search and fetch its results
• Exports:
  • Added a new endpoint to fetch the status of an export
• Agents:
  • Added a new endpoint to fetch agents

​

Modifications

• Expanded the list of supported countries for the V2 API to 33 countries
• Corrected the response documentation across the V2 Company and Legal Entity endpoints (identifier countryCode field, request body vs. query parameters, and pagination caps).

​

Additions

• Company:
  • Added a new endpoint to fetch company updates
  • Added a new endpoint to fetch company updates in bulk
• Legal Entity
  • Added a new endpoint to fetch legal entity updates
  • Added a new endpoint to fetch legal entity updates in bulk

​

Additions

• Company:
  • Added a new endpoint to fetch company contacts
  • Added a new endpoint to fetch company contacts in bulk
  • Added a new endpoint to fetch company contact details
  • Added a new endpoint to fetch company contact details in bulk
  • Added a new endpoint to fetch company lookalikes
  • Added a new endpoint to fetch company lookalikes in bulk
  • Added a new endpoint to fetch company technologies
  • Added a new endpoint to fetch company technologies in bulk
  • Added a new endpoint to fetch company vacancies
  • Added a new endpoint to fetch company vacancies in bulk
  • Added a new endpoint to fetch company legal entities
• Legal Entity
  • Added a new endpoint to fetch legal entity details
  • Added a new endpoint to fetch legal entity details in bulk
  • Added a new endpoint to fetch legal entity financials
  • Added a new endpoint to fetch legal entity financials in bulk
  • Added a new endpoint to fetch legal entity directors
  • Added a new endpoint to fetch legal entity directors in bulk
  • Added a new endpoint to fetch legal entity ownership
  • Added a new endpoint to fetch legal entity ownership in bulk
  • Added a new endpoint to fetch legal entity establishments
  • Added a new endpoint to fetch legal entity establishments in bulk
  • Added a new endpoint to fetch legal entity documents
  • Added a new endpoint to fetch legal entity documents in bulk

​

Additions

• Company:
  • Added a new endpoint to search for companies
  • Added a new endpoint to fetch company details
  • Added a new endpoint to fetch company details in bulk

​

Modifications

• Restructured documentation to distinguish between v1 and v2.

​

Additions

• Company:
  • Added a new endpoint to fetch company details in bulk
  • Added a new endpoint to fetch company financials in bulk
  • Added a new endpoint to fetch company relationships in bulk
  • Added a new endpoint to fetch company lookalikes in bulk
  • Added a new endpoint to fetch company contacts in bulk
  • Added a new endpoint to fetch company contact details in bulk
• Lists:
  • Added a new enpoint to add companies in bulk to a static list
  • Added a new enpoint to add contacts in bulk to a static list
  • Added a new endpoint to queue an export
• Exports:
  • Added a new endpoint to fetch the details of an export

​

Modifications

• Update base URL to https://api.bizzy.ai

​

Additions

• Company:
  • Added a new endpoint to fetch contacts
  • Added a new endpoint to fetch contact details
• Lists:
  • Added a new endpoint to fetch contacts
  • Added a new endpoint to add a contact to a static list

​

Modifications

• Credit usage:
  • Updated the credit usage page to explain contact enrichments.

​

Additions

• Errors are now documented

​

Additions

• Company:
  • Added a new endpoint to search for companies
• Lists:
  • Added a new endpoint to add a company to a static list

​

Additions

• Lists:
  • Added a new endpoint to fetch lists
  • Added a new endpoint to fetch a single list
  • Added a new endpoint to fetch companies from a list