Retrieve a company's segments and their peers
curl --request GET \
--url https://api.noonum.ai/v2/segments/companies/{companyId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.noonum.ai/v2/segments/companies/{companyId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.noonum.ai/v2/segments/companies/{companyId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.noonum.ai/v2/segments/companies/{companyId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"company": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"symbol": "<string>"
},
"segments": [
{
"id": 123,
"name": "<string>",
"description": "<string>",
"materiality": "core",
"segmentGroup": {
"id": 123,
"name": "<string>",
"description": "<string>",
"industries": {
"gics": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
},
"naics": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
},
"icb": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
}
}
},
"peers": {
"count": 123,
"top": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"symbol": "<string>",
"materiality": "core"
}
]
}
}
],
"nonMarketItems": [
{
"name": "<string>",
"materiality": "core"
}
]
}{
"error": "<string>"
}{
"error": "<string>",
"companyIds": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}{
"error": "<string>"
}{
"error": "<string>"
}Segments
Retrieve a company's segments and their peers
Returns a company’s business segments, each with its segment group and its peers: the other companies with the same segment, counted, with the top 8 named (most material first, then by market cap); /segments/groups/{groupId} lists them all. Items found for the company that are not a market for products or services come separately. Take the company ID from /helper/companies/search; a company with no segment data returns empty lists. You must be subscribed to the company.
GET
/
segments
/
companies
/
{companyId}
Retrieve a company's segments and their peers
curl --request GET \
--url https://api.noonum.ai/v2/segments/companies/{companyId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.noonum.ai/v2/segments/companies/{companyId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.noonum.ai/v2/segments/companies/{companyId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.noonum.ai/v2/segments/companies/{companyId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"company": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"symbol": "<string>"
},
"segments": [
{
"id": 123,
"name": "<string>",
"description": "<string>",
"materiality": "core",
"segmentGroup": {
"id": 123,
"name": "<string>",
"description": "<string>",
"industries": {
"gics": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
},
"naics": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
},
"icb": {
"sector": "<string>",
"path": [
"<string>"
],
"industry": "<string>",
"codes": [
"<string>"
]
}
}
},
"peers": {
"count": 123,
"top": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"symbol": "<string>",
"materiality": "core"
}
]
}
}
],
"nonMarketItems": [
{
"name": "<string>",
"materiality": "core"
}
]
}{
"error": "<string>"
}{
"error": "<string>",
"companyIds": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Response
The company's segments.