> ## Documentation Index > Fetch the complete documentation index at: https://docs.morphic.io/llms.txt > Use this file to discover all available pages before exploring further. # List activities > Retrieve a paginated list of activities with optional filtering. ## OpenAPI ````yaml get /api/activities/ openapi: 3.1.0 info: title: CRM Backend description: > CRM Backend API for managing contacts, companies, deals, activities, and AI-powered chat. ## Authentication Protected endpoints accept either: - **JWT (Bearer)**: `Authorization: Bearer ` with `X-Account-ID` header - **API Key**: `Authorization: Bearer sk_xxx` or `X-API-Key: sk_xxx` API keys are created in Developer Settings and provide account-level access. version: 0.1.0 servers: - url: https://api.morphic.io description: Production security: [] tags: - name: Contacts description: Manage contacts (people) in the CRM. - name: Companies description: Manage companies and their teams. - name: Deals description: Manage deals and pipeline stages. - name: Activities description: Log and track activities (calls, meetings, tasks). - name: Notes description: Create and manage notes attached to CRM entities. - name: Favorites description: Bookmark records and organize them into folders. - name: Exports description: Export CRM data to CSV files. - name: Imports description: Import data into the CRM from CSV files. - name: Email Drafts description: Create, manage, and send email drafts. - name: Email Templates description: Create and manage reusable email templates. - name: Knowledge Base description: Manage knowledge base documents and pages. - name: Chats description: AI-powered chat conversations and messages. - name: Cortex Search description: Semantic search and AI-powered Q&A over CRM data. - name: Custom Fields description: Define and manage custom field definitions and values. - name: Categories description: Organize CRM entities with categories and tags. - name: Transcription description: Transcribe audio files using AI. paths: /api/activities/: get: tags: - Activities summary: List activities description: Retrieve a paginated list of activities with optional filtering. operationId: list-activities parameters: - name: categories in: query required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of category IDs title: Categories description: Comma-separated list of category IDs - name: custom_fields in: query required: false schema: anyOf: - type: string - type: 'null' description: JSON string of custom field filters title: Custom Fields description: JSON string of custom field filters - name: basic_filters in: query required: false schema: anyOf: - type: string - type: 'null' description: JSON string of basic filters title: Basic Filters description: JSON string of basic filters - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: page_size in: query required: false schema: type: integer maximum: 1000 minimum: 1 default: 100 title: Page Size - name: is_deleted in: query required: false schema: anyOf: - type: boolean - type: 'null' default: false title: Is Deleted - name: activity_type in: query required: false schema: anyOf: - type: string - type: 'null' title: Activity Type - name: status in: query required: false schema: anyOf: - type: string - type: 'null' title: Status - name: priority in: query required: false schema: anyOf: - type: string - type: 'null' title: Priority - name: user_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: User Id - name: contact_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Contact Id - name: company_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Company Id - name: deal_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Deal Id - name: created_by in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Created By - name: due_date_from in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Due Date From - name: due_date_to in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Due Date To - name: search in: query required: false schema: anyOf: - type: string - type: 'null' title: Search - name: exclude_completed in: query required: false schema: anyOf: - type: boolean - type: 'null' title: Exclude Completed - name: sort_by in: query required: false schema: anyOf: - type: string - type: 'null' title: Sort By - name: sort_order in: query required: false schema: anyOf: - type: string - type: 'null' title: Sort Order - name: x-account-id in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Account-Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_Activity_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKey: [] components: schemas: PaginatedResponse_Activity_: properties: items: items: $ref: '#/components/schemas/Activity' type: array title: Items total: type: integer title: Total page: type: integer title: Page page_size: type: integer title: Page Size pages: type: integer title: Pages type: object required: - items - total - page - page_size - pages title: PaginatedResponse[Activity] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Activity: properties: id: type: string format: uuid title: Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: type: string title: Type description: Activity type (email, meeting, call, note, task, stage_change, etc.) subject: anyOf: - type: string maxLength: 255 - type: 'null' title: Subject description: anyOf: - type: string - type: 'null' title: Description priority: anyOf: - type: string - type: 'null' title: Priority status: anyOf: - type: string - type: 'null' title: Status duration_minutes: anyOf: - type: integer minimum: 0 - type: 'null' title: Duration Minutes due_date: anyOf: - type: string format: date-time - type: 'null' title: Due Date completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At outcome: anyOf: - type: string - type: 'null' title: Outcome entity_type: anyOf: - type: string - type: 'null' title: Entity Type description: Primary entity type this activity is linked to entity_id: anyOf: - type: string format: uuid - type: 'null' title: Entity Id description: Primary entity ID this activity is linked to contact_id: anyOf: - type: string format: uuid - type: 'null' title: Contact Id company_id: anyOf: - type: string format: uuid - type: 'null' title: Company Id deal_id: anyOf: - type: string format: uuid - type: 'null' title: Deal Id metadata: type: object title: Metadata account_id: type: string format: uuid title: Account Id user_id: anyOf: - type: string format: uuid - type: 'null' title: User Id user_name: anyOf: - type: string - type: 'null' title: User Name description: User's name or email user_email: anyOf: - type: string - type: 'null' title: User Email description: User's email address type: object required: - id - created_at - updated_at - type - account_id title: Activity ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKey: type: apiKey in: header name: X-API-Key description: API key (sk_xxx) from Developer Settings. No X-Account-ID needed. ````