Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Even Financial Lead API

A lead combines information about a user with search criteria for financial products, and is submitted in exchange for a rate table.A rate table is a list of financial offers that match a submitted lead.### Lead DetailsNo fields are required on a lead, but depending on the type of product requested, a minimum subset is required in order to potentially receive personalized offers. For details, see [the Financial Products overview](https://engine.tech/docs/api-reference/#financial-products).A lead may request multiple product types, in which case the returned rate table will include a list for each product type with matching offers.### Asynchronous Rate TablesOften a rate table will be built asynchronously. This means that although the rate table gets returned, the API may still be waiting for responses from one or more financial institutions. In these cases, you should poll the rate table until all responses are resolved before displaying the offers to the end user.So, if you submit a lead via the "Submit lead" endpoint and the returned rate table has a non-empty `pendingResponses` array, you should reload the rate table via the "Get rate table" endpoint, and continue to do so until `pendingResponses` is empty.

Even Financial Lead API is one of 6 APIs that Even Financial publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Lead. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 5 operations across 4 paths, and defines 80 schemas. It is described by OpenAPI 3.0.3, at version 1.106.0.

Requests are made against a single base URL, https://api.engine.tech.

5 operations 4 paths 80 schemas 2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.106.0
Base URL
https://api.engine.tech
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 3

Even Financial Lead API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (publishableBearerToken). It accepts HTTP bearer tokens (confidentialBearerToken). It accepts HTTP bearer tokens (experimentalBearerToken).

  • publishableBearerToken — A bearer token that is assumed to be published in application code and downloaded to a user's device. As a result, it only has restricted access to the API.
  • confidentialBearerToken — A bearer token that is assumed to be managed like a password or any other confidential secret. As a result, it has access to sensitive API endpoints.
  • experimentalBearerToken — A bearer token that is used to access experimental endpoints that are not yet available for all partners. It may be treated the same as a publishableBearerToke…

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Lead 5

A lead combines information about a user with search criteria for financial products, and is submitted in exchange for a rate table. A rate table is a list of financial offers tha…

POST
/leads/rateTables
Submit lead
submitLead body → 200400401409
POST
/leads/{leadUuid}/rateTables
Submit a lead and get a rate table
getRateTableForSpecifiedLead 1 param body → 200400401
GET
/originator/rateTables/{uuid}
Get rate table
getRateTable 1 param → 200400401404
GET
/leads/{uuid}
Get lead
getLead 1 param → 200400401404
PATCH
/leads/{uuid}
Update a lead
updateLead 1 param body → 200400401404

Schemas 80

The contract defines 80 schemas that model the data the API accepts and returns. The most detailed are CreditCardOfferDetails (73 properties), LoanOffer (44 properties), LeadMortgageInformationJson (32 properties), Lead (31 properties). Each schema is shown below with its type and property counts.

PropertyType
string
PersonalReferenceRelationType
string
CardPurpose
string
Purposes or categories related to a credit card
LeadSavingsInformationJson
object
2 properties
Originator
object
7 properties 3 required
LeadEmploymentInformationJson
object
13 properties
LeadUuid
object
1 property 1 required
CreditCardOfferDetails
object
73 properties 5 required
Offer
object
11 properties 5 required
MortgageLoanType
string
LeadLoanInformationJson
object
2 properties
SpecialOffer
object
11 properties 7 required
FederalInsuranceType
string
CreditCardOffer
object
An offer for a credit card
1 property 1 required
LoanOffer
object
44 properties 12 required
ApiError
object
4 properties
SavingsOffer
object
An offer for a savings account
1 property 1 required
RefinanceType
string
LeadPersonalReferenceInformationJson
object
4 properties
LeadFinancialInformation
object
18 properties
IntroOfferType
string
EducationLevel
string
BankAccountType
string
EmploymentStatus
string
IncentiveUnit
string
Unit of measure for incentives.
PreviewDetail
object
2 properties 1 required
LeadCoApplicantInformationJson
object
The personal information of a co-applicant that may be considered in the underwriting and approval of a loan.
9 properties
LeadMortgageInformationJson
object
32 properties
RejectReason
string
ApiErrorDetails
object
IncentiveType
string
Unit of measure for incentives.
OpeId
string
identification number used by the U.S. Department of Education's Office of Postsecondary Education (OPE) to identify schools that have Program Participation Ag…
LeadPersonalInformation
object
24 properties
CardType
string
LeadActionType
string
PropertySearchStatus
string
TermUnit
string
Unit of measure for offer term lengths, or open for a single term.
RefinanceLoanType
string
CardBenefit
string
Benefits or benefit categories related to a credit card
PendingResponse
object
3 properties 2 required
LeadRefinanceLoanInformationJson
object
8 properties
LeadCreateData
object
26 properties
ProductSubType
string
A type of financial product
State
string
A two character upper case state, Puerto Rico, or District of Columbia code
ProductType
string
CitizenshipStatus
string
Citizenship status
LoanPurpose
string
Partner
object
13 properties 8 required
MortechCreditRating
string
BatchConsentVersion
string
Gender
string
LeadIdentificationInformationJson
object
3 properties
LeadCreditInformationJson
object
Credit history information relating to a Lead
2 properties
LeadClientTagsJson
object
Arbitrary key-values mappings to associate with a Lead. This field can be use to attach subids to a Lead
LeadSessionInformationJson
object
Browsing session information accociated with a Lead
3 properties
MortgageOffer
object
An offer for a mortgage
1 property 1 required
IncentiveDetails
object
4 properties 4 required
MortgageType
string
PurchaseStatus
string
SavingsOfferDetails
object
18 properties 5 required
LeadLegalInformationJson
object
Information regarding a Lead's communication consent
7 properties
OriginatorImage
object
2 properties 2 required
CompoundingMethod
string
GraduateDegreeType
string
Lead
object
31 properties 7 required
AprType
string
IdType
string
PropertyStatus
string
MortgageAdjustmentType
string
LeadHealthInformationJson
object
4 properties
MortgageOfferDetails
object
8 properties 8 required
LeadBestTimeToCall
string
LeadEducationInformationJson
object
13 properties
OccupancyType
string
EmploymentPayFrequency
string
ProvidedCreditRating
string
LeadAction
object
11 properties 5 required
RateTable
object
A RateTable customized to a Lead input
13 properties 9 required
LeadCreditCardInformationJson
object
2 properties
LeadAutoInsuranceInformationJson
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

even-financial-lead-api-openapi.yml Raw ↑

Other APIs Even Financial publishes across the network.

Even Financial Analytics API
Even Financial Approval Probability API
Even Financial Offer Preview API
Even Financial Prefill API
Even Financial UI Utils API