> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Portfolio

> Retrieve a portfolio and its embedded trademark membership list

<Snippet file="portfolios/access.mdx" />

See [portfolio limits and references](/guides/portfolios) 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.