Semantics
Read-only. Returns the lead's status (new / qualified / contacted / won / lost / spam), the current qualification (urgency + fit), timestamps for state transitions, and whether the owner has viewed it. Use this to follow up on a previously submitted request.
Invariants
- Pure read. No state change.
- Status transitions are monotonic per LeadKit's lifecycle.
When to use
After `submit_request` or `request_quote` when the user asks "did they get back to me yet?" or "what happened with that lead?"
Input schema
{
"type": "object",
"required": [
"lead_id"
],
"properties": {
"lead_id": {
"type": "string"
},
"agent_vendor": {
"type": "string"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"enum": [
"unknown_lead",
"invalid_input"
],
"type": "string"
},
"status": {
"enum": [
"new",
"qualified",
"contacted",
"won",
"lost",
"spam"
],
"type": "string"
},
"lead_id": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"qualification": {
"type": "object",
"properties": {
"fit": {
"type": "string"
},
"summary": {
"type": "string"
},
"urgency": {
"type": "string"
}
}
},
"last_updated_at": {
"type": "string",
"format": "date-time"
}
}
}