POST
/
Boarding
/
read
/
{xId}

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Path Parameters

xId
string
required

The application ID in Hex format. Find this at the end of the boarding link URL returned in a call to api/Boarding/applink/{appId}/{mail2}. For example in: https://boarding-sandbox.payabli.com/boarding/externalapp/load/17E, the xId is 17E.

Body

email
string | null

The email address the applicant used to save the application.

referenceId
string | null

The referenceId is sent to the applicant via email when they save the application.

Response

200 - application/json
annualRevenue
number | null

Annual revenue amount.

averageMonthlyVolume
number | null

Average total amount of transactions in your local currency that are processed each month.

averageTicketAmount
number | null

The average transaction size that the business expects to process. For example, if you process $10,000 a month across 10 transactions, that's an average ticket of $1000.

bAddress1
string | null

Business address.

bAddress2
string | null

Business address additional line.

bankData
object[] | null

Information about associated bank accounts.

bCity
string | null

Business city

bCountry
string | null

Business country in ISO-3166-1 alpha 2 format
Check out https://en.wikipedia.org/wiki/ISO_3166-1 for reference

bFax
string | null

The business's fax number.

binPerson
integer | null

Numeric percent of volume processed in person. To pass validation, binperson, binweb, and binphone must total 100 together.

binPhone
integer | null

Numeric percent of volume processed by phone. To pass validation, binperson, binweb, and binphone must total 100 together.

binWeb
integer | null

Numeric percent of volume processed on web. To pass validation, binperson, binweb, and binphone must total 100 together.

The boarding link ID. Can be found at the end of the boarding link reference name. The boarding link reference name. For example https://boarding.payabli.com/boarding/app/myorgaccountname-00091. The ID is 91.

boardingStatus
integer

The application's status in the merchant boarding process. See Boarding Status Reference for more.

boardingSubStatus
integer

The application's status in the merchant boarding process. See Boarding Status Reference for more.

bPhone
string | null

Business phone number.

bStartdate
string | null

Business start date.
Accepted formats:

  • YYYY-MM-DD
  • MM/DD/YYYY
bState
string | null

Business state.

bSummary
string | null

A summary of what the business sells in terms of goods or services.

builderData
object
bZip
string | null

Business ZIP.

contactData
object[] | null

List of contacts.

createdAt
string

Timestamp of when record was created, in UTC.

dbaName
string | null

The alternate or common name that this business is doing business under usually referred to as a DBA name.

documentsRef
object
ein
string | null

Business EIN or tax ID.

externalPaypointId
string | null

A custom identifier for the paypoint, if applicable. Like entrypoint is the Payabli identifier for the merchant, externalPaypointId is a custom field you can use to include the merchant's ID from your own systems.

generalEvents
object[] | null

Events associated with the application.

highTicketAmount
number | null

High ticket amount.

idApplication
integer

Boarding application ID.

lastModified
string | null

Timestamp of when record was last updated, in UTC.

Business legal name.

license
string | null

Business license ID or state ID number.

licenseState
string | null

Business license issuing state or province.

Object containing logo file.

mAddress1
string | null

The business's mailing address.

mAddress2
string | null

Additional line for the business's mailing address.

mccid
string | null
mCity
string | null

The business's mailing address state.

mCountry
string | null

Business mailing country.

mState
string | null

The business's mailing address state.

mZip
string | null

Business mailing ZIP.

orgId
integer | null

Organization ID. Unique identifier assigned to an org by Payabli.

orgParentName
string | null

The name of the parent organization.

ownerData
object[] | null

List of Owners with at least a 25% ownership.

ownType
enum<string> | null

The business ownership type.

Available options:
Limited Liability Company,
Non-Profit Org,
Partnership,
Private Corp,
Public Corp,
Tax Exempt,
Government,
Sole Proprietor
pageidentifier
string | null

Auxiliary validation used internally by payment pages and components.

recipientEmailNotification
boolean
default:
true

When true, Payabli will send the applicant a boarding link. Set this value to false if you are sending pre-filled applications via the API and don't want Payabli to send the applicant an email to complete the boarding application.

resumable
boolean
default:
true

When true, the applicant can save an incomplete application and resume it later. When false, the applicant won't have an option to save their progress, and must complete the application in one session.

salesCode
string | null
serviceData
object

Controls which services will be enabled for the merchant.

signer
object

Information about the application's signer.

taxfillname
string | null

Business name in tax document. This is only relevant if a government entity has given you an alternative name to file tax documents with.

templateId
integer | null

The associated boarding template's ID in Payabli.

websiteAddress
string | null

The business website address. Include only the domain and TLD, do not enter the protocol (http/https). For example: www.example.com is acceptable.

whencharged
enum<string>

Describes when customers are charged for goods or services. Accepted values:

Available options:
When Service Provided,
In Advance
whendelivered
enum<string>

When goods and services are delivered.

Available options:
0-7 Days,
8-14 Days,
15-30 Days,
Over 30 Days
whenProvided
enum<string>

Describes when goods or services are provided, from time of transaction.

Available options:
30 Days or Less,
31 to 60 Days,
60+ Days
whenrefund
enum<string>

Describes the business refund policy.

Available options:
Exchange Only,
No Refund or Exchange,
More than 30 days,
30 Days or Less