API reference
Why the list looks as it does
How a search’s people score now: the cut-off, people per score band, how many are shortlisted, why the rest were rejected, which must-haves profiles fail to show, and the best people just under the cut-off. Read it before preview_scoring: it says whether the cut-off, a must-have or a weight is what keeps the list short. Does not use credits.
Needs scope searches:read.
GET
/
searches
/
{searchId}
/
scoring
Why the list looks as it does
curl --request GET \
--url https://api.revcenter.ai/v1/searches/{searchId}/scoring \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revcenter.ai/v1/searches/{searchId}/scoring', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revcenter.ai/v1/searches/{searchId}/scoring"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"search_id": "0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61",
"floors": {
"qualified": 85,
"shortlist": 80,
"custom": false
},
"analyzed": 212,
"unscored": 0,
"enriched": 212,
"shortlisted": 14,
"bands": [
{
"label": "85+",
"min": 85,
"max": null,
"count": 9,
"big4": {
"current": 0,
"past": 2
}
},
{
"label": "80–84",
"min": 80,
"max": 84,
"count": 5,
"big4": {
"current": 0,
"past": 1
}
}
],
"rejected": 61,
"rejectReasons": [
{
"code": "GEO_OUT",
"label": "outside the target area",
"count": 33
}
],
"underFloorReasons": [],
"mustHaves": {
"gate": true,
"items": [
{
"requirement": "CPA",
"missing": 48,
"of": 212
}
]
},
"nearMisses": [
{
"candidateId": "3c2b1a09-8f7e-4d6c-9b5a-4e3d2c1b0a99",
"name": "Dana Whitfield",
"roleTitle": "Plant Controller",
"company": "Garden State Foods",
"profileUrl": "https://www.linkedin.com/in/example",
"score": 78
}
],
"weights": {
"title": 0.3,
"geo": 0.2,
"years": 0.15,
"seniority": 0.1,
"skills": 0.15,
"industry": 0.1
},
"outsideLocation": 40,
"preferredEmployer": {
"current": 0,
"past": 3
},
"belowCutoff": {
"count": 22,
"pointsLost": [
{
"dimension": "skills",
"points": 6.2
}
]
}
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}⌘I
Why the list looks as it does
curl --request GET \
--url https://api.revcenter.ai/v1/searches/{searchId}/scoring \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revcenter.ai/v1/searches/{searchId}/scoring', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revcenter.ai/v1/searches/{searchId}/scoring"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"search_id": "0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61",
"floors": {
"qualified": 85,
"shortlist": 80,
"custom": false
},
"analyzed": 212,
"unscored": 0,
"enriched": 212,
"shortlisted": 14,
"bands": [
{
"label": "85+",
"min": 85,
"max": null,
"count": 9,
"big4": {
"current": 0,
"past": 2
}
},
{
"label": "80–84",
"min": 80,
"max": 84,
"count": 5,
"big4": {
"current": 0,
"past": 1
}
}
],
"rejected": 61,
"rejectReasons": [
{
"code": "GEO_OUT",
"label": "outside the target area",
"count": 33
}
],
"underFloorReasons": [],
"mustHaves": {
"gate": true,
"items": [
{
"requirement": "CPA",
"missing": 48,
"of": 212
}
]
},
"nearMisses": [
{
"candidateId": "3c2b1a09-8f7e-4d6c-9b5a-4e3d2c1b0a99",
"name": "Dana Whitfield",
"roleTitle": "Plant Controller",
"company": "Garden State Foods",
"profileUrl": "https://www.linkedin.com/in/example",
"score": 78
}
],
"weights": {
"title": 0.3,
"geo": 0.2,
"years": 0.15,
"seniority": 0.1,
"skills": 0.15,
"industry": 0.1
},
"outsideLocation": 40,
"preferredEmployer": {
"current": 0,
"past": 3
},
"belowCutoff": {
"count": 22,
"pointsLost": [
{
"dimension": "skills",
"points": 6.2
}
]
}
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}{
"error": {
"code": "search_not_found",
"message": "No search with that id in this workspace.",
"details": null,
"request_id": "req_01JABCDEF"
},
"meta": {
"request_id": "req_01JABCDEF"
}
}