Company Addition
Supporting APIs
Company Addition API
Submits a company that is not yet in akta.pro’s database to be added, returning a request ID to track, or the existing company if it is already present.
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 arequest_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-keyrequest header.
Request
Request Parameters
Header Parameters
Your API key.
Must be
application/json.Body Parameters
Name of the company to add. Example:
soliosPrimary 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: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.The existing company’s details when
already_exists is true; otherwise null. See Company Object Fields below.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.Current status of the addition request at submission time. Typically
pending. null when the company already exists.The resolved domain for the submitted company.
Credits consumed by the request. This endpoint is free and always returns
0.00.Company Object Fields
Returned only whenalready_exists is true.
Unique identifier for the company. Pass this as the
company parameter in downstream APIs.Primary website of the company.
Resolved domain of the company.
Company name.
Legal or registered name of the company.
Authorizations
API key obtained from your Akta account.
Body
application/json
Company addition request
Name of the company to add. Example: solios
Primary website URL of the company. Used to disambiguate and resolve the company. Example: https://www.soleosenergy.com/
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=e0cafcb914826d8adc60e5092187e1ca)
.png?fit=max&auto=format&n=tMpg-r-6yeOIk-hz&q=85&s=f214ebe0a940d8aa0f19a709a6bfd7fa)