Create a business on a loan

Request

Create a business and attach it to the loan with the given role (e.g. "borrower", "guarantor"). Accepts a full EIN; only the last 4 digits are ever returned.

Security

ApiKeyAuth

Path

idstringrequired

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

Entity-in-loan role name, e.g. "borrower" or "guarantor" (resolved server-side; unknown names return 400). See the roles echoed by GET /loans/:id/entities.

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": "string",
    "einLast4": "string",
    "state": "string",
    "naics": "string",
    "role": "string"
  }
}