Result Codes

Result codes indicate the processing outcome of a lead. These codes are returned in the resultCode field of createLead and getLeadStatus responses.

Result Code Categories

Range	Category	Description
1000-1001	Processing	Lead is being processed
1003-1004	Duplicate	Duplicate lead detected
1006-1008	Failed	Processing step failed
1013-1019	Qualification	Lead qualification result
1020-1022	CRM	CRM submission status
9999	Error	Processing error

Processing States Transitional

These codes represent in-progress states inside the workflow lifecycle. createLead now waits for completion before returning, so these are primarily useful for status lookups and diagnostics.

Code	Name	Description
1000	SUBMITTED_PROCESSING	Initial submission, processing started
1001	UNIQUE_PROCESSING_COMPLETE	Deduplication complete, lead is unique. Further processing continues

Tip

In normal request flow, use the final createLead response directly. Use getLeadStatus when you need reconciliation or troubleshooting by lead ID.

Duplicate States Final

These codes indicate the lead was identified as a duplicate.

Code	Name	Description	Action
1003	DUPLICATE_LEAD	Duplicate lead found in the system	No further processing
1004	DUPLICATE_LEAD_CRM	Duplicate lead found in the system	No further processing
1020	DUPLICATE_PURCHASE	Duplicate lead re-purchased (beyond purchase window)	Submitted to CRM

Failed States Final

These codes indicate a processing step failed.

Code	Name	Description	Action
1006	MONEVO_FAILED	Monevo processing failed	Review lead data
1007	TRUSTEDFORM_FAILED	TrustedForm verification failed	Check certificate ID
1008	BID_FAILED	Bid processing failed	Contact support

Qualification Results

These codes indicate the lead qualification outcome based on credit data. Leads with codes 1013-1017 are eligible for CRM submission.

Qualified Leads Eligible for submitLead

Code	Product Code	Criteria
1013	3225	Total unsecured debt > $15,000 AND Vantage Score > 600
1014	3226	Total unsecured debt > $20,000 AND Vantage Score > 450
1015	3227	Total unsecured debt > $30,000 AND Vantage Score > 450
1016	3228	Total unsecured debt > $40,000 AND Vantage Score > 450
1017	3229	Total unsecured debt > $50,000 AND Vantage Score > 450

Note

Total Unsecured Debt is calculated as the sum of: - BC33S (Bankcard balances) - US33S (Unsecured loan balances) - CO06S (Collection balances)

Non-Qualified Leads Final

Code	Product Code	Criteria
1018	3288	Credit File Unknown/Not Found (CFU)
1019	3289	Total debt > $15,000 but Vantage Score < 450

CRM Submission Status Success

These codes indicate the CRM submission result.

Code	Name	Description
1021	CRM_SUBMISSION_COMPLETE	Successfully submitted to CRM
1022	CRM_ALREADY_SUBMITTED	Lead was previously submitted, request not accepted

Error States Final

Code	Name	Description	Action
9999	PROCESSING_ERROR	Error occurred during processing	Review and retry

Decision Flow

┌─────────────────────────────────────────────────────────────┐
│                    Lead Submitted                           │
│                     resultCode: 1000                        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │  Deduplication  │
                    └─────────────────┘
                              │
        ┌─────────────┬───────┴───────┬──────────────┐
        ▼             ▼               ▼              ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌─────────────┐
  │  Unique   │ │ Duplicate │ │ Dup→CRM   │ │ Re-purchase │
  │   1001    │ │   1003    │ │   1004    │ │    1020     │
  └───────────┘ └───────────┘ └───────────┘ └─────────────┘
        │             │               │              │
        ▼             ▼               ▼              ▼
  ┌───────────┐     STOP            STOP      Submitted to
  │Credit Pull│                                  CRM
  └───────────┘
        │
  ┌─────┼──────────┐
  ▼     ▼          ▼
┌────────┐ ┌────────┐ ┌────────┐
│Qualify │ │No File │ │ Low    │
│1013-17 │ │ 1018   │ │ Score  │
└────────┘ └────────┘ │ 1019   │
     │                └────────┘
     ▼                     │
┌────────┐                 ▼
│submitLd│               STOP
└────────┘
     │
     ▼
┌────────────┐
│    CRM     │
│ 1021/1022  │
└────────────┘

Best Practices

1. Handle final codes for decisions - Use final outcomes to drive business actions
2. Handle all code ranges - Have logic for each category
3. Log result codes - Useful for debugging and analytics
4. Submit qualified leads manually when required - Check for 1013-1017 before calling submitLead when your partner configuration uses manual CRM submission
5. Implement retry logic - For transient errors (9999)

Code Reference Table

Code	Name	Category	Final?	CRM Eligible?
1000	SUBMITTED_PROCESSING	Processing	No	No
1001	UNIQUE_PROCESSING_COMPLETE	Processing	No	No
1003	DUPLICATE_LEAD	Duplicate	Yes	No
1004	DUPLICATE_LEAD_CRM	Duplicate	Yes	No
1006	MONEVO_FAILED	Failed	Yes	No
1007	TRUSTEDFORM_FAILED	Failed	Yes	No
1008	BID_FAILED	Failed	Yes	No
1013	PRODUCT_CODE_3225	Qualified	Yes	Yes
1014	PRODUCT_CODE_3226	Qualified	Yes	Yes
1015	PRODUCT_CODE_3227	Qualified	Yes	Yes
1016	PRODUCT_CODE_3228	Qualified	Yes	Yes
1017	PRODUCT_CODE_3229	Qualified	Yes	Yes
1018	PRODUCT_CODE_3288	Non-Qualified	Yes	No
1019	PRODUCT_CODE_3289	Non-Qualified	Yes	No
1020	DUPLICATE_PURCHASE	CRM	Yes	Yes
1021	CRM_SUBMISSION_COMPLETE	CRM	Yes	N/A
1022	CRM_ALREADY_SUBMITTED	CRM	Yes	N/A
9999	PROCESSING_ERROR	Error	Yes	No