> ## Documentation Index > Fetch the complete documentation index at: https://developers.fmgsuite.com/llms.txt > Use this file to discover all available pages before exploring further. # List a contact's email activity > Requires the fmg.emails.read scope. One page of a contact's email engagement history: scheduled, sent, open, click, bounce, and unsubscribe events. Each event carries its campaignIdentifier. Click events include the clicked url, which FMG truncates near 600 characters. FMG also reports spam complaints as unsubscribe events. `page` starts at 1 and defaults to 1. The date range applies first, then paging, so a long range needs several pages. There is no total count: a page with fewer than pageSize items is the last page. ## OpenAPI ````yaml /fmg/spec/openapi-merged.yaml get /fmg/communication/contacts/{contactId}/email-activity openapi: 3.1.0 info: title: FMG Connect API version: 1.0.0 description: | Partner-facing API for FMG Connect. Authenticate with OAuth 2.1 (see the **OAuth Integration Guide**), then call these endpoints with a Bearer access token. Endpoints annotated by Product carry a **Business context** section and an `x-business-context` field. servers: - url: https://connect.fmgsuite.com/v1 description: Current environment security: [] tags: - name: fmg contact - name: fmg content - name: fmg communication paths: /fmg/communication/contacts/{contactId}/email-activity: get: tags: - fmg communication summary: List a contact's email activity description: >- Requires the fmg.emails.read scope. One page of a contact's email engagement history: scheduled, sent, open, click, bounce, and unsubscribe events. Each event carries its campaignIdentifier. Click events include the clicked url, which FMG truncates near 600 characters. FMG also reports spam complaints as unsubscribe events. `page` starts at 1 and defaults to 1. The date range applies first, then paging, so a long range needs several pages. There is no total count: a page with fewer than pageSize items is the last page. parameters: - schema: type: integer exclusiveMinimum: 0 required: true name: contactId in: path - schema: type: integer minimum: 1 default: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 100 default: 25 required: false name: pageSize in: query - schema: type: string format: date-time required: false name: startDate in: query - schema: type: string format: date-time required: false name: endDate in: query - schema: type: string enum: - asc - desc default: desc required: false name: sortDirection in: query responses: '200': description: Paginated email activity. content: application/json: schema: $ref: '#/components/schemas/EmailActivityList' '400': description: 'invalid request or version mismatch. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: 'unauthorized. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: 'forbidden. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '404': description: 'not found. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '413': description: 'payload too large. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '415': description: 'unsupported media type. Retryable: false.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: 'rate limited. Retryable: true.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '500': description: 'internal error. Retryable: true.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '502': description: 'downstream unavailable. Retryable: true.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '504': description: 'downstream timeout. Retryable: true.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - StytchBearer: - fmg.emails.read ApiKey: [] components: schemas: EmailActivityList: type: object properties: data: type: array items: $ref: '#/components/schemas/EmailActivity' pageInfo: $ref: '#/components/schemas/EmailActivityPageInfo' required: - data - pageInfo additionalProperties: false Problem: type: object properties: type: type: string format: uri title: type: string status: type: integer detail: type: string instance: type: string code: type: string enum: - invalid_request - unauthorized - forbidden - not_found - conflict - version_mismatch - rate_limited - payload_too_large - unsupported_media_type - downstream_timeout - downstream_unavailable - internal_error description: >- invalid_request: HTTP 400, retryable=false; unauthorized: HTTP 401, retryable=false; forbidden: HTTP 403, retryable=false; not_found: HTTP 404, retryable=false; conflict: HTTP 409, retryable=false; version_mismatch: HTTP 400, retryable=false; rate_limited: HTTP 429, retryable=true; payload_too_large: HTTP 413, retryable=false; unsupported_media_type: HTTP 415, retryable=false; downstream_timeout: HTTP 504, retryable=true; downstream_unavailable: HTTP 502, retryable=true; internal_error: HTTP 500, retryable=true traceId: type: string retryable: type: boolean details: {} required: - type - title - status - detail - instance - code - traceId - retryable EmailActivity: type: object properties: type: type: string minLength: 1 occurredAt: type: - string - 'null' minLength: 1 subject: type: - string - 'null' campaignIdentifier: type: - string - 'null' assetIdentifier: type: - string - 'null' url: type: - string - 'null' required: - type - occurredAt - subject - campaignIdentifier - assetIdentifier - url additionalProperties: false EmailActivityPageInfo: type: object properties: page: type: integer minimum: 1 pageSize: type: integer minimum: 1 maximum: 100 sortDirection: type: string enum: - asc - desc required: - page - pageSize - sortDirection additionalProperties: false securitySchemes: StytchBearer: type: oauth2 description: OAuth 2.1 access tokens issued by Stytch Connected Apps. flows: authorizationCode: authorizationUrl: https://api.stytch.com/v1/public/oauth2/authorize tokenUrl: https://api.stytch.com/v1/public/oauth2/token scopes: fmg.contacts.read: Read FMG Suite contacts and contact groups. fmg.contacts.write: Create, update, and delete FMG Suite contacts and groups. fmg.content.read: Read FMG content library items. fmg.emails.read: Read FMG Suite email engagement history for contacts. mrc.messaging.read: >- Read MyRepChat messaging status: consent status now, message status later (MRC-5613). mrc.messaging.write: Send and schedule MyRepChat text messages. clientCredentials: tokenUrl: https://api.stytch.com/v1/public/oauth2/token scopes: fmg.contacts.read: Read FMG Suite contacts and contact groups. fmg.contacts.write: Create, update, and delete FMG Suite contacts and groups. fmg.content.read: Read FMG content library items. fmg.emails.read: Read FMG Suite email engagement history for contacts. mrc.messaging.read: >- Read MyRepChat messaging status: consent status now, message status later (MRC-5613). mrc.messaging.write: Send and schedule MyRepChat text messages. ApiKey: type: apiKey in: header name: x-api-key description: >- API usage-plan key. Required on every request, sent as the `x-api-key` header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.