Get a company by ID

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieves a full company profile by its Veridion ID.

Run in Postman



What you get

A company profile is Veridion's complete record of a business: identity and names, addresses and contact details, industry classification, size and financials, products and services, technologies, and the rest of the firmographic dataset.

📖

What a Veridion ID is

A veridion_id is the unique identifier assigned to a company within the Veridion universe. It serves as a primary key, so each company can be referenced without ambiguity across every Veridion product.

Where a Veridion ID comes from

You cannot search for a company here. This endpoint retrieves a company you can already identify, so you need an ID from one of the products that produce them:

  • the Match & Enrich API, which resolves the details you hold about a company to a Veridion record;
  • the Search API, which returns the companies matching a set of criteria;
  • the Location Intelligence API, where every location references the company operating there by ID rather than carrying its profile.

More generally, any Veridion API that references a company by ID instead of returning the full profile is a source of IDs you can pass here.

👍

Refreshing a profile without re-matching

This is the main reason to call this endpoint even when you have access to Match & Enrich or Search.

Once you hold a company's veridion_id, resolving the company again is not mandatory. To pick up refreshed data, retrieve the profile directly by ID rather than re-running a match or a search.


Successful response

A successful request returns 200 OK with the company profile, returned directly rather than wrapped in an envelope.

The profile is identical in shape to the one returned by the Match & Enrich API, so a company retrieved by ID and a company resolved from a match can be handled by the same code.

📘

No resolution object

Unlike a match response, this endpoint returns no resolution object. There is no scenario, confidence score, or matched attributes, because nothing was matched. You asked for a specific company by ID and received it.

📖

Response fields

For a comprehensive list of all data points returned on a company profile, see the Response fields and types page.

Error responses

  • 404 Not Found, if no company exists for the given ID.
  • other standard HTTP error responses, detailed in the Response codes section.

Any error response follows a specific structure. Please see the Error response format section for more details.

Path Params
string
required

The Veridion ID of the company.

Headers
string
required

Your individual OAuth Bearer token (e.g. Authorization: Bearer <your_access_token>).

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json