> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Paginated Activities

> Get paginated timeline activities for a patient.

Returns enriched activities with metadata, ordered newest first.
Supports filtering by date range, activity types, and search text.
Defaults to 90 days past through 90 days future if no date range specified.



## OpenAPI

````yaml get /user/patient/{patient_id}/timeline/activities
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /user/patient/{patient_id}/timeline/activities:
    get:
      tags:
        - Patients
      summary: Get Paginated Activities
      description: >-
        Get paginated timeline activities for a patient.


        Returns enriched activities with metadata, ordered newest first.

        Supports filtering by date range, activity types, and search text.

        Defaults to 90 days past through 90 days future if no date range
        specified.
      operationId: >-
        get_paginated_activities_user_patient__patient_id__timeline_activities_get
      parameters:
        - name: TENANT
          in: header
          required: true
          schema:
            type: string
            title: Tenant
          description: The tenant you are making this request on behalf of
        - name: API-KEY
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
          description: Your api key
        - name: patient_id
          in: path
          required: true
          schema:
            type: string
            title: Patient Id
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Page number (1-indexed)
            default: 1
            title: Page
          description: Page number (1-indexed)
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Items per page
            default: 25
            title: Per Page
          description: Items per page
        - name: start_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: Start date filter
            title: Start Date
          description: Start date filter
        - name: end_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: End date filter
            title: End Date
          description: End date filter
        - name: activity_type
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: Filter by activity types
            title: Activity Type
          description: Filter by activity types
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Search filter on activity title
            title: Search
          description: Search filter on activity title
        - name: timezone
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Timezone (defaults to tenant timezone)
            title: Timezone
          description: Timezone (defaults to tenant timezone)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTimelineResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PaginatedTimelineResponse:
      properties:
        page:
          type: integer
          title: Page
          description: Current page number (1-indexed)
        perPage:
          type: integer
          title: Perpage
          description: Number of items per page
        total:
          type: integer
          title: Total
          description: Total number of matching activities
        activities:
          items:
            $ref: '#/components/schemas/ActivityItem'
          type: array
          title: Activities
          description: Activities for the current page (newest first)
      type: object
      required:
        - page
        - perPage
        - total
        - activities
      title: PaginatedTimelineResponse
      description: Paginated response for the timeline activities endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ActivityItem:
      properties:
        activityType:
          type: string
          enum:
            - appointment
            - charge
            - payment
            - note
            - dose
            - form
            - document
            - memo
          title: Activitytype
          description: Type of activity for display/filtering
        activityId:
          type: string
          title: Activityid
          description: The entity ID (evt_xxx, chg_xxx, pay_xxx, etc.)
        createdDate:
          type: string
          format: date-time
          title: Createddate
          description: UTC timestamp when activity was created
        title:
          type: string
          title: Title
          description: Human-readable title for the activity
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
          description: Type-specific additional data (amount, provider, status, etc.)
      type: object
      required:
        - activityType
        - activityId
        - createdDate
        - title
      title: ActivityItem
      description: |-
        Single activity in timeline detail view.

        Represents one row in the chronological activity list for a given day.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````