Filter companies

curl --request POST \
  --url https://global-api.thedatacity.com/v1/us/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "NAICS": [
    "<string>"
  ],
  "Name": "<string>",
  "Country": "<string>",
  "EmployeeRange": "<string>",
  "LegalForm": "<string>",
  "LegalForms": [
    "<string>"
  ],
  "HQPostcode": "<string>",
  "DateOfIncorporation": "2023-12-25",
  "IncorporationDateFrom": "2023-12-25",
  "IncorporationDateTo": "2023-12-25",
  "HasWebsite": true,
  "OperatingLocationAddresses": [
    "<string>"
  ],
  "MinTurnover": 4611686018427388000,
  "MaxTurnover": 4611686018427388000,
  "MinEBIT": 0,
  "MaxEBIT": 0,
  "MinNetIncome": 0,
  "MaxNetIncome": 0,
  "FinancialYearEnding": 123,
  "MinFinancialYearEnding": 123,
  "MaxFinancialYearEnding": 123,
  "AccountsType": "<string>",
  "RTICs": [
    "<string>"
  ],
  "RNAICS": [
    "<string>"
  ],
  "State": [
    "<string>"
  ],
  "Zipcode": [
    "<string>"
  ],
  "Town": [
    "<string>"
  ],
  "Director": {
    "LocalPnr": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "DateOfBirth": "2023-12-25",
    "FullName": "<string>"
  },
  "LowerLatitude": 0,
  "UpperLatitude": 0,
  "LowerLongitude": 0,
  "UpperLongitude": 0,
  "HasWebText": true,
  "Includes": [
    "<string>"
  ],
  "Excludes": [
    "<string>"
  ],
  "WebTextPositiveKeywords": [
    "<string>"
  ],
  "WebTextPositiveKeywordsOperator": "<string>",
  "WebTextPositiveKeywordsMode": "<string>",
  "WebTextNegativeKeywords": [
    "<string>"
  ],
  "WebTextNegativeKeywordsOperator": "<string>",
  "WebTextNegativeKeywordsMode": "<string>",
  "IncludeInsights": true,
  "IncludeTotalCount": true,
  "IncludesLocations": true,
  "Limit": 500,
  "Offset": 1073741823,
  "SortBy": [
    {
      "Field": "<string>",
      "Direction": "<string>"
    }
  ]
}
'

import requests

url = "https://global-api.thedatacity.com/v1/us/companies"

payload = {
    "NAICS": ["<string>"],
    "Name": "<string>",
    "Country": "<string>",
    "EmployeeRange": "<string>",
    "LegalForm": "<string>",
    "LegalForms": ["<string>"],
    "HQPostcode": "<string>",
    "DateOfIncorporation": "2023-12-25",
    "IncorporationDateFrom": "2023-12-25",
    "IncorporationDateTo": "2023-12-25",
    "HasWebsite": True,
    "OperatingLocationAddresses": ["<string>"],
    "MinTurnover": 4611686018427388000,
    "MaxTurnover": 4611686018427388000,
    "MinEBIT": 0,
    "MaxEBIT": 0,
    "MinNetIncome": 0,
    "MaxNetIncome": 0,
    "FinancialYearEnding": 123,
    "MinFinancialYearEnding": 123,
    "MaxFinancialYearEnding": 123,
    "AccountsType": "<string>",
    "RTICs": ["<string>"],
    "RNAICS": ["<string>"],
    "State": ["<string>"],
    "Zipcode": ["<string>"],
    "Town": ["<string>"],
    "Director": {
        "LocalPnr": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "DateOfBirth": "2023-12-25",
        "FullName": "<string>"
    },
    "LowerLatitude": 0,
    "UpperLatitude": 0,
    "LowerLongitude": 0,
    "UpperLongitude": 0,
    "HasWebText": True,
    "Includes": ["<string>"],
    "Excludes": ["<string>"],
    "WebTextPositiveKeywords": ["<string>"],
    "WebTextPositiveKeywordsOperator": "<string>",
    "WebTextPositiveKeywordsMode": "<string>",
    "WebTextNegativeKeywords": ["<string>"],
    "WebTextNegativeKeywordsOperator": "<string>",
    "WebTextNegativeKeywordsMode": "<string>",
    "IncludeInsights": True,
    "IncludeTotalCount": True,
    "IncludesLocations": True,
    "Limit": 500,
    "Offset": 1073741823,
    "SortBy": [
        {
            "Field": "<string>",
            "Direction": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    NAICS: ['<string>'],
    Name: '<string>',
    Country: '<string>',
    EmployeeRange: '<string>',
    LegalForm: '<string>',
    LegalForms: ['<string>'],
    HQPostcode: '<string>',
    DateOfIncorporation: '2023-12-25',
    IncorporationDateFrom: '2023-12-25',
    IncorporationDateTo: '2023-12-25',
    HasWebsite: true,
    OperatingLocationAddresses: ['<string>'],
    MinTurnover: 4611686018427388000,
    MaxTurnover: 4611686018427388000,
    MinEBIT: 0,
    MaxEBIT: 0,
    MinNetIncome: 0,
    MaxNetIncome: 0,
    FinancialYearEnding: 123,
    MinFinancialYearEnding: 123,
    MaxFinancialYearEnding: 123,
    AccountsType: '<string>',
    RTICs: ['<string>'],
    RNAICS: ['<string>'],
    State: ['<string>'],
    Zipcode: ['<string>'],
    Town: ['<string>'],
    Director: {
      LocalPnr: '<string>',
      FirstName: '<string>',
      LastName: '<string>',
      DateOfBirth: '2023-12-25',
      FullName: '<string>'
    },
    LowerLatitude: 0,
    UpperLatitude: 0,
    LowerLongitude: 0,
    UpperLongitude: 0,
    HasWebText: true,
    Includes: ['<string>'],
    Excludes: ['<string>'],
    WebTextPositiveKeywords: ['<string>'],
    WebTextPositiveKeywordsOperator: '<string>',
    WebTextPositiveKeywordsMode: '<string>',
    WebTextNegativeKeywords: ['<string>'],
    WebTextNegativeKeywordsOperator: '<string>',
    WebTextNegativeKeywordsMode: '<string>',
    IncludeInsights: true,
    IncludeTotalCount: true,
    IncludesLocations: true,
    Limit: 500,
    Offset: 1073741823,
    SortBy: [{Field: '<string>', Direction: '<string>'}]
  })
};

fetch('https://global-api.thedatacity.com/v1/us/companies', 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://global-api.thedatacity.com/v1/us/companies",
  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([
    'NAICS' => [
        '<string>'
    ],
    'Name' => '<string>',
    'Country' => '<string>',
    'EmployeeRange' => '<string>',
    'LegalForm' => '<string>',
    'LegalForms' => [
        '<string>'
    ],
    'HQPostcode' => '<string>',
    'DateOfIncorporation' => '2023-12-25',
    'IncorporationDateFrom' => '2023-12-25',
    'IncorporationDateTo' => '2023-12-25',
    'HasWebsite' => true,
    'OperatingLocationAddresses' => [
        '<string>'
    ],
    'MinTurnover' => 4611686018427388000,
    'MaxTurnover' => 4611686018427388000,
    'MinEBIT' => 0,
    'MaxEBIT' => 0,
    'MinNetIncome' => 0,
    'MaxNetIncome' => 0,
    'FinancialYearEnding' => 123,
    'MinFinancialYearEnding' => 123,
    'MaxFinancialYearEnding' => 123,
    'AccountsType' => '<string>',
    'RTICs' => [
        '<string>'
    ],
    'RNAICS' => [
        '<string>'
    ],
    'State' => [
        '<string>'
    ],
    'Zipcode' => [
        '<string>'
    ],
    'Town' => [
        '<string>'
    ],
    'Director' => [
        'LocalPnr' => '<string>',
        'FirstName' => '<string>',
        'LastName' => '<string>',
        'DateOfBirth' => '2023-12-25',
        'FullName' => '<string>'
    ],
    'LowerLatitude' => 0,
    'UpperLatitude' => 0,
    'LowerLongitude' => 0,
    'UpperLongitude' => 0,
    'HasWebText' => true,
    'Includes' => [
        '<string>'
    ],
    'Excludes' => [
        '<string>'
    ],
    'WebTextPositiveKeywords' => [
        '<string>'
    ],
    'WebTextPositiveKeywordsOperator' => '<string>',
    'WebTextPositiveKeywordsMode' => '<string>',
    'WebTextNegativeKeywords' => [
        '<string>'
    ],
    'WebTextNegativeKeywordsOperator' => '<string>',
    'WebTextNegativeKeywordsMode' => '<string>',
    'IncludeInsights' => true,
    'IncludeTotalCount' => true,
    'IncludesLocations' => true,
    'Limit' => 500,
    'Offset' => 1073741823,
    'SortBy' => [
        [
                'Field' => '<string>',
                'Direction' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://global-api.thedatacity.com/v1/us/companies"

	payload := strings.NewReader("{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://global-api.thedatacity.com/v1/us/companies")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://global-api.thedatacity.com/v1/us/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "Companies": [
    {
      "CompanyNumber": "<string>",
      "Description": "<string>",
      "LegalForm": "<string>",
      "EmployeeRange": "<string>",
      "RTICs": [
        {
          "CompanyNumber": "<string>",
          "SectorCode": "<string>",
          "SectorName": "<string>",
          "VerticalCode": "<string>",
          "VerticalName": "<string>",
          "Score": 123,
          "WordsMatched": 123,
          "Name": "<string>"
        }
      ],
      "LogoURL": "<string>",
      "ScreenshotURL": "<string>",
      "OperatingLocationsCount": 123,
      "Name": "<string>",
      "Website": "<string>",
      "Country": "<string>",
      "Address": "<string>",
      "Town": "<string>",
      "State": "<string>",
      "Phone": "<string>",
      "RegNumber": "<string>",
      "Zipcode": "<string>",
      "Latitude": 123,
      "Longitude": 123,
      "CompaniesInGroup": [
        {
          "CompanyNumber": "<string>",
          "Name": "<string>",
          "Website": "<string>",
          "Description": "<string>",
          "Country": "<string>",
          "Address": "<string>",
          "Town": "<string>",
          "State": "<string>",
          "Phone": "<string>",
          "RegNumber": "<string>",
          "Zipcode": "<string>",
          "Latitude": 123,
          "Longitude": 123,
          "LegalForm": "<string>",
          "EmployeeRange": "<string>",
          "Employees": 123,
          "Turnover": 123,
          "FinancesByYear": [
            {
              "YearEnding": 123,
              "AccountsDate": "2023-12-25",
              "AccountsType": "<string>",
              "Turnover": 123,
              "EBIT": 123,
              "NetIncome": 123,
              "EmployeesHere": 123,
              "EmployeesTotal": 123
            }
          ],
          "LogoURL": "<string>",
          "ParentCompanyNumber": "<string>",
          "ParentCompanyName": "<string>",
          "ActivityCode": "<string>",
          "ActivityCodeName": "<string>",
          "SicCode": "<string>",
          "SicCodeName": "<string>",
          "NAICS": [
            "<string>"
          ]
        }
      ],
      "Employees": 123,
      "EmployeesTotal": 123,
      "Turnover": 123,
      "FinancesByYear": [
        {
          "YearEnding": 123,
          "AccountsDate": "2023-12-25",
          "AccountsType": "<string>",
          "Turnover": 123,
          "EBIT": 123,
          "NetIncome": 123,
          "EmployeesHere": 123,
          "EmployeesTotal": 123
        }
      ],
      "BestEstimateGrowthPercentagePerYear": 123,
      "Directors": [
        {
          "FirstName": "<string>",
          "LastName": "<string>",
          "FullName": "<string>",
          "LocalPnr": "<string>",
          "DateOfBirth": "2023-12-25",
          "DateOfChange": "2023-12-25",
          "Active": true,
          "Position": "<string>",
          "Gender": "<string>",
          "Language": "<string>"
        }
      ],
      "ActivityCode": "<string>",
      "ActivityCodeName": "<string>",
      "SicCode": "<string>",
      "SicCodeName": "<string>",
      "NAICS": [
        "<string>"
      ],
      "RNAICS": [
        {
          "CompanyNumber": "<string>",
          "Code": "<string>",
          "Name": "<string>",
          "Score": 123
        }
      ],
      "SimilarCompanies": [
        {
          "CompanyNumber": "<string>",
          "SimilarityScore": 123
        }
      ]
    }
  ],
  "Insights": {
    "EmployeeRanges": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "LegalForms": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "IncorporationDates": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "RTICs": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "NAICS": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "Employees": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "Turnover": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "States": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "RNAICS": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ]
  },
  "TotalCount": 123
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

POST

companies

Filter companies

curl --request POST \
  --url https://global-api.thedatacity.com/v1/us/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "NAICS": [
    "<string>"
  ],
  "Name": "<string>",
  "Country": "<string>",
  "EmployeeRange": "<string>",
  "LegalForm": "<string>",
  "LegalForms": [
    "<string>"
  ],
  "HQPostcode": "<string>",
  "DateOfIncorporation": "2023-12-25",
  "IncorporationDateFrom": "2023-12-25",
  "IncorporationDateTo": "2023-12-25",
  "HasWebsite": true,
  "OperatingLocationAddresses": [
    "<string>"
  ],
  "MinTurnover": 4611686018427388000,
  "MaxTurnover": 4611686018427388000,
  "MinEBIT": 0,
  "MaxEBIT": 0,
  "MinNetIncome": 0,
  "MaxNetIncome": 0,
  "FinancialYearEnding": 123,
  "MinFinancialYearEnding": 123,
  "MaxFinancialYearEnding": 123,
  "AccountsType": "<string>",
  "RTICs": [
    "<string>"
  ],
  "RNAICS": [
    "<string>"
  ],
  "State": [
    "<string>"
  ],
  "Zipcode": [
    "<string>"
  ],
  "Town": [
    "<string>"
  ],
  "Director": {
    "LocalPnr": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "DateOfBirth": "2023-12-25",
    "FullName": "<string>"
  },
  "LowerLatitude": 0,
  "UpperLatitude": 0,
  "LowerLongitude": 0,
  "UpperLongitude": 0,
  "HasWebText": true,
  "Includes": [
    "<string>"
  ],
  "Excludes": [
    "<string>"
  ],
  "WebTextPositiveKeywords": [
    "<string>"
  ],
  "WebTextPositiveKeywordsOperator": "<string>",
  "WebTextPositiveKeywordsMode": "<string>",
  "WebTextNegativeKeywords": [
    "<string>"
  ],
  "WebTextNegativeKeywordsOperator": "<string>",
  "WebTextNegativeKeywordsMode": "<string>",
  "IncludeInsights": true,
  "IncludeTotalCount": true,
  "IncludesLocations": true,
  "Limit": 500,
  "Offset": 1073741823,
  "SortBy": [
    {
      "Field": "<string>",
      "Direction": "<string>"
    }
  ]
}
'

import requests

url = "https://global-api.thedatacity.com/v1/us/companies"

payload = {
    "NAICS": ["<string>"],
    "Name": "<string>",
    "Country": "<string>",
    "EmployeeRange": "<string>",
    "LegalForm": "<string>",
    "LegalForms": ["<string>"],
    "HQPostcode": "<string>",
    "DateOfIncorporation": "2023-12-25",
    "IncorporationDateFrom": "2023-12-25",
    "IncorporationDateTo": "2023-12-25",
    "HasWebsite": True,
    "OperatingLocationAddresses": ["<string>"],
    "MinTurnover": 4611686018427388000,
    "MaxTurnover": 4611686018427388000,
    "MinEBIT": 0,
    "MaxEBIT": 0,
    "MinNetIncome": 0,
    "MaxNetIncome": 0,
    "FinancialYearEnding": 123,
    "MinFinancialYearEnding": 123,
    "MaxFinancialYearEnding": 123,
    "AccountsType": "<string>",
    "RTICs": ["<string>"],
    "RNAICS": ["<string>"],
    "State": ["<string>"],
    "Zipcode": ["<string>"],
    "Town": ["<string>"],
    "Director": {
        "LocalPnr": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "DateOfBirth": "2023-12-25",
        "FullName": "<string>"
    },
    "LowerLatitude": 0,
    "UpperLatitude": 0,
    "LowerLongitude": 0,
    "UpperLongitude": 0,
    "HasWebText": True,
    "Includes": ["<string>"],
    "Excludes": ["<string>"],
    "WebTextPositiveKeywords": ["<string>"],
    "WebTextPositiveKeywordsOperator": "<string>",
    "WebTextPositiveKeywordsMode": "<string>",
    "WebTextNegativeKeywords": ["<string>"],
    "WebTextNegativeKeywordsOperator": "<string>",
    "WebTextNegativeKeywordsMode": "<string>",
    "IncludeInsights": True,
    "IncludeTotalCount": True,
    "IncludesLocations": True,
    "Limit": 500,
    "Offset": 1073741823,
    "SortBy": [
        {
            "Field": "<string>",
            "Direction": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    NAICS: ['<string>'],
    Name: '<string>',
    Country: '<string>',
    EmployeeRange: '<string>',
    LegalForm: '<string>',
    LegalForms: ['<string>'],
    HQPostcode: '<string>',
    DateOfIncorporation: '2023-12-25',
    IncorporationDateFrom: '2023-12-25',
    IncorporationDateTo: '2023-12-25',
    HasWebsite: true,
    OperatingLocationAddresses: ['<string>'],
    MinTurnover: 4611686018427388000,
    MaxTurnover: 4611686018427388000,
    MinEBIT: 0,
    MaxEBIT: 0,
    MinNetIncome: 0,
    MaxNetIncome: 0,
    FinancialYearEnding: 123,
    MinFinancialYearEnding: 123,
    MaxFinancialYearEnding: 123,
    AccountsType: '<string>',
    RTICs: ['<string>'],
    RNAICS: ['<string>'],
    State: ['<string>'],
    Zipcode: ['<string>'],
    Town: ['<string>'],
    Director: {
      LocalPnr: '<string>',
      FirstName: '<string>',
      LastName: '<string>',
      DateOfBirth: '2023-12-25',
      FullName: '<string>'
    },
    LowerLatitude: 0,
    UpperLatitude: 0,
    LowerLongitude: 0,
    UpperLongitude: 0,
    HasWebText: true,
    Includes: ['<string>'],
    Excludes: ['<string>'],
    WebTextPositiveKeywords: ['<string>'],
    WebTextPositiveKeywordsOperator: '<string>',
    WebTextPositiveKeywordsMode: '<string>',
    WebTextNegativeKeywords: ['<string>'],
    WebTextNegativeKeywordsOperator: '<string>',
    WebTextNegativeKeywordsMode: '<string>',
    IncludeInsights: true,
    IncludeTotalCount: true,
    IncludesLocations: true,
    Limit: 500,
    Offset: 1073741823,
    SortBy: [{Field: '<string>', Direction: '<string>'}]
  })
};

fetch('https://global-api.thedatacity.com/v1/us/companies', 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://global-api.thedatacity.com/v1/us/companies",
  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([
    'NAICS' => [
        '<string>'
    ],
    'Name' => '<string>',
    'Country' => '<string>',
    'EmployeeRange' => '<string>',
    'LegalForm' => '<string>',
    'LegalForms' => [
        '<string>'
    ],
    'HQPostcode' => '<string>',
    'DateOfIncorporation' => '2023-12-25',
    'IncorporationDateFrom' => '2023-12-25',
    'IncorporationDateTo' => '2023-12-25',
    'HasWebsite' => true,
    'OperatingLocationAddresses' => [
        '<string>'
    ],
    'MinTurnover' => 4611686018427388000,
    'MaxTurnover' => 4611686018427388000,
    'MinEBIT' => 0,
    'MaxEBIT' => 0,
    'MinNetIncome' => 0,
    'MaxNetIncome' => 0,
    'FinancialYearEnding' => 123,
    'MinFinancialYearEnding' => 123,
    'MaxFinancialYearEnding' => 123,
    'AccountsType' => '<string>',
    'RTICs' => [
        '<string>'
    ],
    'RNAICS' => [
        '<string>'
    ],
    'State' => [
        '<string>'
    ],
    'Zipcode' => [
        '<string>'
    ],
    'Town' => [
        '<string>'
    ],
    'Director' => [
        'LocalPnr' => '<string>',
        'FirstName' => '<string>',
        'LastName' => '<string>',
        'DateOfBirth' => '2023-12-25',
        'FullName' => '<string>'
    ],
    'LowerLatitude' => 0,
    'UpperLatitude' => 0,
    'LowerLongitude' => 0,
    'UpperLongitude' => 0,
    'HasWebText' => true,
    'Includes' => [
        '<string>'
    ],
    'Excludes' => [
        '<string>'
    ],
    'WebTextPositiveKeywords' => [
        '<string>'
    ],
    'WebTextPositiveKeywordsOperator' => '<string>',
    'WebTextPositiveKeywordsMode' => '<string>',
    'WebTextNegativeKeywords' => [
        '<string>'
    ],
    'WebTextNegativeKeywordsOperator' => '<string>',
    'WebTextNegativeKeywordsMode' => '<string>',
    'IncludeInsights' => true,
    'IncludeTotalCount' => true,
    'IncludesLocations' => true,
    'Limit' => 500,
    'Offset' => 1073741823,
    'SortBy' => [
        [
                'Field' => '<string>',
                'Direction' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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://global-api.thedatacity.com/v1/us/companies"

	payload := strings.NewReader("{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://global-api.thedatacity.com/v1/us/companies")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://global-api.thedatacity.com/v1/us/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"NAICS\": [\n    \"<string>\"\n  ],\n  \"Name\": \"<string>\",\n  \"Country\": \"<string>\",\n  \"EmployeeRange\": \"<string>\",\n  \"LegalForm\": \"<string>\",\n  \"LegalForms\": [\n    \"<string>\"\n  ],\n  \"HQPostcode\": \"<string>\",\n  \"DateOfIncorporation\": \"2023-12-25\",\n  \"IncorporationDateFrom\": \"2023-12-25\",\n  \"IncorporationDateTo\": \"2023-12-25\",\n  \"HasWebsite\": true,\n  \"OperatingLocationAddresses\": [\n    \"<string>\"\n  ],\n  \"MinTurnover\": 4611686018427388000,\n  \"MaxTurnover\": 4611686018427388000,\n  \"MinEBIT\": 0,\n  \"MaxEBIT\": 0,\n  \"MinNetIncome\": 0,\n  \"MaxNetIncome\": 0,\n  \"FinancialYearEnding\": 123,\n  \"MinFinancialYearEnding\": 123,\n  \"MaxFinancialYearEnding\": 123,\n  \"AccountsType\": \"<string>\",\n  \"RTICs\": [\n    \"<string>\"\n  ],\n  \"RNAICS\": [\n    \"<string>\"\n  ],\n  \"State\": [\n    \"<string>\"\n  ],\n  \"Zipcode\": [\n    \"<string>\"\n  ],\n  \"Town\": [\n    \"<string>\"\n  ],\n  \"Director\": {\n    \"LocalPnr\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"DateOfBirth\": \"2023-12-25\",\n    \"FullName\": \"<string>\"\n  },\n  \"LowerLatitude\": 0,\n  \"UpperLatitude\": 0,\n  \"LowerLongitude\": 0,\n  \"UpperLongitude\": 0,\n  \"HasWebText\": true,\n  \"Includes\": [\n    \"<string>\"\n  ],\n  \"Excludes\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextPositiveKeywordsOperator\": \"<string>\",\n  \"WebTextPositiveKeywordsMode\": \"<string>\",\n  \"WebTextNegativeKeywords\": [\n    \"<string>\"\n  ],\n  \"WebTextNegativeKeywordsOperator\": \"<string>\",\n  \"WebTextNegativeKeywordsMode\": \"<string>\",\n  \"IncludeInsights\": true,\n  \"IncludeTotalCount\": true,\n  \"IncludesLocations\": true,\n  \"Limit\": 500,\n  \"Offset\": 1073741823,\n  \"SortBy\": [\n    {\n      \"Field\": \"<string>\",\n      \"Direction\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "Companies": [
    {
      "CompanyNumber": "<string>",
      "Description": "<string>",
      "LegalForm": "<string>",
      "EmployeeRange": "<string>",
      "RTICs": [
        {
          "CompanyNumber": "<string>",
          "SectorCode": "<string>",
          "SectorName": "<string>",
          "VerticalCode": "<string>",
          "VerticalName": "<string>",
          "Score": 123,
          "WordsMatched": 123,
          "Name": "<string>"
        }
      ],
      "LogoURL": "<string>",
      "ScreenshotURL": "<string>",
      "OperatingLocationsCount": 123,
      "Name": "<string>",
      "Website": "<string>",
      "Country": "<string>",
      "Address": "<string>",
      "Town": "<string>",
      "State": "<string>",
      "Phone": "<string>",
      "RegNumber": "<string>",
      "Zipcode": "<string>",
      "Latitude": 123,
      "Longitude": 123,
      "CompaniesInGroup": [
        {
          "CompanyNumber": "<string>",
          "Name": "<string>",
          "Website": "<string>",
          "Description": "<string>",
          "Country": "<string>",
          "Address": "<string>",
          "Town": "<string>",
          "State": "<string>",
          "Phone": "<string>",
          "RegNumber": "<string>",
          "Zipcode": "<string>",
          "Latitude": 123,
          "Longitude": 123,
          "LegalForm": "<string>",
          "EmployeeRange": "<string>",
          "Employees": 123,
          "Turnover": 123,
          "FinancesByYear": [
            {
              "YearEnding": 123,
              "AccountsDate": "2023-12-25",
              "AccountsType": "<string>",
              "Turnover": 123,
              "EBIT": 123,
              "NetIncome": 123,
              "EmployeesHere": 123,
              "EmployeesTotal": 123
            }
          ],
          "LogoURL": "<string>",
          "ParentCompanyNumber": "<string>",
          "ParentCompanyName": "<string>",
          "ActivityCode": "<string>",
          "ActivityCodeName": "<string>",
          "SicCode": "<string>",
          "SicCodeName": "<string>",
          "NAICS": [
            "<string>"
          ]
        }
      ],
      "Employees": 123,
      "EmployeesTotal": 123,
      "Turnover": 123,
      "FinancesByYear": [
        {
          "YearEnding": 123,
          "AccountsDate": "2023-12-25",
          "AccountsType": "<string>",
          "Turnover": 123,
          "EBIT": 123,
          "NetIncome": 123,
          "EmployeesHere": 123,
          "EmployeesTotal": 123
        }
      ],
      "BestEstimateGrowthPercentagePerYear": 123,
      "Directors": [
        {
          "FirstName": "<string>",
          "LastName": "<string>",
          "FullName": "<string>",
          "LocalPnr": "<string>",
          "DateOfBirth": "2023-12-25",
          "DateOfChange": "2023-12-25",
          "Active": true,
          "Position": "<string>",
          "Gender": "<string>",
          "Language": "<string>"
        }
      ],
      "ActivityCode": "<string>",
      "ActivityCodeName": "<string>",
      "SicCode": "<string>",
      "SicCodeName": "<string>",
      "NAICS": [
        "<string>"
      ],
      "RNAICS": [
        {
          "CompanyNumber": "<string>",
          "Code": "<string>",
          "Name": "<string>",
          "Score": 123
        }
      ],
      "SimilarCompanies": [
        {
          "CompanyNumber": "<string>",
          "SimilarityScore": 123
        }
      ]
    }
  ],
  "Insights": {
    "EmployeeRanges": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "LegalForms": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "IncorporationDates": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "RTICs": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "NAICS": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "Employees": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "Turnover": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "States": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ],
    "RNAICS": [
      {
        "ID": "<string>",
        "Name": "<string>",
        "Count": 123,
        "Children": "<array>"
      }
    ]
  },
  "TotalCount": 123
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Authorizations

Authorization

string

header

required

An API key issued by The Data City, sent as: Authorization: Bearer YOUR_KEY

Body

application/json

Request model for filtering US companies with comprehensive search criteria

NAICS

string[] | null

Filter by specific NAICS codes (US business classification). Wire name NAICS.

Name

string | null

Filter by company name prefix, company number, or website. Domain-style needles (keep dots) match Website exactly or as a subdomain suffix; other needles still substring-match website via contains.

Maximum string length: 500

Country

string | null

Filter by country

Maximum string length: 100

EmployeeRange

string | null

Filter by employee range (e.g., "1-9", "10-49", "50-249", "250+")

Maximum string length: 20

LegalForm

string | null

Filter by legal form (e.g., "Corporation", "LLC", "Partnership", "Sole Proprietorship")

Maximum string length: 150

LegalForms

string[] | null

Filter by one or more legal forms from GET /api/filters (legalForms[].id). Matches any listed form (OR).

Maximum array length: 100

HQPostcode

string | null

Filter by headquarters postal code

Maximum string length: 10

Pattern: ^[0-9]{5}$

DateOfIncorporation

string<date> | null

Filter by date of incorporation (exact match)

IncorporationDateFrom

string<date> | null

Filter by minimum date of incorporation (inclusive)

IncorporationDateTo

string<date> | null

Filter by maximum date of incorporation (inclusive)

HasWebsite

boolean | null

Filter companies that have a website

OperatingLocationAddresses

string[] | null

Filter by operating location addresses (partial match)

Maximum array length: 20

MinTurnover

integer<int64> | null

Minimum annual turnover in US dollars

Required range: 0 <= x <= 9223372036854776000

MaxTurnover

integer<int64> | null

Maximum annual turnover in US dollars

Required range: 0 <= x <= 9223372036854776000

MinEBIT

integer<int64> | null

Minimum EBIT (Earnings Before Interest and Taxes) in US dollars

Required range: -9223372036854776000 <= x <= 9223372036854776000

MaxEBIT

integer<int64> | null

Maximum EBIT (Earnings Before Interest and Taxes) in US dollars

Required range: -9223372036854776000 <= x <= 9223372036854776000

MinNetIncome

integer<int64> | null

Minimum net income in US dollars

Required range: -9223372036854776000 <= x <= 9223372036854776000

MaxNetIncome

integer<int64> | null

Maximum net income in US dollars

Required range: -9223372036854776000 <= x <= 9223372036854776000

FinancialYearEnding

integer<int32> | null

Filter by specific financial year ending

MinFinancialYearEnding

integer<int32> | null

Minimum financial year ending

MaxFinancialYearEnding

integer<int32> | null

Maximum financial year ending

AccountsType

string | null

Filter by accounts type (e.g., "Full", "Abbreviated", "Small")

Maximum string length: 50

RTICs

string[] | null

Filter by RTIC codes. Matches companies that have any of the specified RTIC codes.

RNAICS

string[] | null

Filter by RNAIC codes. Matches companies that have any of the specified RNAIC codes. Wire name RNAICS.

State

string[] | null

Filter by state slug or display name from GET /api/filters (states[].id / states[].name), e.g. new-york or New York.

Maximum array length: 100

Zipcode

string[] | null

Filter by zipcode

Maximum array length: 100

Town

string[] | null

Filter by town

Maximum array length: 1000

Director

object

Optional director filter values for POST /api/companies (Director) and M:TDC_Global_Server_API_Core.Classes.Configuration.DirectorFilterSql.Build(TDC_Global_Server_API_Core.Classes.Configuration.DirectorFilterCriteria,TDC_Global_Server_API_Core.Classes.Configuration.DirectorFilterProfile,System.String,System.String).

Show child attributes

LowerLatitude

number<double> | null

South edge of a geographic bounding box (minimum latitude), inclusive. WGS-84 decimal degrees.

Required range: -90 <= x <= 90

UpperLatitude

number<double> | null

North edge of a geographic bounding box (maximum latitude), inclusive. WGS-84 decimal degrees.

Required range: -90 <= x <= 90

LowerLongitude

number<double> | null

West edge of a geographic bounding box (minimum longitude), inclusive. WGS-84 decimal degrees.

Required range: -180 <= x <= 180

UpperLongitude

number<double> | null

East edge of a geographic bounding box (maximum longitude), inclusive. WGS-84 decimal degrees.

Required range: -180 <= x <= 180

HasWebText

boolean | null

Filter by companies that have web text

Includes

string[] | null

Restrict results to these company numbers (CompanyNumber IN (...)).

Maximum array length: 5000

Excludes

string[] | null

Exclude these company numbers (CompanyNumber NOT IN (...)).

Maximum array length: 5000

WebTextPositiveKeywords

string[] | null

Positive keywords matched against web text (BM25 when FTS index exists; otherwise ILIKE).

Maximum array length: 25

WebTextPositiveKeywordsOperator

string | null

Combines positive keywords: AND (all) or OR (any).

Pattern: ^(AND|OR)$

WebTextPositiveKeywordsMode

string | null

deprecated

Backward-compatible alias for TDC_Global_Server_API_US.Models.Filtering.Filters.WebTextPositiveKeywordsOperator.

Pattern: ^(AND|OR)$

WebTextNegativeKeywords

string[] | null

Negative keywords: rows matching these are excluded.

Maximum array length: 25

WebTextNegativeKeywordsOperator

string | null

Combines negative keyword checks inside NOT (...).

Pattern: ^(AND|OR)$

WebTextNegativeKeywordsMode

string | null

deprecated

Backward-compatible alias for TDC_Global_Server_API_US.Models.Filtering.Filters.WebTextNegativeKeywordsOperator.

Pattern: ^(AND|OR)$

IncludeInsights

boolean | null

When false, skips insight bucket aggregation. Omit or null for default (include insights).

IncludeTotalCount

boolean | null

When false, skips total-count queries and omits TotalCount from the response. Omit or null for default (include total count).

IncludesLocations

boolean

When true, nested location lists are loaded on each company. Default is false.

Limit

integer<int32> | null

Maximum number of results to return (uses QueryConstants.MaxQueryLimit)

Required range: 1 <= x <= 1000

Offset

integer<int32> | null

Number of results to skip for pagination (default: 0)

Required range: 0 <= x <= 2147483647

SortBy

object[] | null

Sort options for the results

Maximum array length: 10

Show child attributes

Response

Response model containing filtered companies with pagination and insights

Companies

object[] | null

required

List of companies matching the filter criteria

Show child attributes

Insights

object

Aggregated insights about filtered company data

Show child attributes

TotalCount

integer<int32> | null

Total number of companies matching the filter criteria (before pagination). Omitted when not requested.

Last modified on July 30, 2026

⌘I