> ## Documentation Index > Fetch the complete documentation index at: https://docs.metal.ai/llms.txt > Use this file to discover all available pages before exploring further. # List activities for a person > Returns activities linked to a person, newest first. An activity is included when the person is a participant or a related resource. Results are scoped to your organization and limited to activities your API key can access. Exchange calendar bookkeeping (invites, attendee responses, and cancellations) is excluded. When the person has no matching activities, `data` is `null`. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/people/{id}/activities openapi: 3.1.0 info: title: Metal API version: 1.0.0 description: >- REST API for Metal, the AI context layer for financial firms. Manage companies, deals, people, documents, activities, enrichments, scores, screenings, lists, workflows, and more. All endpoints are versioned under /v1, return JSON, and are scoped to the organization that owns your API key. contact: name: Metal Support email: support@metal.ai url: https://www.metal.ai servers: - url: https://api.metal.ai description: Production security: - MetalClientId: [] MetalApiKey: [] tags: - name: API keys description: Check which API key a request is using. - name: Companies description: Manage and enrich companies. - name: Deals description: Track opportunities through your pipeline. - name: People description: Manage contacts and relationships. - name: Documents description: Search and retrieve ingested documents. - name: Activities description: Log and search meetings, calls, and other interactions. - name: Enrichments description: Read and write enriched property values on resources. - name: Scores description: Score companies and deals against scoring frameworks. - name: Screenings description: Run and manage AI-powered company screenings. - name: Lists description: Organize and enrich resources in bulk. - name: Tags description: Label companies, deals, and lists. - name: Industries description: Manage your organization's industry taxonomy. - name: Sectors description: Manage sectors within an industry. - name: Subsectors description: Manage subsectors within a sector. - name: Workflows description: Run and monitor AI workflows. - name: Data description: Query time-series metrics and observations. - name: Teams description: Manage deal teams and their members. - name: Workspaces description: Organize documents and data by workspace. - name: Inference description: Run single LLM completions scoped to your organization. paths: /v1/people/{id}/activities: get: tags: - Activities summary: List activities for a person description: >- Returns activities linked to a person, newest first. An activity is included when the person is a participant or a related resource. Results are scoped to your organization and limited to activities your API key can access. Exchange calendar bookkeeping (invites, attendee responses, and cancellations) is excluded. When the person has no matching activities, `data` is `null`. operationId: listPersonActivities parameters: - $ref: '#/components/parameters/PersonId' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/ActivityFeedLimit' - name: startedBefore in: query required: false description: >- Only return activities that started before this RFC3339 timestamp, for example `2026-10-01T00:00:00Z`. Pass the current time to keep future-dated meetings out of a most-recent view. schema: type: string format: date-time responses: '200': description: Activities for the person. content: application/json: schema: type: object properties: data: type: - array - 'null' description: >- Activities linked to the person, or `null` when there are none. items: $ref: '#/components/schemas/Activity' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' components: parameters: PersonId: name: id in: path required: true description: The person id. schema: type: string Page: name: page in: query description: Page number, starting at 1 (max 100). required: false schema: type: integer default: 1 minimum: 1 maximum: 100 ActivityFeedLimit: name: limit in: query description: Items per page (1 to 100). required: false schema: type: integer default: 100 minimum: 1 maximum: 100 schemas: Activity: type: object properties: id: type: string subject: type: string example: Intro call with management type: type: string example: Meeting startedAt: type: string format: date-time endedAt: type: string format: date-time participants: type: array items: $ref: '#/components/schemas/Reference' deals: type: array items: type: string relatedResources: type: array items: $ref: '#/components/schemas/Reference' externalReference: $ref: '#/components/schemas/ExternalReference' isPrivate: type: boolean createdAt: type: string format: date-time updatedAt: type: string format: date-time Reference: type: object description: A reference to another resource, such as a user or team. properties: id: type: string type: type: string description: The referenced resource type, e.g. "user" or "team". ExternalReference: type: object description: A structured reference to a record in an external source system. properties: source: type: string description: The external system, e.g. a CRM provider. id: type: string description: The record id in the external system. Error: type: object properties: error: type: string description: A human-readable error message. responses: BadRequest: description: The request body or parameters are invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid request body Unauthorized: description: Missing or invalid API key credentials. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: invalid api key or clientId securitySchemes: MetalClientId: type: apiKey in: header name: x-metal-client-id description: The Client ID of your API key. x-default: MetalApiKey: type: apiKey in: header name: x-metal-api-key description: The secret value of your API key. x-default: ```` ## Related topics - [Changelog](https://docs.metal.ai/help/changelog.md) - [Working with people](https://docs.metal.ai/help/people.md) - [List activities](https://docs.metal.ai/api-reference/activity/list-activities.md) - [List activities for a company](https://docs.metal.ai/api-reference/activities/list-activities-for-a-company.md) - [Update an activity](https://docs.metal.ai/api-reference/activity/update-an-activity.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.