Zum Inhalt

Project Activities

GET /portfolio/project/{id}/activities

Returns activities associated with one project.

Parameters

Parameter Type Description
id (path) string MongoDB project ObjectID or exact stored project reference/name. ObjectIDs are converted to BSON before querying activity projects.
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/project/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

Activities must contain this exact project reference in projects and have stored affiliated=true. The route does not look up the project or fall back from its ObjectID to its name.

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.