Sender

Referral - Type A

Qualification attributes

Non-identifying attributes used to match against eligible demand.

Example 
{
  "product_requested": "business_line_of_credit",
  "state": "NY",
  "business_age_months": 36,
  "annual_revenue_band": "500k_to_1m",
  "industry": "wholesale",
  "consent_state": "pending"
}

Request

Header

Methodapi/partner/application/offers
URL – Testhttps://
URL – Prodhttps:///api/partner/application/offers
Request TypePOST
Headers – Test
Headers 
Accept: application/json
Authorization: To be issued by Konduit
Channel: API
Content-Type: application/json; charset=utf-8
Institution-Id: LGR
Partner-Id: xxxxxxx

Partner-Id: use the referral code issued by Konduit.

Headers – Prod
Headers 
Accept: application/json
Authorization: To be issued by Konduit
Channel: API
Content-Type: application/json; charset=utf-8
Institution-Id: LGR
Partner-Id: xxxxxxx

Partner-Id: use the referral code issued by Konduit.

Body 
{
  "applicants": [
    {
      "address": {
        "streetAddress": "5416 Brewer Rd",
        "zipCode": "35071",
        "city": "Gardendale",
        "state": "AL"
      },
      "employers": [
        {
          "schedule": "MONTHLY",
          "salary": 30000,
          "empStatus": "Self Employed",
          "jobTitle": "Manager",
          "selfEmployed": true
        }
      ],
      "firstName": "Clark",
      "lastName": "Kent",
      "primaryPhone": "7042931679",
      "email": "ckent@aol.com",
      "dob": "mm/dd/yyyy"
    }
  ],
  "collateral": {
    "loanAmount": "6000.00"
  },
  "leadId": "ed4c570e::69ac2cf07234479aad987d550127bb59",
  "creditTier": "fair",
  "subAffiliateId": "f5hht0jst5",
  "referralCode": "XXXXXXX",
  "loanPurpose": "RTL",
  "leadFlow": "OFFLINE",
  "ip": "<ip>",
  "category": "<category>",
  "dateOfVisit": "mm/dd/yyyy",
  "openDate": "mm/dd/yyyy",
  "clickDate": "mm/dd/yyyy"
}

Body Parameters

schedulestringrequired

MONTHLY or ANNUALLY.

salarynumberrequired

Gross salary for the period given in schedule.

empStatusstringrequired

Job Income, Self Employed, Benefits, Pensions, Social Security, Disability Income, Military, or Other.

jobTitlestringoptional

Optional.

selfEmployedbooleanoptional

Optional. Send this only if Self Employed is not already the value of empStatus.

subAffiliateIdstringrequired

Your sub-affiliate code. Helps Konduit optimise your traffic.

referralCodestringrequired

The referral code issued to you by Konduit.

loanPurposestringrequired

Always send RTL.

leadFlowstringrequired

Always send OFFLINE.

ipstringoptional

Optional.

categorystringoptional

Optional.

dateOfVisitstringoptional

Optional. Format mm/dd/yyyy.

openDatestringoptional

Optional. Format mm/dd/yyyy.

clickDatestringoptional

Optional. Format mm/dd/yyyy.

Response

Accepted leads return the status OFFER_GENERATED_OFFLINE. All leads are accepted except:

  • DUPLICATE_LEAD: the lead was already sent.
  • NO_OFFER_PRE_FAIL: the lead does not match the filter for state or credit tier.
  • INVALID_EMAIL: the email address syntax is not correct.

Make sure your integration handles every status.

Accepted lead OFFER_GENERATED_OFFLINE
Response 
{
  "accessToken": null,
  "losStatus": null,
  "id": null,
  "message": null,
  "clientApplicationNumber": null,
  "bureauData": null,
  "applicationId": 4000248,
  "applicationStatus": "OFFER_GENERATED_OFFLINE",
  "code": 200,
  "details": "Successfully Request is processed.",
  "appOfferStatus": "OFFER_GENERATED_OFFLINE",
  "offers": [],
  "offerRecommendations": [],
  "loanAmount": "6000.00"
}
Duplicate lead, not accepted DUPLICATE_LEAD
Response 
{
  "accessToken": null,
  "losStatus": null,
  "id": null,
  "message": null,
  "clientApplicationNumber": null,
  "bureauData": null,
  "applicationId": 4000190,
  "applicationStatus": "DUPLICATE_LEAD",
  "code": 200,
  "details": "Duplicate lead found",
  "appOfferStatus": "DUPLICATE_LEAD",
  "offers": [],
  "offerRecommendations": [],
  "loanAmount": "5998.00"
}
Lead not meeting state or credit tier filters, not accepted NO_OFFER_PRE_FAIL
Response 
{
  "accessToken": null,
  "losStatus": null,
  "id": null,
  "message": null,
  "clientApplicationNumber": null,
  "bureauData": null,
  "applicationId": 4002680,
  "applicationStatus": "NO_OFFER_PRE_FAIL",
  "code": 200,
  "details": "No offer found",
  "appOfferStatus": "NO_OFFER_PRE_FAIL",
  "offers": [],
  "offerRecommendations": [],
  "loanAmount": "6000.0"
}
Invalid email, not accepted INVALID_EMAIL
Response 
{
  "accessToken": null,
  "losStatus": null,
  "id": null,
  "message": null,
  "clientApplicationNumber": null,
  "bureauData": null,
  "applicationId": 4002678,
  "applicationStatus": "INVALID_EMAIL",
  "code": 200,
  "details": "Email address is not valid",
  "appOfferStatus": "INVALID_EMAIL",
  "offers": [],
  "offerRecommendations": [],
  "loanAmount": "6000.0"
}