Create Application

Request

The Create Application API is used to create a new Application in the Lili platform.

The respon contains a UUID representing the applicant that was created in the Lili platform, and a URL that allows initializing the application process with the pre-filled information.

Security

accessKey

Bodyapplication/json

emailstring, (email)required

The unique ID of the webhook

phoneNumberstring

Customer phone number. E.164 format.

ssnstring, (regex)^(?!666|000|9\d{2})\d{3}-\d{2}-(?!0{4})\d{4}$...

Customer SSN

Example:"XXX-XX-XXXX"

birthDatestring, (date)

Customer birth date

firstNamestring

Customer first name

lastNamestring

Customer last name

line1string

Customer address line1

line2string

Customer address line2

citystring, [ 1 .. 30 ] characters

Customer address city

statestring

Customer address 2 letter state code

Example:"NY"

countrystring

Customer country of residence (Alpha 2, ISO 3166 format)

Example:"NY"

postalCodestring, (regex)^\d{5}(-\d{4})?$

Customer address postal code

Example:"XXXXX"

einstring, (regex)^(0[1-6]|1[0-6]|2[0-7]|3[0-9]|4[0-8]|5[0-9]|6...

Business EIN

businessNamestring

Business name

businessAddressobject(AddressData)

The physical (operational) address where the business operates day-to-day. Must be a US address. Used as the address in the Beneficial Ownership file.

registeredBusinessAddressobject(AddressData)

The registered business address (the address the business provided to the state of formation to accept legal process). Can be outside of the US, in case only a registered agent address is available. Used as the billing address and presented on bank statements and invoices.

mailingAddressobject(AddressData)

Business mailing address. Optional. Must be in the US, can be a registered agent address. Used as the card shipment address for Non-US applicants when selected.

businessTypeany

Incorporation type of the business

Enum:"DBA""LLC""MMLLC""GENERAL_PARTNERSHIP""LLP""S_CORP""SSN""C_CORP"

incorporationStatestring

State the business was incorporated in

uniqueIdstring

Unique ID to be used by the partner to identify the customer

dunsstring

Business DUNS number

passportNumberstring

Passport number

idGovNumberstring

Non US customer National ID number

idCountrystring

National ID country (Alpha 2, ISO 3166 format). Note that if a passport number is supplied, this is the passport issuance country

idExpirationDatestring

National ID expiration date. Note that if passport number is supplied, this is the passport expiration date

ownershipPercentnumber, [ 0 .. 100 ]

The ownership percentage of the customer

documentUrlsArray of strings

A list of URLs containing the business documents of the customer

documentDataListArray of objects(DocumentData)

A list of Base64 encoded documents

uboListArray of objects(UBOData)

A list of UBOs with >25% of the business ownership

naicsCodestring

NAICS code of the business

campaignstring

Campaign code

metadataobject

A map of key-value pairs to store additional partner-specific data on the customer

Example:

{
  "key1": "value1",
  "key2": "value2"
}

eddQuestionDataArray of objects(EDDQuestionData)

A list of EDD questions and answers

curl -i -X PUT \
  https://sandbox.lili.co/lili/api/v1/lead \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "user@example.com",
    "phoneNumber": "string",
    "ssn": "XXX-XX-XXXX",
    "birthDate": "2019-08-24",
    "firstName": "string",
    "lastName": "string",
    "line1": "string",
    "line2": "string",
    "city": "string",
    "state": "NY",
    "country": "NY",
    "postalCode": "XXXXX",
    "ein": "/regex/",
    "businessName": "string",
    "businessAddress": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "state": "NY",
      "postalCode": "XXXXX",
      "country": "US"
    },
    "registeredBusinessAddress": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "state": "NY",
      "postalCode": "XXXXX",
      "country": "US"
    },
    "mailingAddress": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "state": "NY",
      "postalCode": "XXXXX",
      "country": "US"
    },
    "businessType": "DBA",
    "incorporationState": "string",
    "uniqueId": "string",
    "duns": "string",
    "passportNumber": "string",
    "idGovNumber": "string",
    "idCountry": "string",
    "idExpirationDate": "string",
    "ownershipPercent": 0,
    "documentUrls": [
      "string"
    ],
    "documentDataList": [
      {
        "content": "string",
        "contentType": "string",
        "fileName": "string",
        "llcFileType": "IRS_EIN_LETTER"
      }
    ],
    "uboList": [
      {
        "email": "user@example.com",
        "phoneNumber": "string",
        "ssn": "XXX-XX-XXXX",
        "birthDate": "2019-08-24",
        "firstName": "string",
        "lastName": "string",
        "passportNumber": "string",
        "idGovNumber": "string",
        "idCountry": "string",
        "idExpirationDate": "string",
        "role": "PARTNER",
        "ownershipPercent": 25,
        "address": {
          "line1": "string",
          "line2": "string",
          "city": "string",
          "state": "NY",
          "postalCode": "XXXXX",
          "country": "US"
        }
      }
    ],
    "naicsCode": "string",
    "campaign": "string",
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    },
    "eddQuestionData": [
      {
        "question": "string",
        "answer": "string",
        "questionId": "string"
      }
    ]
  }'

Responses

Created with a URL of the onboarding link

Bodyapplication/json

customerIdstring, (uuid)required

A unique ID for the customer (same as person ID)

locationstring, (uri)required

A unique URL to be used by the customer for a personalized application flow

tokenstringrequired

The token that should be sent to Lili Connect UI

partnerSuppliedIdstring

The uniqueID provided by the partner in the Create Application call. Empty if none was supplied

metadataobject

The metadata key-value pairs stored on the customer

uboDataArray of objects(UBOResponseData)

The UBOs of the business

personIdstring, (uuid)requireddeprecated

The unique ID of the registered person

Response

{
  "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
  "location": "http://example.com",
  "token": "string",
  "partnerSuppliedId": "string",
  "personId": "f3e5ff26-28ff-4cd6-9b1b-e303a185a13a",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "uboData": [
    { … }
  ]
}