getLeadStatus

Query

Query the current status and result code of a previously submitted lead.

Use this query to check the status of older leads and for reconciliation or troubleshooting. The response includes the current result code and bid value (if applicable).

Query Signature

query {
  getLeadStatus(id: ID!): LeadStatus
}

Example Request

GraphQL
Apollo Studio

query GetLeadStatus($id: ID!) {
  getLeadStatus(id: $id) {
    id
    resultCode
    updatedAt
    partnerLeadId
    bidValue
  }
}

Example Variables:

{
  "id": "lead_abc123def456"
}

Example Response

{
  "data": {
    "getLeadStatus": {
      "id": "lead_abc123def456",
      "resultCode": 1013,
      "updatedAt": "2026-02-04T15:30:00.000Z",
      "partnerLeadId": "PARTNER-LEAD-12345",
      "bidValue": "$25.00"
    }
  }
}

Arguments

Argument	Type	Description
`id`	`ID!`	TBD

Response Type

Returns: LeadStatus

`LeadStatus`

Minimal lead status type for partner status lookup. Contains only public fields safe for partner access.

Field	Type	Description
`id`	`ID!`	Unique internal lead identifier
`resultCode`	`Int!`	Current result code indicating lead processing status. See Result Codes documentation for complete list: • 1000: Processing • 1001: Unique, processing complete • 1003: Duplicate lead • 1013-1017: Qualified (eligible for submitLead) • 1020: Duplicate lead re-purchased (beyond purchase window) • 9999: Processing error
`updatedAt`	`String!`	ISO 8601 timestamp of last status update
`partnerLeadId`	`String`	Partner’s external lead ID (from leadId input field) for correlation
`bidValue`	`String`	Calculated bid value for qualified leads. • null: Lead did not qualify (resultCode not 1013-1017) • “No Bid Available”: Qualified but no bid settings configured • “$X.XX”: Actual bid amount (e.g., “$25.00”)