Get a companies list
curl --request GET \
--url https://api.tamtam.ai/api/v2/companies-lists/{listID} \
--header 'Authorization: <api-key>'import requests
url = "https://api.tamtam.ai/api/v2/companies-lists/{listID}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.tamtam.ai/api/v2/companies-lists/{listID}', 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.tamtam.ai/api/v2/companies-lists/{listID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <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.tamtam.ai/api/v2/companies-lists/{listID}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.tamtam.ai/api/v2/companies-lists/{listID}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/companies-lists/{listID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"account_id": "<string>",
"companies_count": 123,
"company_linkedin_ids": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"name": "<string>",
"tags": [
"<string>"
],
"assignee": "<string>",
"created_by_user_email": "<string>"
}{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Companies Lists
Get a companies list
Get a companies list by ID, including the LinkedIn company IDs it currently contains. Customer API keys read from their own bound account (the account_id query param is ignored); staff TAMTAM API keys must supply an explicit account_id.
GET
/
v2
/
companies-lists
/
{listID}
Get a companies list
curl --request GET \
--url https://api.tamtam.ai/api/v2/companies-lists/{listID} \
--header 'Authorization: <api-key>'import requests
url = "https://api.tamtam.ai/api/v2/companies-lists/{listID}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.tamtam.ai/api/v2/companies-lists/{listID}', 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.tamtam.ai/api/v2/companies-lists/{listID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <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.tamtam.ai/api/v2/companies-lists/{listID}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.tamtam.ai/api/v2/companies-lists/{listID}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/companies-lists/{listID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"account_id": "<string>",
"companies_count": 123,
"company_linkedin_ids": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"name": "<string>",
"tags": [
"<string>"
],
"assignee": "<string>",
"created_by_user_email": "<string>"
}{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
apikeyAuthbearerAuth
Account API key passed in the Authorization header
Path Parameters
Companies list UUID
Example:
"b3c6f5e2-1234-4abc-9def-0123456789ab"
Query Parameters
Target account UUID. Required for staff; ignored for customer keys.
Response
OK
Owning account UUID
Number of companies currently in the list
LinkedIn company IDs currently in the list
Creation timestamp
Companies list UUID
List name
User-side organizational tags
Email of the assigned owner
Email of the creator