curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e901",
"name": "Q3 Fintech CFOs",
"entityType": "contactList",
"completionStatus": "complete",
"totalRecords": 412,
"metrics": {
"totalEnriched": 400,
"totalWithLinkedin": 412,
"totalWithProfessionalEmail": 350,
"totalWithPersonalEmail": 40,
"totalWithValidPhone": 120
},
"columns": [
{
"id": "68a1f3009c41d20014b3e9a1",
"name": "Lead Score",
"type": "string"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Get one list's metadata
One list’s metadata: name, kind (entityType), completionStatus (processing while an import, copy, save-to-list or enrichment is still populating it, complete otherwise — poll this after any 202 that targets the list), the row count, and the enrichment metrics (rows enriched and rows carrying a LinkedIn URL, professional email, personal email or valid phone). metrics is null for a company list, where those counters do not apply. ?include=columns adds the custom and smart column definitions.
Errors:
404LIST_NOT_FOUND— No list with that id is visible to the token owner.422VALIDATION_FAILED— listId is not a 24-hex id, or include is not “columns”.429RATE_LIMITED— The lists rate bucket is exhausted.
Requires one of the following token scopes: lists.
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e901",
"name": "Q3 Fintech CFOs",
"entityType": "contactList",
"completionStatus": "complete",
"totalRecords": 412,
"metrics": {
"totalEnriched": 400,
"totalWithLinkedin": 412,
"totalWithProfessionalEmail": 350,
"totalWithPersonalEmail": 40,
"totalWithValidPhone": 120
},
"columns": [
{
"id": "68a1f3009c41d20014b3e9a1",
"name": "Lead Score",
"type": "string"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Path Parameters
24-character hex id of the list (from GET /business/lists).
Query Parameters
Set to columns to add the list's custom column definitions (id, name, type) to the response.
columns Response
Success
Show child attributes
Show child attributes