LINE Messaging API · error code

LINE error 429: You have reached your monthly limit.

Policy / accountHTTP 429403 / monthly quota: plan and permission limits

Last verified against LINE Developers - Messaging API reference (error responses)

What LINE returns
You have reached your monthly limit.

What error 429 means

Your LINE Official Account has run out of billable sends for the month. The error messages table gives two triggers: you "exceeded the number of free messages" included in your subscription plan, or you "exceeded your maximum number of additional messages allowed to be sent" - the paid cap you configure in LINE Official Account Manager. The pricing docs confirm the consequence: "when you exceed the limit of messages that can be sent in a month, an error response will be returned and the messages won't be sent."

This is where LINE's reply-versus-push economics bite. Only push, multicast, narrowcast, and broadcast count against the plan; reply messages are not counted at all. Counting is per recipient, not per API call - a push with four message objects to a chat of five people counts as five messages - and sends to users who blocked you or to dead user IDs aren't counted. Free allowances depend on the plan and vary by country or region; as a scale reference, LINE's documented Japan example is 200 free messages on the free Communication Plan, 5,000 on the Light Plan, and 30,000 on the Standard Plan, with additional paid messages available only on certain plans. Check your region's plan pages rather than assuming these numbers (details at monthly quota).

One documented subtlety can make this error appear while quota seemingly remains: narrowcast reserves messages up front based on your account's entire target reach, not the actual recipient count. While a narrowcast is delivering, "the number of remaining messages for the current month may be temporarily depleted," and a concurrent send fails with exactly this message. LINE's FAQ covers this case; the mitigation is the narrowcast limit objects (e.g. upToRemainingQuota) or simply not sending during large narrowcast deliveries.

You can see all of this programmatically: GET /v2/bot/message/quota returns your target limit (none or limited with a value), and GET /v2/bot/message/quota/consumption returns messages used this month.

What it looks like

HTTP/1.1 429 Too Many Requests

{
  "message": "You have reached your monthly limit."
}

Why it happens

  • Push/multicast/broadcast/narrowcast volume genuinely exceeded the plan's free message allowance for the month.
  • The additional-message cap set in LINE Official Account Manager was reached, so paid overflow also stopped.
  • A running narrowcast reserved quota equal to the account's full target reach, temporarily depleting the remaining balance for concurrent sends.
  • Flows that should be free replies were implemented as push messages, silently converting free traffic into quota consumption.
  • A campaign counted per recipient - one broadcast to a large friend base consumes friend-count messages, not one.

How to fix LINE error 429

  1. 1Check the numbers: GET /v2/bot/message/quota for the limit and GET /v2/bot/message/quota/consumption for month-to-date usage.
  2. 2If a narrowcast is mid-delivery, wait for it to finish (poll its progress endpoint) and retry - the reservation is released when actual counts settle.
  3. 3Raise the plan or the additional-message cap in LINE Official Account Manager for your region; the change takes effect per your plan's terms.
  4. 4Convert every response-to-user path to reply messages with the webhook's replyToken - replies are uncounted and unlimited by quota.
  5. 5Constrain future narrowcasts with the limit object (max recipients / upToRemainingQuota) so reservations can't drain the balance.
  6. 6Queue non-urgent pushes until the new month rather than dropping them, and dedupe with X-Line-Retry-Key on resume.

How to stop it recurring

Meter yourself: poll the quota and consumption endpoints daily, alert at 80%, and hard-stop marketing sends before the API does it for you. Architect reply-first - every user-initiated interaction should ride the free replyToken, reserving paid quota for genuinely proactive traffic. Budget campaigns per recipient (friends x messages), and isolate large narrowcasts from transactional pushes in time so reservation-induced depletion can't block operational messages. See monthly quota.

Official reference: LINE Developers - Messaging API reference (error responses). See all LINE error codes or the LINE limits and quotas.

Related codes

Error 429 - quick answers

What does LINE error 429 mean?

Your LINE Official Account has run out of billable sends for the month. The error messages table gives two triggers: you "exceeded the number of free messages" included in your subscription plan, or you "exceeded your maximum number of additional messages allowed to be sent" - the paid cap you configure in LINE Official Account Manager.

How do I fix LINE error 429?

1. Check the numbers: GET /v2/bot/message/quota for the limit and GET /v2/bot/message/quota/consumption for month-to-date usage. 2. If a narrowcast is mid-delivery, wait for it to finish (poll its progress endpoint) and retry - the reservation is released when actual counts settle. 3. Raise the plan or the additional-message cap in LINE Official Account Manager for your region; the change takes effect per your plan's terms. 4. Convert every response-to-user path to reply…

Stop debugging LINE by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.