Skip to main content
POST
Company Addition

Overview

The Company Addition API lets you add a company that isn’t yet in akta.pro’s database. Submit a company name and website, and if the company is new, an addition request is created and a request_id is returned so you can track it to completion (by polling the status endpoint or configuring a webhook). If the company already exists, no request is created and the existing company’s details are returned directly. This is a free endpoint and does not consume credits.

Endpoint Details

  • Method: POST
  • Endpoint: /v1/company/addition-requests

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

Header Parameters

x-api-key
string
required
Your API key.
Content-Type
string
required
Must be application/json.

Body Parameters

company_name
string
required
Name of the company to add. Example: solios
website
string
required
Primary website URL of the company. Used to disambiguate and resolve the company. Example: https://www.soleosenergy.com/

Response

Successful Response Fields

Returns a JSON object with the following structure:
already_exists
boolean
true if the company is already in the database, in which case no addition request is created. false if a new addition request was created.
company
object
The existing company’s details when already_exists is true; otherwise null. See Company Object Fields below.
request_id
string
Unique identifier for the addition request, in UUID format. Use this to check request status or match webhook notifications. null when the company already exists.
status
string
Current status of the addition request at submission time. Typically pending. null when the company already exists.
domain
string
The resolved domain for the submitted company.
credits_consumed
float
Credits consumed by the request. This endpoint is free and always returns 0.00.

Company Object Fields

Returned only when already_exists is true.
uuid
string
Unique identifier for the company. Pass this as the company parameter in downstream APIs.
website
string
Primary website of the company.
domain
string
Resolved domain of the company.
name
string
Company name.
Legal or registered name of the company.

Authorizations

x-api-key
string
header
required

API key obtained from your Akta account.

Body

application/json

Company addition request

company_name
string
required

Name of the company to add. Example: solios

website
string
required

Primary website URL of the company. Used to disambiguate and resolve the company. Example: https://www.soleosenergy.com/

Response

Company addition response

status
string
Example:

"success"

data
object
credits_consumed
number<float>
Example:

0