Get Filter Options
curl --request POST \
--url https://api.akta.pro/api/v1/filters/options/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"dropdowns": [
{
"dropdown_type": "<string>"
}
]
}
'import requests
url = "https://api.akta.pro/api/v1/filters/options/"
payload = { "dropdowns": [{ "dropdown_type": "<string>" }] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({dropdowns: [{dropdown_type: '<string>'}]})
};
fetch('https://api.akta.pro/api/v1/filters/options/', 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/filters/options/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'dropdowns' => [
[
'dropdown_type' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/filters/options/"
payload := strings.NewReader("{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.akta.pro/api/v1/filters/options/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/filters/options/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"firmographic.company_type": [
{ "value": "private", "label": "Private" },
{ "value": "public", "label": "Public" }
]
},
"credits_consumed": 0.00
}
Supporting APIs
Filter Options API
Returns the available options for one or more specific List Generation filter fields.
POST
/
v1
/
filters
/
options
/
Get Filter Options
curl --request POST \
--url https://api.akta.pro/api/v1/filters/options/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"dropdowns": [
{
"dropdown_type": "<string>"
}
]
}
'import requests
url = "https://api.akta.pro/api/v1/filters/options/"
payload = { "dropdowns": [{ "dropdown_type": "<string>" }] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({dropdowns: [{dropdown_type: '<string>'}]})
};
fetch('https://api.akta.pro/api/v1/filters/options/', 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/filters/options/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'dropdowns' => [
[
'dropdown_type' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.akta.pro/api/v1/filters/options/"
payload := strings.NewReader("{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.akta.pro/api/v1/filters/options/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.akta.pro/api/v1/filters/options/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dropdowns\": [\n {\n \"dropdown_type\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"firmographic.company_type": [
{ "value": "private", "label": "Private" },
{ "value": "public", "label": "Public" }
]
},
"credits_consumed": 0.00
}
Overview
The Get Filter Options API returns the selectable values for one or more filter fields, given a list ofdropdown_type names. Pass the filter field names — the same field values returned by the Get Filters List API — and get back the options available for each one. This is a free endpoint and does not consume credits. Results are returned in the API response.
Endpoint Details
- Method: POST
- Endpoint:
/api/v1/filters/options/
Authentication requirements
- Include a valid API key in the
x-api-keyrequest header.
Request
Request Parameters
Header Parameters
string
required
Your API key.
Body Parameters
object[]
required
Array of objects, one per filter you want options for. Each object has a single
dropdown_type key — a filter field name from the Get Filters List API (e.g. firmographic.company_type).To fetch options for every filter in one call, pass one object per filter field:{
"dropdowns": [
{"dropdown_type": "firmographic.company_type"},
{"dropdown_type": "firmographic.ownership_category"},
{"dropdown_type": "firmographic.operating_status"},
{"dropdown_type": "funding_detail.funding_overview.funding_stage"},
{"dropdown_type": "financial_estimate.revenue_estimate"},
{"dropdown_type": "financial_estimate.valuation_estimate"},
{"dropdown_type": "location.hq.region"},
{"dropdown_type": "location.hq.country"},
{"dropdown_type": "business_model.gtm_type"},
{"dropdown_type": "business_model.gtm_motion"},
{"dropdown_type": "business_model.offering_type"},
{"dropdown_type": "company_assessment.customer_concentration.classification"},
{"dropdown_type": "technology.ai_maturity.scale"},
{"dropdown_type": "business_model.revenue_model"},
{"dropdown_type": "company_assessment.competitive_moat"},
{"dropdown_type": "location.market_served.markets.country"},
{"dropdown_type": "location.offices.country"},
{"dropdown_type": "strategic_signal.partnership.type"}
]
}
Example Request
POST /v1/filters/options
x-api-key: <your_api_key>
Content-Type: application/json
{"dropdowns":[{"dropdown_type":"firmographic.company_type"}]}
Response
Successful Response Fields
Returns a JSON object with the following structure:object
Options keyed by the
dropdown_type requested. Each value is an array of option objects for that filter. See Option Object below.float
Credits consumed by the request. This endpoint is free and always returns
0.00.Option Object
string
The value to pass in
filters when calling the List Generation API.string
Human-readable label for the value, suitable for displaying in a UI dropdown.
{
"data": {
"firmographic.company_type": [
{ "value": "private", "label": "Private" },
{ "value": "public", "label": "Public" }
]
},
"credits_consumed": 0.00
}
OpenAPI
POST /v1/filters/options
openapi: 3.0.3
info:
title: Akta.pro API
version: 1.0.0
contact:
url: https://akta.pro
servers:
- url: https://api.akta.pro/api
description: Production server
security: []
tags:
- name: List Generation
description: Build targeted company lists using structured filters
paths:
/v1/filters/options:
post:
tags:
- List Generation
summary: Get Filter Options
description: >
Returns the available options for one or more specific List Generation
filter fields, given a list of dropdown_type names.
This is a free endpoint — it does not consume API credits.
operationId: getFilterOptions
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- dropdowns
properties:
dropdowns:
type: array
items:
type: object
required:
- dropdown_type
properties:
dropdown_type:
type: string
description: A filter field name, as returned by the Get Filters List API.
example:
dropdowns:
- dropdown_type: firmographic.company_type
responses:
'200':
description: Filter options returned
content:
application/json:
schema:
type: object
properties:
data:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/FilterOption'
credits_consumed:
type: number
format: float
example: 0
'400':
description: Bad request — missing or malformed dropdowns array.
'401':
description: Unauthorized — missing or invalid API key.
security:
- xApiKeyAuth: []
components:
schemas:
FilterOption:
type: object
properties:
value:
type: string
description: The value to pass in `filters` when calling the List Generation API.
label:
type: string
description: Human-readable label for the value.
securitySchemes:
xApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key obtained from your Akta account.
Authorizations
API key obtained from your Akta account.
Body
application/json
Array of filter fields to look up. Each object has a single dropdown_type key.
Show child attributes
Show child attributes
.png?fit=max&auto=format&n=SdGZnb5iGLBOelR9&q=85&s=6e183af2c7498a76797d0c8d9a81b986)
.png?fit=max&auto=format&n=SdGZnb5iGLBOelR9&q=85&s=7702c636c517001e39df24a084a9728d)