Unit Publications

`GET /portfolio/unit/{id}/publications`

Returns publications associated with one unit.

Parameters

Parameter	Type	Description
`id (path)`	string	Group ID; `0` resolves to the root unit. Descendant units are included.
`apikey`	string	Portfolio API key, if configured; alternatively use `X-API-Key`.
`limit`	integer	Maximum list rows. A positive value enables shared pagination.
`offset`	integer	List rows to skip with `limit`. Defaults to `0`; negative values become `0`.

Authentication, pagination, and error envelopes are described in Portfolio API Basics. Parameters such as json, filter, columns[], full, and aggregate are not supported unless listed here.

Example Request

1	`GET /portfolio/unit/BIO/publications?apikey=YOUR_PORTFOLIO_API_KEY`

Example Response

{
  "status": 200,
  "count": 1,
  "data": [
    {
      "_id": {
        "$oid": "665ef1234567890abcdef1234"
      },
      "html": "<a href=\"**PORTAL**/activity/665ef1234567890abcdef1234\">Example publication</a>",
      "print": "Example A. (2026) Example publication.",
      "search": "Example A. 2026 Example publication",
      "type": "publication",
      "subtype": "article",
      "year": 2026,
      "month": 3,
      "day": 1,
      "icon": "<i class=\"ph ph-file-text\"></i>"
    }
  ]
}

The example uses illustrative values. Optional stored or rendered fields may be omitted. Response count is the number of returned list rows before shared pagination.

Returned Fields

Field	Description
`_id`	Extended JSON ObjectID in context/infrastructure lists; not included in global lists.
`html`	Stored `rendered.portfolio` HTML, potentially containing `PORTAL` placeholders.
`print`	Stored rendered print citation HTML.
`search`	Stored rendered plain citation text.
`type, subtype`	Stored activity category/subtype codes, not translated display labels.
`year, month, day`	Stored date components, where present.
`icon`	Stored rendered icon, potentially HTML.

Response Behavior

Activities must belong to this unit or its descendants and have stored affiliated=true.

Requires stored type=publication. It does not restrict publications to Portfolio-enabled subtypes in this list. Hidden activities are excluded. Rows are sorted by year, month, then day descending. Unlike the global list, the projection retains _id and does not add string id or affiliated. The global affiliated query parameter is not read here.

When quality workflows are enabled, portfolio-workflow-visibility applies: all imposes no extra restriction; only-approved requires workflow.status=verified; approved-or-empty accepts verified records or records with no workflow/status. This is a configured restriction, not a request parameter.