Skip to content

Create a business on a loan

Request

Create a business and attach it to the loan with the given role (a name from GET /roles?type=entity_in_loan, for example borrower). Accepts a full EIN. The response returns einLast4, plus the full ein when the key holds read:businesses:ein.

Security
ApiKeyAuth
Path
idstringrequired
Headers
Idempotency-Keystring, <= 255 characters

Optional opaque key (e.g. a UUID) to make this write safely retryable. A replay with the same key returns the original response instead of repeating the side effect.

Bodyapplication/jsonrequired
namestring, non-emptyrequired
rolestring, non-emptyrequired

One of the name values from GET /roles?type=entity_in_loan, for example borrower or guarantor. A name that is not one of them, or a role of another type, returns 400 role.not_found.

einstring
dbastring
entityTypestring
Enum:"C-Corp""S-Corp""General Partnership""Limited Liability Company""Limited Liability Partnership""Sole Proprietorship""Trust"
statestring
naicsstring, <= 6 characters
curl -i -X POST \
  'https://api.pioneerft.com/api/public/v1/loans/{id}/businesses' \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -d '{
    "name": "string",
    "ein": "string",
    "dba": "string",
    "entityType": "C-Corp",
    "state": "string",
    "naics": "string",
    "role": "string"
  }'

Responses

Business created

Bodyapplication/json
dataobject(PublicBusiness)
Response
{ "data": { "id": "string", "name": "string", "dba": "string", "entityType": "C-Corp", "einLast4": "string", "ein": "string", "state": "string", "naics": "string", "role": "string", "roles": [ "string" ] } }