API reference
Credits a project used
The credits a project’s searches used: what each reserved and was charged, what is still held by searches running now, and the project’s total. search_id narrows it to one search. credits_state per search: held (running; its cap is reserved), charged (finished; charged for the profiles it read, the rest refunded), refunded (its whole reservation came back: it failed or never started), none (database only, or no plan). Does not use credits.
Needs scope searches:read.
GET
/
projects
/
{projectId}
/
spend
Credits a project used
curl --request GET \
--url https://api.revcenter.ai/v1/projects/{projectId}/spend \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revcenter.ai/v1/projects/{projectId}/spend', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revcenter.ai/v1/projects/{projectId}/spend"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"project_id": "6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11",
"credits_charged": 412,
"credits_held": 1000,
"searches": [
{
"search_id": "0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61",
"status": "complete",
"created_at": "2026-10-17T14:03:02.000Z",
"credits_state": "charged",
"credits_reserved": 1000,
"credits_charged": 412
},
{
"search_id": "7d2e4f1a-0c3b-4a5d-9e8f-6b1c2d3e4f52",
"status": "running",
"created_at": "2026-10-18T09:00:00.000Z",
"credits_state": "held",
"credits_reserved": 1000,
"credits_charged": null
}
]
},
"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
Credits a project used
curl --request GET \
--url https://api.revcenter.ai/v1/projects/{projectId}/spend \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revcenter.ai/v1/projects/{projectId}/spend', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revcenter.ai/v1/projects/{projectId}/spend"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"project_id": "6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11",
"credits_charged": 412,
"credits_held": 1000,
"searches": [
{
"search_id": "0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61",
"status": "complete",
"created_at": "2026-10-17T14:03:02.000Z",
"credits_state": "charged",
"credits_reserved": 1000,
"credits_charged": 412
},
{
"search_id": "7d2e4f1a-0c3b-4a5d-9e8f-6b1c2d3e4f52",
"status": "running",
"created_at": "2026-10-18T09:00:00.000Z",
"credits_state": "held",
"credits_reserved": 1000,
"credits_charged": null
}
]
},
"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"
}
}