Business info

Update the business info draft

Writes business details onto the open draft. Only the fields you send are changed; the rest are left as they are. Requires the business_info:write permission.

PATCH

https://services.magicdoor.com/companies/company-portal/business-info/{businessInfoId}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

businessInfoIdstringrequired

The business legal entity, as a Snowflake id in decimal string form.

example: 1842095537184571392

Body

application/json

Every field is optional. A field you leave out keeps its stored value.

legalNamestring

Registered legal name. Up to 150 characters. Trimmed.

legalEntityTypeenum<string>

How the business is incorporated. Required before the draft can be submitted.

soleProprietorshipllcprivateCompanypublicCompanyUnlistedpublicCompanyListedcharitableOrganizationNotForProfitpartnership

einstring

The business's federal tax identifier, up to 20 characters: nine digits with or without a dash after the second. A US Social Security number is also accepted for a sole proprietorship. A value containing the bullet character • is treated as the masked value read back from a previous response and is ignored, leaving the stored identifier untouched.

mccCodestring

Merchant category code. Up to 10 characters here, but must be exactly four digits before the draft can be submitted.

summarystring

Free-text description of what the business does. Up to 500 characters.

businessAddressobject

Registered address of the business.

startDatestring · date

The date the business started trading, as a calendar date.

Response

200 · The draft after the change.

businessInfoIdstringrequired

The business legal entity this draft belongs to, as a Snowflake id in decimal string form. Allocated when the draft is created, before anything is approved.

typeenum<string>required

What the draft is doing. initial is a brand new legal entity, update amends an approved one, supplement is a request MagicDoor opened for more information.

initialupdatesupplement

statusenum<string>required

Where the draft sits in review. Editable in draft, waitingForInformation and rejected; pendingReview is with MagicDoor; superseded is closed.

draftpendingReviewwaitingForInformationrejectedsuperseded

legalNamestring

Registered legal name of the business.

legalEntityTypeenum<string>

How the business is incorporated.

soleProprietorshipllcprivateCompanypublicCompanyUnlistedpublicCompanyListedcharitableOrganizationNotForProfitpartnership

einstring

The federal tax identifier, masked: four bullet characters followed by the last four digits, for example ••••4321. The full value is never returned here.

mccCodestring

Merchant category code. Four digits once the draft is ready for approval.

summarystring

Free-text description of what the business does.

businessAddressobject

Registered address of the business.

startDatestring · date

The date the business started trading.

principalsobject[]required

The people behind the business, with their personal identifiers masked.

documentsobject[]required

Files attached to the draft, one entry per file.

resolvedRequirementobject

The document checklist pinned to this draft when it was created. Absent when no checklist resolved.

statusReasonstring

The reason recorded on the most recent workflow change that set the current status — a rejection note, or a request for more information. Absent when that change carried no reason.

400 · A field failed its length or range check.

401 · The request carried no valid access token.

403 · The caller is not a property manager, or is missing the `business_info:write` permission.

422 · This legal entity has no open draft, or the draft is not editable.

Masked values are ignored on write

The tax identifier, email address, phone number, Social Security number and driver licence number come back masked with the bullet character •. If you send a value back that still contains a bullet, MagicDoor treats it as the mask rather than as new data and leaves the stored value unchanged. Send a real value, or leave the field out.