---
title: Top1031 developer and agent access
description: Public catalog name search, versioning, errors, and discovery resources for Top1031.
canonical: https://www.top1031.com/developers/
last-updated: 2026-08-25
---

# Top1031 developer and agent access

Top1031 provides a small, read-only public API for finding Trust and Sponsor records by name. Access costs $0 and does not require an API key.

## Catalog name search

`GET https://www.top1031.com/api/catalog/search/?q=nexpoint` returns up to ten public Trust and Sponsor matches. When supplied, `q` must contain 2–80 characters. Omit `q` for a reachability check that returns an empty result set. Add `scope=active-offerings` to restrict results to Active Trusts.

Each result contains `href`, `id`, `kind`, `meta`, `slug`, and `title`. Follow `href` for the complete record, filing links, evidence, dates, disclosures, and gated-surface presentation. The search response does not contain Sponsor Grade fields.

## 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`.

Errors use a JSON `error` object with `code` and `message`, plus `parameter` for validation errors. The endpoint returns 400 for unsupported input or API versions and 503 when search is temporarily unavailable.

## Machine-readable resources

- [OpenAPI 3.1 description](https://www.top1031.com/openapi.json)
- [RFC 9727 API catalog](https://www.top1031.com/.well-known/api-catalog)
- [llms.txt](https://www.top1031.com/llms.txt)
- [llms-full.txt](https://www.top1031.com/llms-full.txt)
- [Sitemap index](https://www.top1031.com/sitemap.xml)
- [Access and pricing](https://www.top1031.com/pricing/)

The API is for name lookup, not bulk export. Use llms-full.txt or the sitemaps for complete catalog discovery. Top1031 is a media and data platform, not a broker-dealer, investment adviser, tax adviser, or law firm.