> ## 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 DM and automation run usage per social account (paginated) > See how many direct messages and automation runs each Facebook, Instagram and TikTok account has used this UTC calendar month against its monthly limits, paginated with `offset`/`limit` and filterable by team, platform or account. Messages counted: every message you sent, including private replies to comments. Not counted: reactions, marking a conversation as read, and inbound messages. Automation runs counted: every run that was allowed to start, including manual test runs; skipped and canceled runs are not counted. Limits reflect per-account and organization overrides on top of the plan default. ## OpenAPI ````yaml https://api.bundle.social/swagger-json get /api/v1/organization/usage/messages 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/organization/usage/messages: get: tags: - organization summary: Get DM and automation run usage per social account (paginated) description: >- See how many direct messages and automation runs each Facebook, Instagram and TikTok account has used this UTC calendar month against its monthly limits, paginated with `offset`/`limit` and filterable by team, platform or account. Messages counted: every message you sent, including private replies to comments. Not counted: reactions, marking a conversation as read, and inbound messages. Automation runs counted: every run that was allowed to start, including manual test runs; skipped and canceled runs are not counted. Limits reflect per-account and organization overrides on top of the plan default. operationId: organization.getMessagesUsage parameters: - 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: 100 nullable: true - name: teamId in: query schema: type: string - name: socialAccountType in: query schema: type: string enum: - INSTAGRAM - FACEBOOK - TIKTOK - name: socialAccountId in: query schema: type: string responses: '200': description: '200' content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string type: type: string enum: - INSTAGRAM - FACEBOOK - TIKTOK username: type: string nullable: true displayName: type: string nullable: true messagesUsed: type: number messagesLimit: type: number automationRunsUsed: type: number automationRunsLimit: type: number required: - id - type - username - displayName - messagesUsed - messagesLimit - automationRunsUsed - automationRunsLimit total: type: number required: - items - total '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 '503': description: '503' content: application/json: schema: type: object properties: statusCode: type: number nullable: true message: type: string required: - message '504': description: '504' 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.