This endpoint returns the list of saved ICPs, which you can use to review existing filters before fetching recommendations or before creating an updated ICP.
Endpoint
GET /v2/recommendations/icp
Headers
{
"Authorization": "Bearer YOUR_API_KEY"
}Query Parameters
externalUserId— optional string. Pass this to retrieve ICPs belonging to a specific user in your system. If not provided, ICPs associated with the authenticated user will be returned.
Example Request
curl -X GET "https://api.surfe.com/v2/recommendations/icp?externalUserId=ext-user-123" \
-H "Authorization: Bearer YOUR_API_KEY"
Example Response
{
"icpFilters": [
{
"companies": {
"employeeCount": {
"from": 1,
"to": 100000000
},
"industries": [
"Software",
"Finance"
],
"primaryLocations": [
"fr",
"W-EMEA"
],
"revenue": {
"from": 1,
"to": 100000000
}
},
"id": "string",
"people": {
"countries": [
"fr",
"W-EMEA"
],
"departments": [
"Engineering",
"Marketing"
],
"jobTitles": [
"Software Engineer",
"Marketing Manager"
],
"seniorities": [
"Board Member",
"C-Level",
"Director",
"Founder",
"Head",
"Manager",
"Other",
"Owner",
"Partner",
"VP"
]
},
"type": "DECLARED_ICP"
}
],
"pagination": {
"hasMore": true,
"limit": 0,
"totalAmount": 0
}
}The response returns your saved ICP filters inside the icpFilters array along with pagination details.
Need Help?
If you have any questions or need further assistance, feel free to reach out to our support team via Intercom.