List Smart Tags
curl --request GET \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags \
--header 'Authorization: <api-key>'import requests
url = "https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags', 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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags",
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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags"
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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags")
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{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440300",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "policyPremium",
"tagDisplayName": "Policy Premium",
"tagDescription": "Total premium amount for the policy",
"tagCategories": [
"policy",
"quote"
],
"tagData": {
"type": "text"
},
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-20T14:00:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440301",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "generalLiabilityPremium",
"tagDisplayName": "General Liability Premium",
"tagDescription": "Premium amount for general liability coverage",
"tagCategories": [
"policy",
"quote"
],
"tagData": {
"type": "text"
},
"createdAt": "2025-01-10T08:00:00.000Z",
"updatedAt": "2025-01-10T08:00:00.000Z"
}
],
"totalCount": 2
}Smart Tags
List Smart Tags
Returns a paginated list of smart tags for the company.
Filtering:
id- Filter by smart tag ID (single or array)filterText- Text search across tag name
Sorting:
createdAt(default),updatedAt,tagName,tagDisplayName
Required permission: company:read
GET
/
api
/
external
/
companies
/
{companyId}
/
smart-tags
List Smart Tags
curl --request GET \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags \
--header 'Authorization: <api-key>'import requests
url = "https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags', 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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags",
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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags"
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://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.aiinsurance.io/api/external/companies/{companyId}/smart-tags")
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{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440300",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "policyPremium",
"tagDisplayName": "Policy Premium",
"tagDescription": "Total premium amount for the policy",
"tagCategories": [
"policy",
"quote"
],
"tagData": {
"type": "text"
},
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-20T14:00:00.000Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440301",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"tagName": "generalLiabilityPremium",
"tagDisplayName": "General Liability Premium",
"tagDescription": "Premium amount for general liability coverage",
"tagCategories": [
"policy",
"quote"
],
"tagData": {
"type": "text"
},
"createdAt": "2025-01-10T08:00:00.000Z",
"updatedAt": "2025-01-10T08:00:00.000Z"
}
],
"totalCount": 2
}Authorizations
API key authentication. Include your API key in the Authorization header.
Path Parameters
Company identifier
Query Parameters
Filter by smart tag ID (single UUID or array of UUIDs)
Search across quote number, description, and other text fields
Field to sort by (default createdAt)
Available options:
createdAt, updatedAt, tagName, tagDisplayName Sort direction (default desc)
Available options:
asc, desc Page number (1-based, default 1, page size 50)
Required range:
x >= 1Was this page helpful?