API ReferenceActors
Fetch an actor
Returns an actor record. The enrichment and intelligence fields are populated once the actor's status is "enriched". Poll until status reaches "enriched" (success) or "failed" (terminal failure).
Authorization
bearerAuth AuthorizationBearer <token>
API key issued via the dashboard. Format: qk_live_<random>.
In: header
Path Parameters
actorId*string
Stable identifier returned from POST /v1/actors.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://qualia.so/v1/actors/string"{
"id": "string",
"email": "string",
"name": "string",
"status": "pending",
"source": "string",
"enrichment": {
"fullName": "string",
"firstName": "string",
"lastName": "string",
"title": "string",
"seniority": "string",
"department": "string",
"linkedinUrl": "string",
"twitterHandle": "string",
"githubUsername": "string",
"bio": "string",
"location": "string",
"photoUrl": "string",
"companyName": "string",
"companyDomain": "string",
"companyDescription": "string",
"industry": "string",
"employeeCount": 0,
"employeeRange": "string",
"fundingStage": "string",
"totalFunding": 0,
"techStack": [
"string"
],
"companyLinkedinUrl": "string",
"companyLocation": "string",
"citations": {
"property1": {
"url": "string",
"tool": "string",
"title": "string",
"retrievedAt": "string"
},
"property2": {
"url": "string",
"tool": "string",
"title": "string",
"retrievedAt": "string"
}
},
"sources": [
"string"
],
"confidence": 0,
"enrichedAt": "string"
},
"intelligence": {
"summary": "string",
"highlights": [
"string"
],
"concerns": [
"string"
],
"careerTrajectory": "string",
"communicationStyle": "string",
"interests": [
"string"
],
"motivations": "string",
"strategicPriorities": "string",
"painPoints": [
"string"
],
"techStackReality": "string",
"timingSignals": [
"string"
],
"urgency": "string",
"outreachStrategy": "string",
"suggestedChannel": "string",
"suggestedHook": "string",
"suggestedTone": "string",
"citations": {
"property1": [
{
"url": "string",
"tool": "string",
"title": "string",
"retrievedAt": "string"
}
],
"property2": [
{
"url": "string",
"tool": "string",
"title": "string",
"retrievedAt": "string"
}
]
}
},
"score": 0,
"scoring": {
"explanation": "string",
"matchedRules": [
"string"
],
"unmatchedRules": [
"string"
],
"breakdown": {
"property1": 0,
"property2": 0
}
},
"createdAt": "2019-08-24T14:15:22Z"
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string"
}
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string"
}
}{
"error": {
"code": "not_found",
"message": "string",
"requestId": "string"
}
}{
"error": {
"code": "unprocessable_entity",
"message": "string",
"requestId": "string"
}
}{
"error": {
"code": "internal_server_error",
"message": "string",
"requestId": "string"
}
}