Service status ·A8 Core™ · The Operating System for Financial Accounts ·The account operating system · API-first

A8Core™

API reference v1

Account types

1031 Exchange Escrowgated

I.R.C. § 1031(a)(1) real property only; Treas. Reg. § 1.1031(k)-1(g)(6), (k)

On this pageOverview Authority Parameters Example Eligible assets Rules

Slug	`1031-exchange-escrow`
Nature	`CustodialHolding` — Beneficial owner holds title; the institution holds possession. Off balance sheet.
Contributions	`NotApplicable`
Earnings	`NotApplicable`
Contribution year	`NotApplicable`
Status	gated
Legacy code	`X31` — ISCP import and statement templates only. Not identity, and not accepted by the API.

Required authority

An institution may open this account only if it satisfies every requirement group below. Within a group, any one authority suffices. Across groups, all must be satisfied.

Group	Any one of
Group 1	`IrsNonbankCustodian` or `Bank` or `StateTrustCompany`

Resolve availability at runtime with GET https://api.a8core.io/v1/account-types. Never hard-code it.

Create Account parameters

POSThttps://api.a8core.io/v1/accountsoperation: CreateAccount

Name	Type		Description
ProviderReferenceId	string	optional	Your internal reference. Used as the idempotency key.
ClientId	Guid	required	The A8 Core™ Client ID that owns the account.
AccountTypeCode	string	required	Must be `1031-exchange-escrow`.
InstitutionId	Guid	required	The institution holding the assets. It must hold every authority this type requires.
IdentificationPeriodEndDate	date	required	45 days from the relinquished-property transfer.
ExchangePeriodEndDate	date	required	180 days. Funds are locked until then.
QualifiedIntermediaryId	Guid	required	The QI may not be a disqualified person as to the taxpayer (Treas. Reg. § 1.1031(k)-1(k)).
InvestmentId	long	optional	Links the account to a sponsor investment.

Example

POST https://api.a8core.io/v1/accounts

"ProviderReferenceId": "acct-10293",
"ClientId": "8fa2c1e4-5b6d-4f3a-9c2e-7d1a2b3c4d5e",
"AccountTypeCode": "1031-exchange-escrow",
"InstitutionId": "b4c1e770-9d33-4a02-91ef-2c6a8b5d0f14",
"IdentificationPeriodEndDate": "2026-08-23",
"ExchangePeriodEndDate": "2027-01-05",
"QualifiedIntermediaryId": "5e8b0c17-2a94-4d6f-b331-7c04e9a2f158"

200 OK

"RequestId": 1736472901835,
"Status": 1,
"AccountId": "3c7b1f90-2a44-4e21-8d6c-9b0e5a1f7c22"

Errors

ErrorCode	Meaning
InstitutionNotAuthorizedForAccountType	The institution does not hold every authority this type requires.
ClientNotFound	No client matches the supplied ClientId.

Eligible assets

The row below is the account-type dimension only. What this account may actually hold is the intersection of the account-type rule, the asset-class rule, any instrument predicates, and the institution’s authority asset scope.

●Permitted◐Conditional○Not permitted

Account family	Stocks & ETFs	Mutual funds	Bonds & fixed income	Cash & money market	Real estate	Private equity & venture	Private credit & notes	Precious metals	Digital assets	Stablecoins
1031 exchange escrow	Not permitted	Not permitted	Not permitted	Permitted	Conditional	Not permitted	Not permitted	Not permitted	Not permitted	Not permitted

Real property only, § 1031(a)(1). Funds locked, § 1.1031(k)-1(g)(6)

Rules that govern this type

Post-TCJA, § 1031 applies to real property only.
Funds are locked for the exchange period. If the taxpayer can direct them, the safe harbor fails and the exchange is taxable (Treas. Reg. § 1.1031(k)-1(g)(6)).
A8 Core™ custodies the exchange funds. Whether the institution is the qualified intermediary, or merely holds funds for one, is a distinct regulatory position. Settle it before enablement.