> ## Documentation Index > Fetch the complete documentation index at: https://docs.reachhunt.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get account limits > Returns the sending limits of one account, what it used, and how far its warm-up is. LinkedIn and X accounts return different fields. ## OpenAPI ````yaml /openapi.json get /accounts/{accountId}/limits openapi: 3.1.0 info: title: ReachHunt API version: 1.0.0 description: >- The ReachHunt API gives your own apps and scripts programmatic access to your workspace: accounts, campaigns, lead lists, conversations, messages, tags and statuses. Send your API key in the `Authorization` header: `Authorization: Bearer YOUR_API_KEY`. The key decides the workspace, so no path or parameter names one. Every response has the same envelope: `{ "status": true, "data": ..., "error": null }`. servers: - url: https://api.reachhunt.ai/api/v1 description: Production security: [] tags: - name: Workspaces description: Your workspace and the people in it. - name: Accounts description: The X and LinkedIn accounts you connected. - name: Analytics description: Activity over time. - name: Credits description: AI credits and how they were used. - name: Campaigns description: Outreach that messages your leads step by step. - name: Agents description: AI agents that reply to your leads. - name: Tags description: Labels you put on conversations. - name: Statuses description: Pipeline stages you put conversations in. - name: Leads description: The people in your lead lists. - name: Lead lists description: Lists of people you collect to message. - name: Conversations description: The conversations in your inbox. - name: Messages description: The messages in a conversation. - name: Conversation details description: Your team's record of the person in a conversation. - name: Internal notes description: Notes only your team sees. - name: Scheduled messages description: Messages set to send later. - name: Templates description: Saved messages you can reuse. - name: Webhook events description: What each event sends. paths: /accounts/{accountId}/limits: get: tags: - Accounts summary: Get account limits description: >- Returns the sending limits of one account, what it used, and how far its warm-up is. LinkedIn and X accounts return different fields. operationId: accounts.getLimits parameters: - name: accountId in: path required: true description: The account ID. schema: type: string responses: '200': description: 'OK. Check `status`: errors the API handles itself also return 200.' content: application/json: schema: type: object required: - status - data - error properties: status: type: boolean description: '`true` when the request succeeded.' data: oneOf: - $ref: '#/components/schemas/LinkedInLimits' - $ref: '#/components/schemas/XLimits' error: type: 'null' description: Always `null` on success. example: status: true data: accountId: 4f1c9a2e-6b7d-4c3a-9e51-0a8b7c6d5e4f handle: jane-doe platform: linkedin settings: weeklyConnectionRequests: 100 weeklyMessageRequests: 50 weeklyInmails: 30 weeklyDirectMessages: 300 warmup: true warmupSpeed: slow effective: connection_request: weekly: 80 dailyAllowance: 16 usedToday: 4 usedWeek: 31 remainingToday: 12 remainingWeek: 49 warmup: active: true speed: slow totalDays: 28 day: 6 progressPercent: 21 startedAt: '2026-10-12T09:00:00.000Z' throttle: null acceptance: invited: 120 accepted: 42 ratePercent: 35 limitPercent: 100 error: null '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PlanRequired' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: [] components: schemas: LinkedInLimits: type: object title: LinkedIn additionalProperties: true required: - accountId - handle - platform - settings - effective - warmup - throttle - acceptance properties: accountId: type: string examples: - 4f1c9a2e-6b7d-4c3a-9e51-0a8b7c6d5e4f handle: type: - string - 'null' examples: - jane-doe platform: type: string enum: - linkedin settings: type: object description: The weekly limits set for the account. additionalProperties: true properties: weeklyConnectionRequests: type: integer description: Connection requests per week. examples: - 100 weeklyMessageRequests: type: integer description: Message requests per week. examples: - 50 weeklyInmails: type: integer description: InMails per week. examples: - 30 weeklyDirectMessages: type: integer description: Messages to connections per week. examples: - 300 warmup: type: boolean description: Whether warm-up is on. warmupSpeed: type: string enum: - fast - medium - slow effective: type: object description: What is left for each kind of action, today and this week. properties: connection_request: $ref: '#/components/schemas/Budget' message_request: $ref: '#/components/schemas/Budget' inmail: $ref: '#/components/schemas/Budget' direct_message: $ref: '#/components/schemas/Budget' warmup: $ref: '#/components/schemas/Warmup' throttle: type: - object - 'null' description: >- Set when sending is paused to keep the account safe. `null` otherwise. properties: until: type: string format: date-time scope: type: - string - 'null' reason: type: - string - 'null' acceptance: type: object description: How many connection requests were accepted lately. properties: invited: type: integer description: Requests sent in the window. examples: - 120 accepted: type: integer description: Requests accepted in the window. examples: - 42 ratePercent: type: - integer - 'null' description: >- Acceptance rate from 0 to 100. `null` until there is enough data. examples: - 35 limitPercent: type: integer description: >- Share of the connection request limit in use because of the acceptance rate, from 0 to 100. examples: - 100 ranges: type: object additionalProperties: type: object properties: min: type: integer max: type: integer description: The lowest and highest value this setting accepts. description: The lowest and highest value each setting accepts. warmupDays: type: object description: How many days a warm-up takes at each speed. properties: fast: type: integer description: Days at `fast` speed. medium: type: integer description: Days at `medium` speed. slow: type: integer description: Days at `slow` speed. mode: type: string description: How limits are applied. defaults: type: object additionalProperties: true description: The workspace defaults for each weekly limit. pacing: type: object properties: nextAllowedAt: type: - string - 'null' format: date-time description: When the next action can go out. backlog: type: object description: Connection requests still waiting for an answer. properties: pending: type: integer description: Requests waiting. checkedAt: type: - string - 'null' format: date-time description: When the count was last checked. ceiling: type: integer description: The most that can wait before sending slows down. XLimits: type: object title: X additionalProperties: true required: - accountId - handle - platform - settings - warmup - pace - usedToday properties: accountId: type: string examples: - 4f1c9a2e-6b7d-4c3a-9e51-0a8b7c6d5e4f handle: type: - string - 'null' examples: - acmecorp platform: type: string enum: - x settings: type: object properties: dailyDmLimit: type: integer description: New people the account can message per day. examples: - 50 warmup: type: boolean description: Whether warm-up is on. warmupSpeed: type: string enum: - fast - medium - slow warmup: $ref: '#/components/schemas/Warmup' pace: type: object description: How many messages can go out per hour. properties: perHour: type: integer description: The hourly limit now. examples: - 4 startPerHour: type: integer description: The hourly limit the warm-up started from. examples: - 2 maxPerHour: type: integer description: The hourly limit at the end of the warm-up. examples: - 10 reachesMaxAt: type: - string - 'null' format: date-time description: When the hourly limit reaches its maximum. usedToday: type: integer description: New people messaged today. examples: - 12 ranges: type: object additionalProperties: type: object properties: min: type: integer max: type: integer description: The lowest and highest value this setting accepts. description: The lowest and highest value each setting accepts. warmupDays: type: object description: How many days a warm-up takes at each speed. properties: fast: type: integer description: Days at `fast` speed. medium: type: integer description: Days at `medium` speed. slow: type: integer description: Days at `slow` speed. Budget: type: object description: How much of one kind of action the account can still do. required: - weekly - dailyAllowance - usedToday - usedWeek - remainingToday - remainingWeek properties: weekly: type: integer description: The weekly limit in effect now, warm-up included. examples: - 80 dailyAllowance: type: integer description: How many can go out today. examples: - 16 usedToday: type: integer description: Used today. examples: - 4 usedWeek: type: integer description: Used in the last 7 days. examples: - 31 remainingToday: type: integer description: Left for today. examples: - 12 remainingWeek: type: integer description: Left for the week. examples: - 49 Warmup: type: object description: Warm-up raises the limits step by step on a new account. required: - active - speed - totalDays - day - progressPercent - startedAt properties: active: type: boolean description: Whether the account is warming up now. examples: - true speed: type: string enum: - fast - medium - slow description: How fast the limits rise. examples: - slow totalDays: type: integer description: How many days the warm-up takes. examples: - 28 day: type: integer description: The current day of the warm-up. examples: - 6 progressPercent: type: integer description: How far the warm-up is, from 0 to 100. examples: - 21 startedAt: type: - string - 'null' format: date-time description: When the warm-up started, in ISO 8601 UTC. examples: - '2026-10-12T09:00:00.000Z' Failure: type: object required: - status - data - error properties: status: type: boolean description: Always `false` for an error. data: type: 'null' description: Always `null` for an error. error: type: string description: What went wrong, in plain words. responses: Unauthorized: description: The API key is missing or not valid. content: application/json: schema: $ref: '#/components/schemas/Failure' example: status: false data: null error: Not authenticated PlanRequired: description: The workspace has no active plan, or its trial has ended. content: application/json: schema: $ref: '#/components/schemas/Failure' example: status: false data: null error: Your free trial has ended. Pick a plan to continue. ServerError: description: Something failed on our side. Try again. content: application/json: schema: $ref: '#/components/schemas/Failure' example: status: false data: null error: Something went wrong. Please try again. securitySchemes: bearerAuth: type: http scheme: Bearer description: >- Your API key, sent as `Authorization: Bearer YOUR_API_KEY`. Create one in **Settings → API**. x-default: Bearer YOUR_API_KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.