qualia
API ReferenceActors

Fetch an actor

Returns a slim contact-card view of the actor: identity, employer, location, and the ICP fit score. Enrichment fields are populated once the actor's status is "enriched". Poll until status reaches a terminal state: "enriched" (success), "rejected" (input declined - see rejectionReason), or "failed" (the run errored - see failureReason).

GET
/actors/{actorId}

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",
  "rejectionReason": "quota_exceeded",
  "failureReason": "string",
  "score": 0,
  "scoringStatus": "pending",
  "title": "string",
  "linkedinUrl": "string",
  "location": "string",
  "companyName": "string",
  "companyDomain": "string",
  "industry": "string",
  "companyLocation": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "enrichedAt": "2019-08-24T14:15:22Z",
  "summary": "string",
  "highlights": [
    "string"
  ],
  "bio": "string",
  "companyDescription": "string"
}
{
  "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"
  }
}