Request Status
curl --request GET \
--url https://api.akta.pro/api/v1/status/{request_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.akta.pro/api/v1/status/{request_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.akta.pro/api/v1/status/{request_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.akta.pro/api/v1/status/{request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/status/{request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.akta.pro/api/v1/status/{request_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/status/{request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"request_id": "a16f1790-9bbc-45d1-8bc7-86281ab7a9a3",
"request_type": "company_addition",
"detail": {
"company_name": "Simile",
"domain": "simile.com",
"status": "pending",
"reason": null,
"company_uuid": "005o6s3",
"created_at": "2026-08-21T04:52:42.066260Z",
"updated_at": "2026-08-21T04:52:46.302452Z"
}
}
Supporting APIs
Request Status API
Returns the current status of an asynchronous request, such as a company addition request, by its request ID.
GET
/
v1
/
status
/
{request_id}
Request Status
curl --request GET \
--url https://api.akta.pro/api/v1/status/{request_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.akta.pro/api/v1/status/{request_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.akta.pro/api/v1/status/{request_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.akta.pro/api/v1/status/{request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/status/{request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.akta.pro/api/v1/status/{request_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/status/{request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"request_id": "a16f1790-9bbc-45d1-8bc7-86281ab7a9a3",
"request_type": "company_addition",
"detail": {
"company_name": "Simile",
"domain": "simile.com",
"status": "pending",
"reason": null,
"company_uuid": "005o6s3",
"created_at": "2026-08-21T04:52:42.066260Z",
"updated_at": "2026-08-21T04:52:46.302452Z"
}
}
Overview
The Request Status API returns the current status of an asynchronous request by itsrequest_id. Use it to poll a long-running request such as a Company Addition request until it completes. The response includes the top-level request status along with a detail object carrying request-type-specific fields. This is a free endpoint and does not consume credits.
As an alternative to polling this endpoint, you can configure a webhook to be notified automatically when a request’s status changes.
Endpoint Details
- Method: GET
- Endpoint:
/api/v1/status/{request_id}/
Authentication requirements
- Include a valid API key in the
x-api-keyrequest header.
Request
Request Parameters
Header Parameters
string
required
Your API key.
Path Parameters
string
required
The unique identifier of the request to check, returned when the original request was submitted. Example:
2db01b38-5c81-4b3f-b76d-8b36aeed603bResponse
Successful Response Fields
Returns a JSON object with the following structure:string
Unique identifier of the request being tracked.
string
The type of request. Example:
company_addition.object
Request-type-specific details. Fields vary by
request_type. See Detail Object Fields below for a company addition request.Detail Object Fields
Fields for acompany_addition request.
string
Name of the company submitted for addition.
string
Resolved domain of the submitted company.
string
Status of the request submitted.
string
Explanation when the request did not succeed.
null unless the request has failed.string
Akta UUID of the company once it has been added.
null until the request is completed. Pass this as the company parameter in downstream APIs.string
Timestamp when the underlying request was created, in ISO 8601 format.
string
Timestamp when the underlying request was last updated, in ISO 8601 format.
{
"request_id": "a16f1790-9bbc-45d1-8bc7-86281ab7a9a3",
"request_type": "company_addition",
"detail": {
"company_name": "Simile",
"domain": "simile.com",
"status": "pending",
"reason": null,
"company_uuid": "005o6s3",
"created_at": "2026-08-21T04:52:42.066260Z",
"updated_at": "2026-08-21T04:52:46.302452Z"
}
}
Authorizations
API key obtained from your Akta account.
Path Parameters
The unique identifier of the request to check, returned when the original request was submitted. Example: 2db01b38-5c81-4b3f-b76d-8b36aeed603b
.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)