The Valu8 Public API provides programmatic access to company data across multiple countries. You can search for companies using flexible filters, retrieve corporate relationships and group structures, download batch files, and monitor subscription usage.

The API is a REST service that uses URL-based versioning, JWT bearer authentication and returns JSON or xml.

Use v2. All new integrations should target API v2 (/v2/...). Version 2 is the current, fully supported API with the latest features, response models, and documentation. Version 1 (/v1/...) remains available for existing integrations but should not be used for new development.

API Versions

Version	Status	Guidance
v2	Current — use this	Default for all new integrations. Enhanced responses, cursor-based pagination, minified search, batch file access, and expanded relation search. Fully documented in this folder.
v1	Legacy	Maintained for backward compatibility with existing integrations only. Missing batch files, semantic search, v2 relation search parameters, and several response improvements. Do not use for new integrations.

If you are starting a new integration or migrating an existing one, use v2 exclusively. Authentication tokens are interchangeable between versions, but request/response shapes differ — do not mix v1 and v2 endpoints in the same integration.

Base URL

The base URL for accessing our main API server is:

https://api.prod1.valu8group.com

All primary API requests should be directed to this URL for optimal performance and up-to-date data.

Failover Server

In case our primary server becomes unavailable, we offer a failover server to ensure continuity of service. We recommend using the failover server only if the main server is down.

Failover Server Base URL:

https://api.prod2.valu8group.com/

Main categories

All endpoints are prefixed with the API version. Example:

https://api.prod1.valu8group.com/v2/companies

All API references are grouped into several main categories according to their function:

Category	Operations
Authentication	The Authentication endpoints issue JWT access tokens and refresh tokens.
Batches	The Batches endpoints provide access to pre-generated bulk data files for your organization.
Companies	The Companies endpoint allows you to search for companies across multiple countries using filters. You can retrieve detailed company information including registration data, financial statements, LinkedIn data, and metadata timestamps. This is the primary endpoint for both searching for companies as well as fetching data about companies.
Relations	The Relations endpoint retrieves ownership, beneficial ownership, key person roles, and other relationdata for companies.
Userstatistics	The User Statistics endpoint returns current subscription usage information for the authenticated API account
Search-Parameters	The Search-Parameters endpoint returns a JSON list with all available attributes able to be used as search parameters when using the Companies endpoint.

API Health

You can verify the status and health of our API by visiting the following URL:

https://api.prod1.valu8group.com/health

This endpoint provides real-time information about the operational status of the API, ensuring it is running as expected.