Get one saved search
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/saved-searches/{savedSearchId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/saved-searches/{savedSearchId}"
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/saved-searches/{savedSearchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"savedSearch": {
"id": "6a8de3161ea5e58766c32c88",
"title": "CoStar Group CXOs (US)",
"createdAt": "2026-08-25T18:46:46.159Z",
"updatedAt": "2026-08-25T18:46:46.159Z",
"filters": {
"job_title_levels": [
{
"status": "include",
"value": "cxo"
}
],
"location_country": [
{
"status": "include",
"value": "united states"
}
],
"job_company_name": [
{
"status": "include",
"value": "costar group"
}
]
},
"ignoredFilterKeys": [],
"searchType": "people"
}
}{
"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>"
}
}Saved searches
Get one saved search
One saved search of either kind, with its filters in the language the matching search endpoint accepts — POST /prospects/search for searchType: people, POST /companies/search for searchType: company. ignoredFilterKeys names stored keys with no equivalent search field, which were dropped from filters. A search that is not yours is 404, identically to one that does not exist.
Errors:
404SAVED_SEARCH_NOT_FOUND— No saved search of yours has that id.422VALIDATION_FAILED— The request failed the declared schema;paramnames the offending key andmessagequotes the rule it broke.429RATE_LIMITED— Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.500UNEXPECTED_ERROR— The request failed inside the service; nothing was billed and the request_id identifies the failure.
Requires one of the following token scopes: search.
GET
/
business
/
saved-searches
/
{savedSearchId}
Get one saved search
curl --request GET \
--url https://api.tryfuse.ai/api/v1/business/saved-searches/{savedSearchId} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.tryfuse.ai/api/v1/business/saved-searches/{savedSearchId}"
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/saved-searches/{savedSearchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"savedSearch": {
"id": "6a8de3161ea5e58766c32c88",
"title": "CoStar Group CXOs (US)",
"createdAt": "2026-08-25T18:46:46.159Z",
"updatedAt": "2026-08-25T18:46:46.159Z",
"filters": {
"job_title_levels": [
{
"status": "include",
"value": "cxo"
}
],
"location_country": [
{
"status": "include",
"value": "united states"
}
],
"job_company_name": [
{
"status": "include",
"value": "costar group"
}
]
},
"ignoredFilterKeys": [],
"searchType": "people"
}
}{
"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
Id of the saved search (24-character hex ObjectId), as returned by GET /saved-searches.
Response
Success
Show child attributes
Show child attributes