Company API (0.9.0)

Download OpenAPI specification:Download

DISCLAIMER: This API is in beta stage and may change in the future.

The Company Information API provides comprehensive company information by querying nationally recognized business registers across our primary service regions.

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 together with a lookup_id that can be used to get more detailed information by calling the Get Company endpoint.

Referencing a company across Two's APIs

When looking up a company with the Get Company endpoint, the canonical_id field of the returned company objects represents the "canonical company ID", which can be used across Two's portfolio of APIs when a company needs to be referenced. An example of this is the create order endpoint, requiring a reference to the buyer company.

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.

Company

Get Company

Get full details on a company, given a company's lookup_id or canonical_id.

The result will include company's canonical_id, which is 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.

The result includes additional information that cannot be obtained from the Company Search alone.

Securityapi-key
Request
path Parameters
id
required
string (Id)
Responses
200

Successful Response

404

Company with this ID is not found

422

Validation Error

get/company/{id}
Request samples
Response samples
application/json
{
  • "name": "MONOZUKI AS",
  • "country": "US",
  • "national_identifier": {
    },
  • "identifiers": [
    ],
  • "addresses": [
    ],
  • "canonical_id": "NO817352812"
}