Skip to content

Person Activities

GET /portfolio/person/{id}/activities

Returns activities associated with one person.

Parameters

Parameter Type Description
id (path) string Person MongoDB ObjectID; usernames are not supported.
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/person/665ef1234567890abcdef1234/activities?apikey=YOUR_PORTFOLIO_API_KEY

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
{
  "status": 200,
  "count": 1,
  "data": [
    {
      "_id": {
        "$oid": "665ef1234567890abcdef1234"
      },
      "html": "Rendered lecture entry",
      "print": "Example A. (2026) Example publication.",
      "search": "Example A. 2026 Example publication",
      "type": "event",
      "subtype": "lecture",
      "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

The person ObjectID is resolved to a username; activities must list that username in rendered.users. No affiliation filter is added.

Includes only Portfolio-enabled non-publication subtypes. 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.

Errors

A missing person returns 404 DataNotFound with msg: "Person not found".