Applications APIs

Note

Different bank partners may have different onboarding requirements. If your bank partner is Thread Bank, please refer to the Thread Applications API documentation.

Create Individual Application

Create an application for an individual end-customer.

Suggestion

The SSN (or passport number, for non US citizens) is used as the unique identifier for an individual on Unit. The same identifier cannot be used to submit multiple applications. If an application for a certain individual has been denied, canceled or archived, they may use their SSN/passport number to reapply. Otherwise, duplicate applications will result in an HTTP error (400).

This functionality can be enabled/disabled on Unit dashboard at: Settings -> Org Settings -> General -> Prevent duplicate individual applications.

Verb	`POST`
URL	`https://api.s.unit.sh/applications`
Required Scope	`applications-write`
Data Type	`individualApplication`
Timeout (Seconds)	`120`

Attributes

Name	Type	Description
ssn	string	SSN (or ITIN) of the individual (numbers only). Either an `ssn` or `passport` is required. It is optional to provide only last 4 SSN digits.
passport	string	Passport number of the individual. Valid only for non-US persons. Either an `ssn` or `passport` number is required.
nationality	ISO31661-Alpha2 string	Required if a `passport` is used as the main ID and optional when `ssn` is used. Two letters representing the individual's nationality. (e.g. "US").
fullName Required	FullName	Full name of the individual.
dateOfBirth Required	RFC3339 Date string	Date only (e.g. `"2001-08-15"`).
address Required	Address	Address of the individual. Must be a US address.
phone Required	Phone	Phone number of the individual.
email Required	string	Email address of the individual.
evaluationParams Optional	EvaluationParams	Evaluation Params for this entity.
occupation Required	Occupation	Occupation of the individual.
annualIncome	AnnualIncome	Required if nationality is not US. Annual income of the individual.
sourceOfIncome	SourceOfIncome	Required if nationality is not US. Source of income of the individual.
ip Optional	string	IP address of the end-customer creating the application. Both IPv4 and IPv6 formats are supported. Highly recommended as a fraud prevention measure, if the information is available when submitting the application.
tags Optional	object	See Tags. Tags that will be copied to the customer that this application creates (see Tag Inheritance).
idempotencyKey Optional	string	See Idempotency.
deviceFingerprints Optional	Array of Device Fingerprint	A list of device fingerprints for fraud and risk prevention (See Device Fingerprints).
jwtSubject Optional	string	See this section for more information.
banks Optional	Array of Bank names	The name of the bank or banks that should be associated with this application. If not specified, the application will be associated with the Org's default bank (visible via Org Settings in the Dashboard).

Example Request:

curl -X POST 'https://api.s.unit.sh/applications'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "individualApplication",
    "attributes": {
      "ssn": "721074426",
      "fullName": {
        "first": "Peter",
        "last": "Parker"
      },
      "dateOfBirth": "2001-08-10",
      "address": {
        "street": "20 Ingram St",
        "city": "Forest Hills",
        "state": "NY",
        "postalCode": "11375",
        "country": "US"
      },
      "email": "peter@oscorp.com",
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "ip": "127.0.0.2",
      "occupation": "ArchitectOrEngineer",
      "annualIncome": "Between50kAnd100k",
      "sourceOfIncome": "EmploymentOrPayrollIncome",
      "tags": {
        "userId": "106a75e9-de77-4e25-9561-faffe59d7814"
      },
      "idempotencyKey": "3a1a33be-4e12-4603-9ed0-820922389fb8"
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data Required	IndividualApplication	The newly created resource.
included	Array of ApplicationDocument Resource	Required documents for this application. Each document resource includes the document status.

Example Response:
{
  "data": {
    "type": "individualApplication",
    "id": "53",
    "attributes": {
      "createdAt": "2020-01-14T14:05:04.718Z",
      "fullName": {
        "first": "Peter",
        "last": "Parker"
      },
      "ssn": "721074426",
      "address": {
        "street": "20 Ingram St",
        "street2": null,
        "city": "Forest Hills",
        "state": "NY",
        "postalCode": "11375",
        "country": "US"
      },
      "dateOfBirth": "2001-08-10",
      "email": "peter@oscorp.com",
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "status": "AwaitingDocuments",
      "ip": "127.0.0.2",
      "occupation": "ArchitectOrEngineer",
      "annualIncome": "Between50kAnd100k",
      "sourceOfIncome": "EmploymentOrPayrollIncome",
      "soleProprietorship": false,
      "tags": {
        "userId": "106a75e9-de77-4e25-9561-faffe59d7814"
      },
      "archived": false
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "documents": {
        "data": [
          {
            "type": "document",
            "id": "1"
          },
          {
            "type": "document",
            "id": "2"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "document",
      "id": "1",
      "attributes": {
        "documentType": "AddressVerification",
        "status": "Required",
        "name": "Peter Parker",
        "description": "Please provide a document to verify your address. Document may be a utility bill, bank statement, lease agreement or current pay stub.",
        "address": {
          "street": "20 Ingram St",
          "street2": null,
          "city": "Forest Hills",
          "state": "NY",
          "postalCode": "11375",
          "country": "US"
        }
      }
    },
    {
      "type": "document",
      "id": "2",
      "attributes": {
        "documentType": "IdDocument",
        "status": "Required",
        "name": "Peter Parker",
        "description": "Please provide a copy of your unexpired government issued photo ID which would include Drivers License or State ID.",
        "dateOfBirth": "2001-08-10"
      }
    }
  ]
}

Create Sole Proprietor Application

Create an application for a sole proprietor.

Suggestion

A sole proprietorship is a type of enterprise owned and run by one person, and in which there is no legal distinction between the owner and the business entity. As such, it is evaluated as an individual, with the soleProprietorship attribute set to true

Suggestion

This functionality can be enabled/disabled on Unit dashboard at: Settings -> Org Settings -> General -> Prevent duplicate individual applications.

Verb	`POST`
URL	`https://api.s.unit.sh/applications`
Required Scope	`applications-write`
Data Type	`individualApplication`
Timeout (Seconds)	`120`

Attributes

Name	Type	Description
ssn	string	SSN (or ITIN) of the individual (numbers only). Either an `ssn` or `passport` is required.
passport	string	Passport number of the individual. Valid only for non-US persons. Either an `ssn` or `passport` number is required.
nationality	ISO31661-Alpha2 string	Required if a `passport` is used as the main ID and optional when `ssn` is used. Two letters representing the individual's nationality. (e.g. "US").
fullName Required	FullName	Full name of the individual.
dateOfBirth Required	RFC3339 Date string	Date only (e.g. `"2001-08-15"`).
address Required	Address	Address of the individual. Must be a US address.
phone Required	Phone	Phone number of the individual.
email Required	string	Email address of the individual.
soleProprietorship Required	boolean	Set this to `true` in order to indicate that the individual is a sole proprietor.
ein Optional	string	If the individual is a sole proprietor who has an Employer Identification Number, specify it here. Not all sole proprietors have an EIN, so this attribute is optional, even when `soleProprietorship` is set to `true`.
dba Optional	string	If the individual is a sole proprietor who is doing business under a different name, specify it here. This attribute is optional, even when `soleProprietorship` is set to `true`.
evaluationParams Optional	EvaluationParams	Evaluation Params for this entity.
annualRevenue	AnnualRevenue	Required if nationality is not US. For sole proprietors, specify the annual revenue here.
numberOfEmployees	NumberOfEmployees	Required if nationality is not US. For sole proprietors, specify the number of employees here.
businessVertical Required	BusinessVertical	For sole proprietors, specify the business vertical here.
website Required	string	A Valid website Url. Providing a `null` value is indicative of the business customer attesting that they do not have a website.
ip Optional	string	IP address of the end-customer creating the application. Both IPv4 and IPv6 formats are supported. Highly recommended as a fraud prevention measure, if the information is available when submitting the application.
tags Optional	object	See Tags. Tags that will be copied to the customer that this application creates (see Tag Inheritance).
idempotencyKey Optional	string	See Idempotency.
deviceFingerprints Optional	Array of Device Fingerprint	A list of device fingerprints for fraud and risk prevention (See Device Fingerprints).
jwtSubject Optional	string	See this section for more information.
banks Optional	Array of Bank names	The name of the bank or banks that should be associated with this application. If not specified, the application will be associated with the Org's default bank (visible via Org Settings in the Dashboard).
requestedProducts Optional	Array of Product	The product being applied for. Contact Unit to enable BillPay and Capital products.

Example Request:

curl -X POST 'https://api.s.unit.sh/applications'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "individualApplication",
    "attributes": {
      "ssn": "721074426",
      "fullName": {
        "first": "Peter",
        "last": "Parker"
      },
      "dateOfBirth": "2001-08-10",
      "address": {
        "street": "20 Ingram St",
        "city": "Forest Hills",
        "state": "NY",
        "postalCode": "11375",
        "country": "US"
      },
      "email": "peter@oscorp.com",
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "ip": "127.0.0.2",
      "soleProprietorship": true,
      "ein": "123456789",
      "dba": "Piedpiper Inc",
      "businessVertical": "TechnologyMediaOrTelecom",
      "numberOfEmployees": "Between5And10",
      "website": "https://www.piedpiper.com",
      "tags": {
        "userId": "106a75e9-de77-4e25-9561-faffe59d7814"
      },
      "idempotencyKey": "3a1a33be-4e12-4603-9ed0-820922389fb8"
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data Required	IndividualApplication	The newly created resource.
included	Array of ApplicationDocument Resource	Required documents for this application. Each document resource includes the document status.

Example Response:
{
  "data": {
    "type": "individualApplication",
    "id": "53",
    "attributes": {
      "createdAt": "2020-01-14T14:05:04.718Z",
      "fullName": {
        "first": "Peter",
        "last": "Parker"
      },
      "ssn": "721074426",
      "address": {
        "street": "20 Ingram St",
        "street2": null,
        "city": "Forest Hills",
        "state": "NY",
        "postalCode": "11375",
        "country": "US"
      },
      "dateOfBirth": "2001-08-10",
      "email": "peter@oscorp.com",
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "status": "AwaitingDocuments",
      "ip": "127.0.0.2",
      "soleProprietorship": true,
      "ein": "123456789",
      "dba": "Piedpiper Inc",
      "occupation": "ArchitectOrEngineer",
      "annualIncome": "Between50kAnd100k",
      "sourceOfIncome": "EmploymentOrPayrollIncome",
      "annualRevenue": "Between100kAnd200k",
      "numberOfEmployees": "Between5And10",
      "businessVertical": "TechnologyMediaOrTelecom",
      "website": "https://www.piedpiper.com",
      "tags": {
        "userId": "106a75e9-de77-4e25-9561-faffe59d7814"
      },
      "archived": false
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "documents": {
        "data": [
          {
            "type": "document",
            "id": "1"
          },
          {
            "type": "document",
            "id": "2"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "document",
      "id": "1",
      "attributes": {
        "documentType": "AddressVerification",
        "status": "Required",
        "name": "Peter Parker",
        "description": "Please provide a document to verify your address. Document may be a utility bill, bank statement, lease agreement or current pay stub.",
        "address": {
          "street": "20 Ingram St",
          "street2": null,
          "city": "Forest Hills",
          "state": "NY",
          "postalCode": "11375",
          "country": "US"
        }
      }
    },
    {
      "type": "document",
      "id": "2",
      "attributes": {
        "documentType": "IdDocument",
        "status": "Required",
        "name": "Peter Parker",
        "description": "Please provide a copy of your unexpired government issued photo ID which would include Drivers License or State ID.",
        "dateOfBirth": "2001-08-10"
      }
    }
  ]
}

Create Business Application

Create an application for a business end-customer.

Suggestion

Companies that are publicly traded in a major US stock exchange are subject to lighter onboarding requirements. If your customer base includes publicly traded companies, please reach out to Unit for additional information.

Verb	`POST`
URL	`https://api.s.unit.sh/applications`
Required Scope	`applications-write`
Data Type	`businessApplication`
Timeout (Seconds)	`120`

Attributes

Name	Type	Description
name Required	string	Name of the business.
dba Optional	string	"Doing business as".
address Required	Address	Address of the business. Must be a US address
phone Required	Phone	Phone number of the business.
stateOfIncorporation Required	string	Two letters representing a US state.
ein Required	string	Business EIN (numbers only).
entityType Required	string	One of `LLC`, `Partnership`, `PubliclyTradedCorporation`, `PrivatelyHeldCorporation` or `NotForProfitOrganization`.
website Required	string	A Valid website Url. Providing a `null` value is indicative of the business customer attesting that they do not have a website.
contact Required	BusinessContact	Primary contact of the business. This person is the one that will have access to the account.
officer Required	Officer	Officer representing the business. See OfficerTitle for allowed `title` values. To successfully onboard a business, provide the officer's personal details.
beneficialOwners Required	Array of BeneficialOwner	Array of beneficial owners in the business. A beneficial owner is anyone who owns at least 25% of the business. To successfully onboard a business, provide each beneficial owner's personal details. If the business has no beneficial owners, the array should be empty.
attestedNoBeneficialOwners Required	boolean	`true` if no beneficial owners are provided; otherwise - `false` .
annualRevenue	AnnualRevenue	Required if any of the officer / BeneficialOwner of the business have a non US nationality. Annual revenue of the business.
numberOfEmployees	NumberOfEmployees	Required if any of the officer / BeneficialOwner of the business have a non US nationality. Number of employees of the business.
cashFlow	CashFlow	Required if any of the officer / BeneficialOwner of the business have a non US nationality. Cash flow of the business.
yearOfIncorporation Required	Year string	Year of incorporation of the business as a 4-digit year string (e.g., `"2014"`).
countriesOfOperation	Array of ISO31661-Alpha2 strings	Required if any of the officer / BeneficialOwner of the business have a non US nationality. An array of two letter codes representing the countries of operation of the business.
stockSymbol Optional	string	The stock symbol (ticker) of the business.
businessVertical Required	BusinessVertical	The business vertical of the business.
ip Optional	string	IP address of the end-customer creating the application. Both IPv4 and IPv6 formats are supported. Highly recommended as a fraud prevention measure, if the information is available when submitting the application.
tags Optional	object	See Tags. Tags that will be copied to the customer that this application creates (see Tag Inheritance).
idempotencyKey Optional	string	See Idempotency.
deviceFingerprints Optional	Array of Device Fingerprint	A list of device fingerprints for fraud and risk prevention (See Device Fingerprints).
banks Optional	Array of Bank names	The name of the bank or banks that should be associated with this application. If not specified, the application will be associated with the Org's default bank (visible via Org Settings in the Dashboard).
requestedProducts Optional	Array of Product	The product being applied for. Contact Unit to enable BillPay and Capital products.

Example Request:

curl -X POST 'https://api.s.unit.sh/applications'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "businessApplication",
    "attributes": {
      "name": "Pied Piper",
      "address": {
        "street": "5230 Newell Rd",
        "city": "Palo Alto",
        "state": "CA",
        "postalCode": "94303",
        "country": "US"
      },
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "stateOfIncorporation": "DE",
      "ein": "123456789",
      "entityType": "Corporation",
      "ip": "127.0.0.2",
      "annualRevenue": "Between500kAnd1m",
      "numberOfEmployees": "Between50And100",
      "cashFlow": "Predictable",
      "yearOfIncorporation": "2014",
      "countriesOfOperation": [
        "US",
        "CA"
      ],
      "stockSymbol": "PPI",
      "businessVertical": "TechnologyMediaOrTelecom",
      "website": "https://www.piedpiper.com",
      "contact": {
        "fullName": {
          "first": "Richard",
          "last": "Hendricks"
        },
        "email": "richard@piedpiper.com",
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        }
      },
      "officer": {
        "fullName": {
          "first": "Richard",
          "last": "Hendricks"
        },
        "dateOfBirth": "2001-08-10",
        "title": "CEO",
        "ssn": "721074426",
        "email": "richard@piedpiper.com",
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        },
        "address": {
          "street": "5230 Newell Rd",
          "city": "Palo Alto",
          "state": "CA",
          "postalCode": "94303",
          "country": "US"
        },
        "occupation": "ArchitectOrEngineer",
        "annualIncome": "Between50kAnd100k",
        "sourceOfIncome": "EmploymentOrPayrollIncome"
      },
      "beneficialOwners": [
        {
          "fullName": {
            "first": "Richard",
            "last": "Hendricks"
          },
          "dateOfBirth": "2001-08-10",
          "ssn": "123456789",
          "email": "richard@piedpiper.com",
          "percentage": 75,
          "phone": {
            "countryCode": "1",
            "number": "5555555555"
          },
          "address": {
            "street": "5230 Newell Rd",
            "city": "Palo Alto",
            "state": "CA",
            "postalCode": "94303",
            "country": "US"
          },
          "occupation": "ArchitectOrEngineer",
          "annualIncome": "Between50kAnd100k",
          "sourceOfIncome": "EmploymentOrPayrollIncome"
        }
      ],
      "tags": {
        "userId": "2ab1f266-04b9-41fb-b728-cd1962bca52c"
      },
      "idempotencyKey": "3a1a33be-4e12-4603-9ed0-820922389fb8"
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data Required	BusinessApplication	The newly created resource.
relationships Required	JSON:API Relationships	Describes relationships between the application resource and other resources (beneficial owners).
included	Array of ApplicationDocument Resource or BeneficialOwner Resource	Required documents for this application. Each document resource includes the document status. List of the application's beneficial owners.

Example Response:
{
  "data": {
    "type": "businessApplication",
    "id": "50",
    "attributes": {
      "createdAt": "2020-01-13T16:01:19.346Z",
      "name": "Pied Piper",
      "dba": null,
      "address": {
        "street": "5230 Newell Rd",
        "street2": null,
        "city": "Palo Alto",
        "state": "CA",
        "postalCode": "94303",
        "country": "US"
      },
      "phone": {
        "countryCode": "1",
        "number": "5555555555"
      },
      "stateOfIncorporation": "DE",
      "ein": "123456789",
      "entityType": "Corporation",
      "ip": "127.0.0.2",
      "website": "https://www.piedpiper.com",
      "annualRevenue": "Between500kAnd1m",
      "numberOfEmployees": "Between50And100",
      "cashFlow": "Predictable",
      "yearOfIncorporation": "2014",
      "countriesOfOperation": [
        "US",
        "CA"
      ],
      "stockSymbol": "PPI",
      "businessVertical": "TechnologyMediaOrTelecom",
      "contact": {
        "fullName": {
          "first": "Richard",
          "last": "Hendricks"
        },
        "email": "richard@piedpiper.com",
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        }
      },
      "officer": {
        "fullName": {
          "first": "Richard",
          "last": "Hendricks"
        },
        "ssn": "123456789",
        "address": {
          "street": "5230 Newell Rd",
          "street2": null,
          "city": "Palo Alto",
          "state": "CA",
          "postalCode": "94303",
          "country": "US"
        },
        "dateOfBirth": "2001-08-10",
        "title": "CEO",
        "email": "richard@piedpiper.com",
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        },
        "occupation": "ArchitectOrEngineer",
        "annualIncome": "Between50kAnd100k",
        "sourceOfIncome": "EmploymentOrPayrollIncome",
        "status": "Approved"
      },
      "beneficialOwners": [
        {
          "fullName": {
            "first": "Richard",
            "last": "Hendricks"
          },
          "ssn": "123456789",
          "address": {
            "street": "5230 Newell Rd",
            "street2": null,
            "city": "Palo Alto",
            "state": "CA",
            "postalCode": "94303",
            "country": "US"
          },
          "dateOfBirth": "2001-08-10",
          "phone": {
            "countryCode": "1",
            "number": "5555555555"
          },
          "email": "richard@piedpiper.com",
          "percentage": 75,
          "status": "Approved"
        }
      ],
      "attestedNoBeneficialOwners": false,
      "tags": {
        "userId": "2ab1f266-04b9-41fb-b728-cd1962bca52c"
      },
      "archived": false,
      "status": "AwaitingDocuments"
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "documents": {
        "data": [
          {
            "type": "document",
            "id": "1"
          },
          {
            "type": "document",
            "id": "2"
          },
          {
            "type": "document",
            "id": "3"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "document",
      "id": "1",
      "attributes": {
        "documentType": "CertificateOfIncorporation",
        "status": "Required",
        "name": "Pied Piper",
        "description": "For Corporation: Please provide a certified copy of the Articles of Incorporation or Certificate of Incorporation..."
      }
    },
    {
      "type": "document",
      "id": "2",
      "attributes": {
        "documentType": "AddressVerification",
        "status": "Required",
        "name": "Richard Hendricks",
        "description": "Please provide a document to verify your address. Document may be a utility bill, bank statement, lease agreement or current pay stub.",
        "address": {
          "street": "5230 Newell Rd",
          "street2": null,
          "city": "Palo Alto",
          "state": "CA",
          "postalCode": "94303",
          "country": "US"
        }
      }
    },
    {
      "type": "document",
      "id": "3",
      "attributes": {
        "documentType": "IdDocument",
        "status": "Required",
        "name": "Richard Hendricks",
        "description": "Please provide a copy of your unexpired government issued photo ID which would include Drivers License or State ID."
      }
    }
  ]
}

Cancel Application

Cancel an Application under PendingReview or AwaitingDocuments status. The application.canceled webhook event will be fired.

Verb	`POST`
URL	`https://api.s.unit.sh/applications/{id}/cancel`
Data Type	`applicationCancel`
Timeout (Seconds)	`5`

Example Request:

curl -X POST 'https://api.s.unit.sh/applications/{id}/cancel'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "applicationCancel",
    "attributes": {
      "reason": "By Org"
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data Required	IndividualApplication or BusinessApplication	Application resource. Can be business or individual.
included	Array of ApplicationDocument Resource	Application required documents, each document object also includes the document status.

Get by Id

Get an application resource by id.

Verb	`GET`
URL	`https://api.s.unit.sh/applications/{id}`
Required Scope	`applications`
Timeout (Seconds)	`5`

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	IndividualApplication or BusinessApplication	Application resource. Can be business or individual, as indicated by the `type` field.
included	Array of ApplicationDocument Resource or BeneficialOwner Resource	Required documents for this application. Each document resource includes the document status. List of the application's beneficial owners.

curl -X GET 'https://api.s.unit.sh/applications/43' \
-H "Authorization: Bearer ${TOKEN}"

List

List application resources. Paging can be applied.

Verb	`GET`
URL	`https://api.s.unit.sh/applications`
Required Scope	`applications`
Timeout (Seconds)	`5`

Query Parameters

Name	Type	Default	Description
page[limit]	integer	100	Optional. Maximum number of resources that will be returned. Maximum is 1000 resources. See Pagination.
page[offset]	integer	0	Optional. Number of resources to skip. See Pagination.
filter[query]	string	(empty)	Optional. Search term according to the Full-Text Search Rules.
filter[status][]	string	(empty)	Optional. Filter applications by Application Status. Usage example: filter[status][0]=Pending&filter[status][1]=Approved
filter[email]	string	(empty)	Optional. Filter applications by email address (case sensitive).
filter[tags]	Tags (JSON)	(empty)	Optional. Filter Applications by Tags.
sort	string	`sort=-createdAt`	Optional. `sort=createdAt` for ascending order or `sort=-createdAt` (leading minus sign) for descending order.

curl -X GET 'https://api.s.unit.sh/applications?page[limit]=20&page[offset]=10' \
-H "Authorization: Bearer ${TOKEN}"

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	Array of IndividualApplication or BusinessApplication	Array of application resources. Each resource can be business or individual, as indicated by the `type` field.
meta Required	JSON object that contains pagination data	Pagination data includes offset, limit and total (estimated total items).

Example Response:
{
  "data": [
    {
      "type": "individualApplication",
      "id": "1",
      "attributes": {
        "createdAt": "2020-01-15T13:47:36.098Z",
        "fullName": {
          "first": "Peter",
          "last": "Parker"
        },
        "ssn": "721074426",
        "address": {
          "street": "20 Ingram St",
          "street2": null,
          "city": "Forest Hills",
          "state": "NY",
          "postalCode": "11375",
          "country": "US"
        },
        "dateOfBirth": "2001-08-10",
        "email": "peter@oscorp.com",
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        },
        "status": "AwaitingDocuments",
        "occupation": "ArchitectOrEngineer",
        "annualIncome": "Between50kAnd100k",
        "sourceOfIncome": "EmploymentOrPayrollIncome",
        "archived": false,
        "message": "Waiting for you to upload the required documents."
      },
      "relationships": {
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "documents": {
          "data": [
            {
              "type": "document",
              "id": "1"
            },
            {
              "type": "document",
              "id": "2"
            }
          ]
        }
      }
    },
    {
      "type": "businessApplication",
      "id": "2",
      "attributes": {
        "createdAt": "2020-01-15T13:48:38.527Z",
        "name": "Pied Piper",
        "dba": null,
        "address": {
          "street": "5230 Newell Rd",
          "street2": null,
          "city": "Palo Alto",
          "state": "CA",
          "postalCode": "94303",
          "country": "US"
        },
        "phone": {
          "countryCode": "1",
          "number": "5555555555"
        },
        "stateOfIncorporation": "DE",
        "ein": "123456789",
        "entityType": "Corporation",
        "contact": {
          "fullName": {
            "first": "Richard",
            "last": "Hendricks"
          },
          "email": "richard@piedpiper.com",
          "phone": {
            "countryCode": "1",
            "number": "5555555555"
          }
        },
        "officer": {
          "fullName": {
            "first": "Richard",
            "last": "Hendricks"
          },
          "ssn": "123456789",
          "address": {
            "street": "5230 Newell Rd",
            "street2": null,
            "city": "Palo Alto",
            "state": "CA",
            "postalCode": "94303",
            "country": "US"
          },
          "dateOfBirth": "2001-08-10",
          "email": "richard@piedpiper.com",
          "phone": {
            "countryCode": "1",
            "number": "5555555555"
          },
          "status": "Approved"
        },
        "beneficialOwners": [
          {
            "fullName": {
              "first": "Richard",
              "last": "Hendricks"
            },
            "ssn": "123456789",
            "address": {
              "street": "5230 Newell Rd",
              "street2": null,
              "city": "Palo Alto",
              "state": "CA",
              "postalCode": "94303",
              "country": "US"
            },
            "dateOfBirth": "2001-08-10",
            "phone": {
              "countryCode": "1",
              "number": "5555555555"
            },
            "email": "richard@piedpiper.com",
            "status": "Approved"
          }
        ],
        "attestedNoBeneficialOwners": false,
        "archived": false,
        "status": "AwaitingDocuments",
        "annualRevenue": "Between500kAnd1m",
        "numberOfEmployees": "Between50And100",
        "cashFlow": "Predictable",
        "yearOfIncorporation": "2014",
        "countriesOfOperation": [
          "US"
        ],
        "stockSymbol": "PPI",
        "businessVertical": "TechnologyMediaOrTelecom",
        "website": "https://www.piedpiper.com",
        "message": "Waiting for you to upload the required documents."
      },
      "relationships": {
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "documents": {
          "data": [
            {
              "type": "document",
              "id": "1"
            },
            {
              "type": "document",
              "id": "2"
            },
            {
              "type": "document",
              "id": "3"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "limit": 100,
      "offset": 0
    }
  }
}

Update Business

Update a business application.

Deprecated

As of February 28, 2027, applications will become immutable when they reach a final state. Therefore, all application attributes, other than tags, could be updated only while the application is in PendingReview or AwaitingDocuments status.

To update the customer information after the application is approved, please update the relevant attributes on the Customer resource.

During the sunset period and until application immutability is enforced, updates made to approved applications will be replicated to the corresponding fields on the customer resource.

Note

Tags that are updated after the application has been approved will not be inherited by the corresponded customer resource.

Verb	`PATCH`
URL	`https://api.s.unit.sh/applications/:id`
Required Scope	`applications-write`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
tags Required	object	See Updating Tags.
annualRevenue Optional	AnnualRevenue	Annual revenue of the business.
numberOfEmployees Optional	NumberOfEmployees	Number of employees of the business.
cashFlow Optional	CashFlow	Cash flow of the business.
yearOfIncorporation Optional	Year string	Year of incorporation of the business.
countriesOfOperation Optional	Array of ISO31661-Alpha2 strings	An array of two letter codes representing the countries of operation of the business.
stockSymbol Optional	string	The stock symbol (ticker) of the business.
website Optional	string	A Valid website Url.
businessVertical Optional	BusinessVertical	The business vertical of the business.

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	BusinessApplication	The updated BusinessApplication resource.
relationships Required	JSON:API Relationships	Describes relationships between the application resource and other resources (beneficial owners).
included	Array of ApplicationDocument Resource or BeneficialOwner Resource	Required documents for this application. Each document resource includes the document status. List of the application's beneficial owners.

Update business application:

curl -X PATCH 'https://api.s.unit.sh/application/:id'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "businessApplication",
    "attributes": {
      "tags": {
        "by": "Richard Hendricks",
        "id": "23033b64-38f8-4dbc-91a1-313ff0156d02"
      },
      "annualRevenue": "Between500kAnd1m",
      "numberOfEmployees": "Between50And100",
      "cashFlow": "Predictable",
      "yearOfIncorporation": "2014",
      "countriesOfOperation": [
        "US",
        "CA"
      ],
      "stockSymbol": "PPI",
      "businessVertical": "TechnologyMediaOrTelecom"
    }
  }
}'

Update Business Officer

Update a business application's officer.

Deprecated

As of February 28, 2027, applications will become immutable when they reach a final state. Therefore, all officer attributes could be updated only while the application is in PendingReview or AwaitingDocuments status.

To update the officer information after the application is approved, please update the relevant attributes on the Officer resource.

During the sunset period and until application immutability is enforced, updates made to approved applications will be replicated to the corresponding fields on the customer resource.

Verb	`PATCH`
URL	`https://api.s.unit.sh/applications/:id`
Required Scope	`applications-write`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
officer.title Optional	OfficerTitle	Title of the officer.
officer.occupation Optional	Occupation	Occupation of the officer.
officer.annualIncome Optional	AnnualIncome	Annual income of the officer.
officer.sourceOfIncome Optional	SourceOfIncome	Source of income of the officer.

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	BusinessApplication	The updated BusinessApplication resource.
relationships Required	JSON:API Relationships	Describes relationships between the application resource and other resources (beneficial owners).
included	Array of ApplicationDocument Resource or BeneficialOwner Resource	Required documents for this application. Each document resource includes the document status. List of the application's beneficial owners.

Update business application officer:

curl -X PATCH 'https://api.s.unit.sh/application/:id'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "businessApplication",
    "attributes": {
      "officer": {
        "occupation": "ArchitectOrEngineer",
        "annualIncome": "Between10kAnd25k",
        "sourceOfIncome": "EmploymentOrPayrollIncome",
        "title": "CEO"
      }
    }
  }
}'

Update Business Beneficial Owner

Update a business application's beneficial owner. The application id associated with the beneficial owner must be passed as a relationship in the request body.

Verb	`PATCH`
URL	`https://api.s.unit.sh/beneficial-owner/:id`
Required Scope	`applications-write`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
occupation Optional	Occupation	Occupation of the beneficial owner.
annualIncome Optional	AnnualIncome	Annual income of the beneficial owner.
sourceOfIncome Optional	SourceOfIncome	Source of income of the beneficial owner.
percentage Optional	integer	The beneficial owner percentage of ownership at the business (between 25 and 100).

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	BeneficialOwner	The updated BeneficialOwner resource.

Update business application beneficial owner:

curl -X PATCH 'https://api.s.unit.sh/beneficial-owner/:id'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "beneficialOwner",
    "attributes": {
      "occupation": "ArchitectOrEngineer",
      "annualIncome": "Between10kAnd25k",
      "sourceOfIncome": "EmploymentOrPayrollIncome"
    },
    "relationships": {
      "application": {
        "data": {
          "type": "businessApplication",
          "id": "10001"
        }
      }
    }
  }
}'

Update Individual

Update an individual application.

Deprecated

To update the customer information after the application is approved, please update the relevant attributes on the Customer resource.

During the sunset period and until application immutability is enforced, updates made to approved applications will be replicated to the corresponding fields on the customer resource.

Note

Tags that are updated after the application has been approved will not be inherited by the corresponded customer resource.

Verb	`PATCH`
URL	`https://api.s.unit.sh/applications/:id`
Required Scope	`applications-write`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
tags Required	object	See Updating Tags.
occupation Optional	Occupation	Occupation of the individual.
annualIncome Optional	AnnualIncome	Annual income of the individual.
sourceOfIncome Optional	SourceOfIncome	Source of income of the individual.

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	IndividualApplication	The updated IndividualApplication resource.

Update individual application:

curl -X PATCH 'https://api.s.unit.sh/application/:id'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "individualApplication",
    "attributes": {
      "tags": {
        "by": "Richard Hendricks",
        "id": "23033b64-38f8-4dbc-91a1-313ff0156d02"
      },
      "occupation": "ArchitectOrEngineer",
      "annualIncome": "Between10kAnd25k",
      "sourceOfIncome": "EmploymentOrPayrollIncome"
    }
  }
}'

Update Sole Proprietor

Update a sole-proprietorship application.

Deprecated

To update the customer information after the application is approved, please update the relevant attributes on the Customer resource.

During the sunset period and until application immutability is enforced, updates made to approved applications will be replicated to the corresponding fields on the customer resource.

Note

Tags that are updated after the application has been approved will not be inherited by the corresponded customer resource.

Verb	`PATCH`
URL	`https://api.s.unit.sh/applications/:id`
Required Scope	`applications-write`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
tags Required	object	See Updating Tags.
annualRevenue Optional	AnnualRevenue	Specify the annual revenue here.
numberOfEmployees Optional	NumberOfEmployees	Specify the number of employees here.
businessVertical Optional	BusinessVertical	Specify the business vertical here.
website Optional	string	Specify the business website here.

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data Required	IndividualApplication	The updated IndividualApplication resource.

Update sole-proprietor application:

curl -X PATCH 'https://api.s.unit.sh/application/:id'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "individualApplication",
    "attributes": {
      "tags": {
        "by": "Richard Hendricks",
        "id": "23033b64-38f8-4dbc-91a1-313ff0156d02"
      },
      "annualRevenue": "UpTo50k",
      "numberOfEmployees": "Between2And5",
      "businessVertical": "BusinessSupportOrBuildingServices",
      "website": "https://unit.co"
    }
  }
}'

Create Individual Application​

Attributes​

Response​

201 Created​

Create Sole Proprietor Application​

Attributes​

Response​

201 Created​

Create Business Application​

Attributes​

Response​

201 Created​

Cancel Application​

Response​

201 Created​

Get by Id​

Response​

200 OK​

List​

Query Parameters​

Response​

200 OK​

Update Business​

Deprecated

Attributes​

Response​

200 OK​

Update Business Officer​

Deprecated

Attributes​

Response​

200 OK​

Update Business Beneficial Owner​

Attributes​

Response​

200 OK​

Update Individual​

Deprecated

Attributes​

Response​

200 OK​

Update Sole Proprietor​

Deprecated

Attributes​

Response​

200 OK​

Create Individual Application

Attributes

Response

201 Created

Create Sole Proprietor Application

Attributes

Response

201 Created

Create Business Application

Attributes

Response

201 Created

Cancel Application

Response

201 Created

Get by Id

Response

200 OK

List

Query Parameters

Response

200 OK

Update Business

Attributes

Response

200 OK

Update Business Officer

Attributes

Response

200 OK

Update Business Beneficial Owner

Attributes

Response

200 OK

Update Individual

Attributes

Response

200 OK

Update Sole Proprietor

Attributes

Response

200 OK