Two Search API (1.0)

Download OpenAPI specification:Download

Our Search API provides comprehensive company information by querying nationally recognized business registers across our primary service regions.

Regions Covered

United Kingdom, Norway, and Sweden: We leverage publicly available data to deliver accurate and current information. For instance, in the United Kingdom, our search queries data pre-populated from Companies House Companies House,
the official government registry for businesses. Companies House maintains up-to-date records of all registered companies in the UK, ensuring the accuracy and reliability of our search results. For Norway and Sweden we utilise Brreg and Enin.

Note that company data is updated on a weekly basis.

How It Works

When you perform a search through our API, the system responds with a list of companies that match the provided query parameters. The results include each company's legal name and its nationally recognized organization number.

Required Fields for Order Creation

To create an order with Two, you must provide the legal company name and organization number of the buyer’s company. These fields are mandatory for defining the buyer company when placing an order.

Integration with Company Address Lookup

After acquiring the desired company data using the Search API, you can directly use the organization number in a separate call to the lookup company address endpoint to retrieve the company’s registered billing address.

Importance in the Checkout API

As part of our checkout-api (order creation service), the billing address is a required field in our schema. For merchants who may not initially have the company name, organization number, or billing address for their business buyers, starting with the Search API provides an efficient way for your users to directly identify their business.

Example in Action

To see the Search API in action, check out this demo

Environments

Norway

https://no.search.two.inc

UK

https://gb.search.two.inc

Sweden

https://se.search.two.inc

Other countries

Please contact us at support@two.inc to request access to the Search API for the United States and the Netherlands.

Auto-complete service for company name

The Auto-Complete service for company or organization names can be seamlessly integrated into your checkout solution. This service helps users quickly populate the required company name and organization number, which are essential for various operations, such as:

  • Order Creation (Core Flow): Simplify the process by automatically filling in required details.
  • Trade Account Onboarding: Streamline the onboarding process with accurate company data. Note that the onboarding service is optional and not required for order creation.

This service enhances user experience by reducing manual input and ensuring that the information provided is accurate and consistent with our API requirements.

Request
query Parameters
limit
required
integer (Limit)

Number of matches to return.

Example: limit=100
offset
required
integer (Offset)

Starting index of results in an array of matches.

Example: offset=0
q
required
string (Query)

Autocomplete query string.

Example: q=TWO
Responses
200

Company search response

get/search
Request samples
Response samples
application/json
{
  • "data": {
    },
  • "status": "success"
}