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

# Get Activity Information List By Dates And Associate

> Get activity information for one or more days according to the given date interval.

The time portion of the dates is ignored. Private appointments are counted, but may not be visible through tooltips or other more detailed services.
NsApiSlow threshold: 2000 ms.



## OpenAPI

````yaml /openapi/agent/openapi-v3-AppointmentAgent.json post /api/v1/Agents/Appointment/GetActivityInformationListByDatesAndAssociate
openapi: 3.0.0
info:
  version: v1-Agents
  title: SuperOffice Agent API v1
  description: SuperOffice Agent API - AppointmentAgent
  contact:
    name: SuperOffice DevNet
    url: https://docs.superoffice.com/en/api/index.html
    email: sdk@superoffice.com
servers:
  - url: http://localhost:56350
  - url: https://localhost:56350
security: []
tags: []
externalDocs:
  description: >-
    The SuperOffice DevNet Community has more documentation, examples, and
    discussion forums.
  url: https://community.superoffice.com/en/developer/
paths:
  /api/v1/Agents/Appointment/GetActivityInformationListByDatesAndAssociate:
    post:
      tags:
        - Appointment_Agent
      summary: Get Activity Information List By Dates And Associate
      description: "Get activity information for one or more days according to the given date interval.\n\nThe time portion of the dates is ignored. Private appointments are counted, but may not be visible through tooltips or other more detailed services.\r\nNsApiSlow threshold: 2000 ms."
      operationId: v1AppointmentAgent_GetActivityInformationListByDatesAndAssociate
      parameters:
        - name: $select
          in: query
          description: >-
            Optional comma separated list of properties to include in the
            result. Other fields are then nulled out to reduce payload size:
            "Name,department,category". Default = show all fields.
          required: false
          schema:
            type: string
        - name: Accept-Language
          in: header
          description: >-
            Convert string references and multi-language values into a specified
            language (iso2) code.
          required: false
          schema:
            type: string
        - name: SO-Language
          in: header
          description: >-
            Convert string references and multi-language values into a specified
            language (iso2) code. Overrides Accept-Language value.
          required: false
          schema:
            type: string
        - name: SO-Culture
          in: header
          description: >-
            Number, date formatting in a specified culture (iso2 language) code.
            Partially overrides SO-Language/Accept-Language value. Ignored if no
            Language set.
          required: false
          schema:
            type: string
        - name: SO-TimeZone
          in: header
          description: >-
            Specify the timezone code that you would like date/time responses
            converted to.
          required: false
          schema:
            type: string
        - name: SO-AppToken
          in: header
          description: >-
            The application token that identifies the partner app. Used when
            calling Online WebAPI from a server.
          required: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          text/json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          application/xml:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          text/xml:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          application/x-www-form-urlencoded:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          application/json-patch+json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
          application/merge-patch+json:
            schema:
              $ref: >-
                #/components/schemas/SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest
        description: StartDate, EndDate, AssociateId
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
            text/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
            application/xml:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
            text/xml:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
            application/json-patch+json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
            application/merge-patch+json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/SuperOffice.CRM.Services.ActivityInformationListItem
      security:
        - SuperOffice_Password: []
          SuperId_Authentication: []
components:
  schemas:
    SuperOffice.WebApi.v1.Carriers.AppointmentCarriers.GetActivityInformationListByDatesAndAssociateRequest:
      description: >-
        GetActivityInformationListByDatesAndAssociate: Get activity information
        for one or more days according to the given date interval. The time
        portion of the dates is ignored. Private appointments are counted, but
        may not be visible through tooltips or other more detailed services.
      type: object
      properties:
        StartDate:
          format: date-time
          type: string
        EndDate:
          format: date-time
          type: string
        AssociateId:
          format: int32
          type: integer
    SuperOffice.CRM.Services.ActivityInformationListItem:
      description: "Carrier object for ActivityInformationListItem.\r\nServices for the ActivityInformationListItem Carrier is available from the <see cref=\"T:SuperOffice.CRM.Services.IAppointmentAgent\">Appointment Agent</see>."
      type: object
      properties:
        Date:
          format: date-time
          description: >-
            Date that this item is valid for; there is exactly one item per
            date, ordered by date.
          type: string
        ActivityInformation:
          $ref: '#/components/schemas/SuperOffice.CRM.Services.ActivitySummary'
        TableRight:
          $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight'
        FieldProperties:
          description: >-
            Field property dictionary mapping field names to field access
            rights.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty'
    SuperOffice.CRM.Services.ActivitySummary:
      description: "Activity information summary - number of free and busy activities.\r\n<para />\r\nCarrier object for ActivitySummary.\r\nServices for the ActivitySummary Carrier is available from the <see cref=\"T:SuperOffice.CRM.Services.IAppointmentAgent\">Appointment Agent</see>."
      type: object
      properties:
        NumBusyActivities:
          format: int32
          description: >-
            Number of activites and tasks in the diary that are of type 'busy'.
            Sales and documents are not activites in this case, only diary
            appointments and tasks.
          type: integer
        NumFreeActivities:
          format: int32
          description: >-
            Number of activites of the type 'free'. Sales and documents are not
            activites in this case, only diary appointments and tasks.
          type: integer
        PercentageBusy:
          format: int32
          description: How much of the active work-day which is booked in appointments.
          type: integer
        TableRight:
          $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight'
        FieldProperties:
          description: >-
            Field property dictionary mapping field names to field access
            rights.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty'
    SuperOffice.CRM.Security.TableRight:
      description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted."
      type: object
      properties:
        Mask:
          type: string
        Reason:
          type: string
    SuperOffice.CRM.Security.FieldProperty:
      description: >-
        Class holding properties like field length, field type about a field in
        the carrier.
      type: object
      properties:
        FieldRight:
          $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight'
        FieldType:
          type: string
        FieldLength:
          format: int32
          description: ''
          type: integer
    SuperOffice.CRM.Security.FieldRight:
      description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined."
      type: object
      properties:
        Mask:
          type: string
        Reason:
          type: string

````

## Related topics

- [SuperOffice.WebApi.Data.Appointment GetActivityInformationListByDatesAndAssociateRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.Appointment_GetActivityInformationListByDatesAndAssociateRequest.md)
- [NSAppointmentAgent](/en/automation/crmscript/reference/CRMScript.NetServer.NSAppointmentAgent.md)
- [SuperOffice.WebApi.Agents.AppointmentAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.AppointmentAgent.md)
- [SuperOffice.WebApi.Agents.IAppointmentAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.IAppointmentAgent.md)
- [Get Day Information List By Dates And Associate](/en/api/reference/restful/agent/appointment_agent/get-day-information-list-by-dates-and-associate.md)
- [Get Red Letter Information List By Dates And Associate](/en/api/reference/restful/agent/appointment_agent/get-red-letter-information-list-by-dates-and-associate.md)
