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

# Get one activity

> Returns one activity with the AI's summary of it (one-liner, key takeaways, recap, outcomes, issues and the rest), why its sentiment is what it is, which of those fields a person changed in the app, and the facts of its kind: `ticket` (case number, status, priority, when it was opened and last changed), `survey` (a response's score: kind, rating, scale, NPS category), `campaign` (the campaign a campaign send came from), `pushed` (what the system that pushed it said: its name, the channel, direction, sender and outcome). Each is null where it doesn't apply. What was written in it is GET /v1/activities/{activity_id}/content. An activity is anything on an account's timeline in the app: an email thread, a meeting (from any recorder), a Slack or Teams thread, a support ticket, a survey response, a Salesforce Chatter thread, a note logged in the app, a campaign's send, a LinkedIn conversation, a marketing event, or one another system pushed. `accounts` are the accounts whose timeline shows it; `participants` the people linked to it, each with their `type`. `sentiment` and `one_liner` are the AI's, or a person's where they changed it in the app. `meeting_id` is set on a meeting Statisfy's notetaker recorded.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/activities/{activity_id}
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/activities/{activity_id}:
    get:
      tags:
        - activities
      summary: Get one activity
      description: >-
        Returns one activity with the AI's summary of it (one-liner, key
        takeaways, recap, outcomes, issues and the rest), why its sentiment is
        what it is, which of those fields a person changed in the app, and the
        facts of its kind: `ticket` (case number, status, priority, when it was
        opened and last changed), `survey` (a response's score: kind, rating,
        scale, NPS category), `campaign` (the campaign a campaign send came
        from), `pushed` (what the system that pushed it said: its name, the
        channel, direction, sender and outcome). Each is null where it doesn't
        apply. What was written in it is GET
        /v1/activities/{activity_id}/content. An activity is anything on an
        account's timeline in the app: an email thread, a meeting (from any
        recorder), a Slack or Teams thread, a support ticket, a survey response,
        a Salesforce Chatter thread, a note logged in the app, a campaign's
        send, a LinkedIn conversation, a marketing event, or one another system
        pushed. `accounts` are the accounts whose timeline shows it;
        `participants` the people linked to it, each with their `type`.
        `sentiment` and `one_liner` are the AI's, or a person's where they
        changed it in the app. `meeting_id` is set on a meeting Statisfy's
        notetaker recorded.
      operationId: activities_get
      parameters:
        - description: The activity's id, from GET /v1/activities
          in: path
          name: activity_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityDetail'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    ActivityDetail:
      properties:
        accounts:
          description: The accounts whose timeline shows it
          items:
            type: string
          title: Accounts
          type: array
        campaign:
          anyOf:
            - $ref: '#/components/schemas/ActivityCampaign'
            - type: 'null'
          description: The campaign a campaign send came from; null on anything else
        date:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            When it happened, ISO 8601 UTC: a meeting's scheduled start, an
            email or chat thread's latest message (so a thread moves up as it
            grows). Null for one with no date, which the list leaves out
          title: Date
        edited:
          description: >-
            The AI fields a person changed in the app (sentiment, one_liner,
            key_takeaways, recap): their values here are the person's
          items:
            type: string
          title: Edited
          type: array
        id:
          title: Id
          type: string
        meeting_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Set on a meeting Statisfy's notetaker recorded: its id at GET
            /v1/meetings/{meeting_id}, which links to its transcript
          title: Meeting Id
        one_liner:
          anyOf:
            - type: string
            - type: 'null'
          description: The AI's one-line summary
          title: One Liner
        participants:
          items:
            $ref: '#/components/schemas/Participant'
          title: Participants
          type: array
        pushed:
          anyOf:
            - $ref: '#/components/schemas/ActivityPushed'
            - type: 'null'
          description: >-
            What the system that pushed it said: the system, channel, sender and
            outcome; null on anything Statisfy synced itself
        sentiment:
          anyOf:
            - enum:
                - negative
                - neutral
                - positive
              type: string
            - type: 'null'
          description: >-
            positive, neutral or negative, as the AI judged it or a person set
            it
          title: Sentiment
        sentiment_reason:
          anyOf:
            - type: string
            - type: 'null'
          description: Why the sentiment is what it is
          title: Sentiment Reason
        source:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The integration it came from, such as gmail, outlook_mail, zoom,
            gong, slack, zendesk, statisfy (a campaign's send), manual (logged
            in the app) or api (another system pushed it: `pushed.system` names
            it)
          title: Source
        summary:
          $ref: '#/components/schemas/ActivitySummary'
          description: The AI's summary; a field it found nothing for is empty
        survey:
          anyOf:
            - $ref: '#/components/schemas/ActivitySurveyScore'
            - type: 'null'
          description: >-
            A survey response's score; null on any other kind (a campaign's
            survey invitation included: see `campaign`)
        ticket:
          anyOf:
            - $ref: '#/components/schemas/ActivityTicket'
            - type: 'null'
          description: A ticket's facts; null on any other kind
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        type:
          anyOf:
            - enum:
                - email
                - meeting
                - slack
                - teams
                - ticket
                - survey
                - chatter
                - note
                - linkedin
                - marketing_event
              type: string
            - type: 'null'
          description: >-
            email, meeting, slack, teams, ticket (a support ticket), survey,
            chatter (Salesforce Chatter), note (logged in the app), linkedin (a
            LinkedIn conversation) or marketing_event (a form fill, web visit,
            webinar or event)
          title: Type
      required:
        - id
        - summary
      title: ActivityDetail
      type: object
    ActivityCampaign:
      properties:
        id:
          description: The campaign's id
          title: Id
          type: string
        kind:
          description: email, or survey for a survey invitation
          enum:
            - email
            - survey
          title: Kind
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        recipient_count:
          anyOf:
            - type: integer
            - type: 'null'
          description: How many of this account's people it went to
          title: Recipient Count
      required:
        - id
        - kind
      title: ActivityCampaign
      type: object
    Participant:
      description: A person on an activity, as every activity API gives them.
      properties:
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        id:
          description: The person's id
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        type:
          anyOf:
            - enum:
                - user
                - contact
                - vendor
                - digital_worker
              type: string
            - type: 'null'
          description: >-
            user (a teammate), contact, vendor or digital_worker; null when
            unknown
          title: Type
      required:
        - id
      title: Participant
      type: object
    ActivityPushed:
      properties:
        channel:
          enum:
            - email
            - linkedin
            - call
            - meeting
            - webinar
            - form
            - web_visit
            - event
            - other
          title: Channel
          type: string
        direction:
          anyOf:
            - enum:
                - inbound
                - outbound
              type: string
            - type: 'null'
          description: outbound (to the person) or inbound (from them)
          title: Direction
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Its id in that system
          title: External Id
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          description: The person's LinkedIn profile, as the sender gave it
          title: Linkedin Url
        outcome:
          $ref: '#/components/schemas/ActivityPushedOutcome'
        sent_by:
          anyOf:
            - type: string
            - type: 'null'
          description: The email of the teammate who sent it, when one did
          title: Sent By
        system:
          anyOf:
            - type: string
            - type: 'null'
          description: The system that pushed it, as it named itself (`source`)
          title: System
        url:
          anyOf:
            - type: string
            - type: 'null'
          description: A link to the touch in the system that sent it
          title: Url
      required:
        - channel
        - outcome
      title: ActivityPushed
      type: object
    ActivitySummary:
      properties:
        competitors:
          items:
            type: string
          title: Competitors
          type: array
        detailed_summary:
          items:
            type: string
          title: Detailed Summary
          type: array
        issues:
          items:
            type: string
          title: Issues
          type: array
        key_takeaways:
          items:
            type: string
          title: Key Takeaways
          type: array
        one_liner:
          anyOf:
            - type: string
            - type: 'null'
          title: One Liner
        outcomes:
          items:
            type: string
          title: Outcomes
          type: array
        product_adoption_usage:
          items:
            type: string
          title: Product Adoption Usage
          type: array
        recap:
          items:
            $ref: '#/components/schemas/ActivityRecap'
          title: Recap
          type: array
        relationships:
          items:
            type: string
          title: Relationships
          type: array
        renewal_status:
          items:
            type: string
          title: Renewal Status
          type: array
        stage:
          anyOf:
            - type: string
            - type: 'null'
          title: Stage
      title: ActivitySummary
      type: object
    ActivitySurveyScore:
      properties:
        category:
          anyOf:
            - enum:
                - promoter
                - passive
                - detractor
              type: string
            - type: 'null'
          description: 'An NPS response''s: promoter, passive or detractor'
          title: Category
        kind:
          anyOf:
            - enum:
                - nps
                - csat
                - other
              type: string
            - type: 'null'
          description: >-
            nps, csat, or other for any other kind; null when the survey tool
            named none
          title: Kind
        max_rating:
          anyOf:
            - type: integer
            - type: 'null'
          description: The top of the scale
          title: Max Rating
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: The survey's name
          title: Name
        rating:
          anyOf:
            - type: integer
            - type: 'null'
          description: The score the respondent gave
          title: Rating
      title: ActivitySurveyScore
      type: object
    ActivityTicket:
      properties:
        case_id:
          anyOf:
            - type: string
            - type: 'null'
          description: The ticket's number in the ticketing system
          title: Case Id
        opened_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Opened At
        priority:
          anyOf:
            - type: string
            - type: 'null'
          description: As the ticketing system names it
          title: Priority
        status:
          anyOf:
            - type: string
            - type: 'null'
          description: As the ticketing system names it, such as open or solved
          title: Status
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          description: 'ISO 8601 UTC: its last change in the ticketing system'
          title: Updated At
      title: ActivityTicket
      type: object
    ActivityPushedOutcome:
      properties:
        attended:
          anyOf:
            - type: boolean
            - type: 'null'
          description: 'A meeting''s, webinar''s or event''s: whether they came'
          title: Attended
        clicked_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Clicked At
        duration_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          description: A call's or meeting's length
          title: Duration Seconds
        opened_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Opened At
        replied_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Replied At
      title: ActivityPushedOutcome
      type: object
    ActivityRecap:
      properties:
        text:
          title: Text
          type: string
        topic:
          title: Topic
          type: string
      required:
        - topic
        - text
      title: ActivityRecap
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.