> ## Documentation Index > Fetch the complete documentation index at: https://info.bundle.social/llms.txt > Use this file to discover all available pages before exploring further. # Get conversations > List conversations for a team, newest activity first. Filter by `socialAccountId`, `platform` and `status`. Paginate with `offset` (`limit` max 500, default 10) or by passing the previous response's `nextCursor` back as `cursor`; the two cannot be combined. `total` is returned on the first page only. ## OpenAPI ````yaml https://api.bundle.social/swagger-json get /api/v1/conversations/ openapi: 3.0.2 info: title: bundle.social API description: >- REST API for social media management. Perfect for AI assistants, GPTs, automation tools, and integrations. Post to 14+ platforms including Twitter, Instagram, Facebook, LinkedIn, TikTok, Pinterest, Reddit, Discord, Slack, YouTube, Mastodon, Bluesky, Threads, and Google Business. Schedule posts, manage content, analyze performance, and automate your social media workflow across all platforms. version: 1.0.0 contact: email: contact@bundle.social termsOfService: https://bundle.social/terms servers: - url: https://api.bundle.social - url: http://localhost:3001 security: - ApiKeyAuth: [] tags: - name: app - name: organization - name: team - name: socialAccount - name: upload - name: post - name: postImport - name: analytics - name: comment - name: conversation description: >- Read and reply to Instagram and Facebook direct message conversations, react to messages, and send private replies to comments. - name: automation description: >- Build, publish and monitor automation flows that react to incoming messages and comments, plus the per-account provider settings they rely on. - name: misc - name: postCSV paths: /api/v1/conversations/: get: tags: - conversation summary: Get conversations description: >- List conversations for a team, newest activity first. Filter by `socialAccountId`, `platform` and `status`. Paginate with `offset` (`limit` max 500, default 10) or by passing the previous response's `nextCursor` back as `cursor`; the two cannot be combined. `total` is returned on the first page only. operationId: conversation.getList parameters: - name: teamId in: query required: true schema: type: string - name: platform in: query schema: type: string enum: - INSTAGRAM - FACEBOOK - name: socialAccountId in: query schema: type: string - name: status in: query schema: type: string enum: - OPEN - ARCHIVED - name: offset in: query schema: default: 0 type: integer minimum: 0 nullable: true - name: limit in: query schema: default: 10 type: integer minimum: 1 maximum: 500 nullable: true - name: cursor in: query schema: type: string nullable: true responses: '200': description: '200' content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string teamId: type: string socialAccountId: type: string platform: type: string enum: - INSTAGRAM - FACEBOOK description: >- Messaging platform. Extensible: new platforms are added over time, so handle unknown values gracefully rather than switching exhaustively. externalConversationId: type: string nullable: true externalParticipantId: type: string participantUsername: type: string nullable: true participantDisplayName: type: string nullable: true participantAvatarUrl: type: string nullable: true status: type: string enum: - OPEN - ARCHIVED lastMessageAt: type: string format: date-time nullable: true lastActivityAt: type: string format: date-time nullable: true lastMessagePreview: type: string nullable: true lastReadAt: type: string format: date-time nullable: true unreadCount: type: number platformSeenAt: type: string format: date-time nullable: true createdAt: type: string format: date-time nullable: true updatedAt: type: string format: date-time nullable: true platformData: default: {} type: object properties: canReply: type: boolean nullable: true lastInboundAt: type: string format: date-time nullable: true providerStateSync: type: object properties: action: type: string enum: - ARCHIVE - OPEN status: type: string enum: - SYNCED - SYNC_FAILED - UNSUPPORTED reason: type: string nullable: true error: type: string nullable: true syncedAt: type: string format: date-time nullable: true required: - action - status nullable: true socialAccount: type: object properties: id: type: string type: type: string enum: - TIKTOK - YOUTUBE - INSTAGRAM - FACEBOOK - TWITTER - THREADS - LINKEDIN - PINTEREST - REDDIT - MASTODON - DISCORD - SLACK - BLUESKY - GOOGLE_BUSINESS - SNAPCHAT teamId: type: string username: type: string nullable: true displayName: type: string nullable: true bio: type: string nullable: true avatarUrl: type: string nullable: true externalId: type: string nullable: true providerPageId: type: string nullable: true userUsername: type: string nullable: true userDisplayName: type: string nullable: true userEmail: type: string nullable: true userId: type: string nullable: true channels: type: array items: type: object properties: id: type: string name: type: string nullable: true username: type: string nullable: true address: type: string nullable: true avatarUrl: type: string nullable: true webhook: type: object properties: id: type: string nullable: true name: type: string nullable: true avatar: type: string nullable: true url: type: string nullable: true nullable: true metadata: type: object properties: allowImages: type: boolean nullable: true allowVideos: type: boolean nullable: true allowGalleries: type: boolean nullable: true linkFlairEnabled: type: boolean nullable: true facebookPageId: type: string nullable: true nullable: true required: - id nullable: true mastodonServerId: type: string nullable: true instagramConnectionMethod: type: string enum: - FACEBOOK - INSTAGRAM nullable: true twitterSubType: type: string enum: - none - basic - premium - premium_plus nullable: true isTiktokBusinessAccount: type: boolean nullable: true disconnectedCheckTryAt: type: string format: date-time nullable: true deleteOn: type: string format: date-time nullable: true messagingStatus: default: DISABLED type: string enum: - DISABLED - ENABLED - DISABLE_PENDING messagingStatusUpdatedAt: type: string format: date-time nullable: true messagingLastError: type: string nullable: true createdAt: type: string format: date-time nullable: true updatedAt: type: string format: date-time nullable: true deletedAt: type: string format: date-time nullable: true required: - id - type - teamId - createdAt - updatedAt required: - id - teamId - socialAccountId - platform - externalParticipantId - status - lastActivityAt - unreadCount - createdAt - updatedAt total: type: number nextCursor: type: string nullable: true required: - items '400': description: '400' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string issues: type: array items: type: object properties: code: type: string enum: - invalid_type - invalid_literal - custom - invalid_union - invalid_union_discriminator - invalid_enum_value - unrecognized_keys - invalid_arguments - invalid_return_type - invalid_date - invalid_string - too_small - too_big - invalid_intersection_types - not_multiple_of - not_finite nullable: true message: type: string path: type: array items: oneOf: - type: string - type: number nullable: true required: - message nullable: true required: - message '401': description: '401' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '403': description: '403' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '404': description: '404' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '429': description: '429' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '500': description: '500' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '502': description: '502' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message components: securitySchemes: ApiKeyAuth: type: apiKey name: x-api-key in: header ````