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

# 429

> Reference for Stytch API Too Many Requests errors

export const PUBLIC_SLACK_INVITE_URL = "https://join.slack.com/t/stytch/shared_invite/zt-42pquopf7-wRPXlPff773jBd2DiwKv8g";

## captcha\_failed

<Columns cols={2}>
  <div>
    <p><Badge color="red">429</Badge> <strong>Captcha failed</strong></p>

    <p>Captcha failed</p>
  </div>

  ```js theme={null}
  {
    "status_code": 429,
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "error_type": "captcha_failed",
    "error_message": "Captcha failed",
    "error_url": "https://stytch.com/docs/api-reference/consumer/api/errors/429#captcha_failed"
  }
  ```
</Columns>

<Heading noAnchor={true} level={3}>Need help?</Heading>

<Columns cols={2}>
  <Card title="Send us an email" icon="mail" horizontal href="mailto:support@stytch.com" />

  <Card title="Contact us on slack" icon="slack" horizontal href={PUBLIC_SLACK_INVITE_URL} />
</Columns>

***

## too\_few\_tokens\_authenticated

<Columns cols={2}>
  <div>
    <p><Badge color="red">429</Badge> <strong>Too few tokens authenticated</strong></p>

    <p>Too many requests without sufficient percentage of tokens authenticated.</p>
  </div>

  ```js theme={null}
  {
    "status_code": 429,
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "error_type": "too_few_tokens_authenticated",
    "error_message": "Too many requests without sufficient percentage of tokens authenticated.",
    "error_url": "https://stytch.com/docs/api-reference/consumer/api/errors/429#too_few_tokens_authenticated"
  }
  ```
</Columns>

<Heading noAnchor={true} level={3}>Need help?</Heading>

<Columns cols={2}>
  <Card title="Send us an email" icon="mail" horizontal href="mailto:support@stytch.com" />

  <Card title="Contact us on slack" icon="slack" horizontal href={PUBLIC_SLACK_INVITE_URL} />
</Columns>

***

## too\_many\_requests

<Columns cols={2}>
  <div>
    <p><Badge color="red">429</Badge> <strong>Too many requests</strong></p>

    <p>Too many requests hit the Stytch API too quickly. We rate limit suspicious user activity per user, email, or phone number separately from global project rate limits.</p>

    <Heading noAnchor={true} level={3}>Common Causes</Heading>

    <ul>
      <li>Activity from a suspicious user is causing you to send a large number of requests to the Stytch API in a short period of time.</li>
      <li>A bug in your application or testing flow is causing you to unintentionally send a large number of requests to the Stytch API.</li>
      <li>You are attempting to complete testing flows that require a large number of requests to be made for the same email address or phone number.</li>
    </ul>

    <Heading noAnchor={true} level={3}>Troubleshooting</Heading>

    <ul>
      <li>Implement an exponential backoff of your requests.</li>
      <li>Investigate any suspicious user activity on your end and take appropriate action, such as blocking the offending user.</li>
      <li>Check your codebase to make sure that you are not unintentionally sending more requests than necessary to the Stytch API.</li>
      <li>Use our Test environment and <a href="/docs/docs#resources_testing">sandbox values</a> to complete testing flows.</li>
    </ul>
  </div>

  ```js theme={null}
  {
    "status_code": 429,
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "error_type": "too_many_requests",
    "error_message": "Too many requests have been made.",
    "error_url": "https://stytch.com/docs/api-reference/consumer/api/errors/429#too_many_requests"
  }
  ```
</Columns>

<Heading noAnchor={true} level={3}>Need help?</Heading>

<Columns cols={2}>
  <Card title="Send us an email" icon="mail" horizontal href="mailto:support@stytch.com" />

  <Card title="Contact us on slack" icon="slack" horizontal href={PUBLIC_SLACK_INVITE_URL} />
</Columns>

***

## user\_lock\_limit\_reached

<Columns cols={2}>
  <div>
    <p><Badge color="red">429</Badge> <strong>User lock limit reached</strong></p>

    <p>The user has been locked out due to too many failed authentication attempts. Please try again later.</p>
  </div>

  ```js theme={null}
  {
    "status_code": 429,
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "error_type": "user_lock_limit_reached",
    "error_message": "The user has been locked out due to too many failed authentication attempts. Please try again later.",
    "error_url": "https://stytch.com/docs/api-reference/consumer/api/errors/429#user_lock_limit_reached"
  }
  ```
</Columns>

<Heading noAnchor={true} level={3}>Need help?</Heading>

<Columns cols={2}>
  <Card title="Send us an email" icon="mail" horizontal href="mailto:support@stytch.com" />

  <Card title="Contact us on slack" icon="slack" horizontal href={PUBLIC_SLACK_INVITE_URL} />
</Columns>

***