Developer and agent access

Find a Top1031 record from code

A small public interface for finding records by name, plus complete machine-readable indexes for discovery.

Talk to a 1031 specialist

Catalog name search

GET /api/catalog/search/?q=nexpoint returns up to ten public Trust and Sponsor matches. Supplied queries must contain at least two characters and are limited to 80 characters. Omit q for a reachability check that returns an empty result set. Add scope=active-offerings to search Active Trusts only.

The response supplies a canonical page path, public display title, record kind, and a short catalog label. Follow the page path for filing links, evidence, dates, disclosures, and the complete record context.

Versioning and errors

The current API major version is 1. Omitting the version header selects version 1; clients can pin it with X-API-Version: 1. Version 1 changes are additive. If a major version is deprecated, Top1031 will announce it here and in the OpenAPI description at least 180 days before retirement. During that window, affected responses will include the HTTP Deprecation and Sunset headers; retirement will not occur before the date in Sunset.

Every response includes X-API-Version. Errors use a stable JSON error object with code and message fields, plus parameter for validation errors. The interface returns 400 for unsupported input or API versions and 503 when catalog search is temporarily unavailable.

Discovery and retrieval

The search endpoint is for name lookup, not bulk export. Use the machine-readable indexes to discover the complete public catalog and research library.

Use the evidence with the result

Top1031 is a media, data, and education platform. A catalog result is not advice, a recommendation, or confirmation that an Offering remains available. Preserve the source links, dates, evidence, Grade methodology link, and visible qualifications when presenting a record.

Questions about a public record or the interface can go to data@top1031.com. For dataset construction and publication boundaries, read what the data covers.