Skip to main content
GET
Retrieve Portfolio
See portfolio limits and references for current caps and external_ref semantics.

Overview

Returns the portfolio at the top level with an embedded trademarks collection. The embedded list includes membership fields added_at, added_by, and external_ref alongside each trademark summary. Use limit (default 20, maximum 100) and cursor to page through that collection. limit=0 skips the list when no reference filter is supplied.

External References

Use ?external_ref=ACME-2024-001 to look up your own membership reference. The comparison is case-sensitive after trimming and returns at most one membership; an unknown reference returns an empty embedded list, not a missing portfolio. The filter remains effective with limit=0. References are scoped to this portfolio, not to the trademark globally.

Errors

An unknown portfolio or one belonging to another organization returns 404.