> ## 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.

# 400

> Reference for Stytch API Bad Request errors

## cidr\_block\_invalid\_prefix

400 **Cidr block invalid prefix**

The CIDR block provided was too large. The CIDR block prefix must be between 16 and 32, inclusive.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "cidr_block_invalid_prefix",
  "error_message": "The CIDR block provided was too large. The CIDR block prefix must be between 16 and 32, inclusive.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#cidr_block_invalid_prefix"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## dfp\_rule\_invalid\_cursor

400 **Dfp rule invalid cursor**

The submitted cursor is not valid. Please contact [support@stytch.com](mailto:support@stytch.com) for assistance.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "dfp_rule_invalid_cursor",
  "error_message": "The submitted cursor is not valid. Please contact support@stytch.com for assistance.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#dfp_rule_invalid_cursor"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_action\_for\_rules

400 **Invalid action for rules**

The action provided is invalid. The action must be 'ALLOW', 'BLOCK', 'CHALLENGE', or 'NONE'.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_action_for_rules",
  "error_message": "The action provided is invalid. The action must be 'ALLOW', 'BLOCK', 'CHALLENGE', or 'NONE'.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_action_for_rules"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_asn

400 **Invalid asn**

The ASN provided was invalid.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_asn",
  "error_message": "The ASN provided was invalid.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_asn"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_authorization\_header

400 **Invalid authorization header**

The authorization header provided with the request is invalid.

Common Causes

<ul>
  <li>HTTP request is missing an Authorization header</li>
  <li>The Authorization header in the HTTP request is not formatted properly</li>
  <li>The Authorization header in the HTTP request has the incorrect credentials</li>
</ul>

Troubleshooting

<ul>
  <li>Check the Authorization header in the HTTP request for proper formatting.</li>
  <li>Always use the Basic Auth type in the header.</li>
  <li>Check the project credentials you entered match your API keys in the [Dashboard](https://stytch.com/dashboard).</li>
</ul>

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_authorization_header",
  "error_message": "The authorization header provided with the request is invalid.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_authorization_header"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_cidr\_block

400 **Invalid cidr block**

The CIDR block provided was invalid. You must specify either a valid IP address or a valid CIDR block.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_cidr_block",
  "error_message": "The CIDR block provided was invalid. You must specify either a valid IP address or a valid CIDR block.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_cidr_block"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_country\_code

400 **Invalid country code**

The country code provided was invalid. Country codes must be valid ISO 3166-1 alpha-2 codes.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_country_code",
  "error_message": "The country code provided was invalid. Country codes must be valid ISO 3166-1 alpha-2 codes.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_country_code"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_country\_code\_allow\_rule

400 **Invalid country code allow rule**

You may not set an ALLOW rule on a country code.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_country_code_allow_rule",
  "error_message": "You may not set an ALLOW rule on a country code.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_country_code_allow_rule"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_external\_metadata

400 **Invalid external metadata**

External metadata fields may not exceed 65 characters. They may only contain alphanumerics and the characters '\_', '-', '+', '.', or '@'.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_external_metadata",
  "error_message": "External metadata fields may not exceed 65 characters. They may only contain alphanumerics and the characters '_', '-', '+', '.', or '@'.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_external_metadata"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_fingerprint\_or\_id

400 **Invalid fingerprint or id**

The fingerprint or ID provided was invalid.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_fingerprint_or_id",
  "error_message": "The fingerprint or ID provided was invalid.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_fingerprint_or_id"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_project\_id\_authentication

400 **Invalid project id authentication**

The project ID provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To view your project ID please visit the Stytch Dashboard [here](https://stytch.com/dashboard).

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_project_id_authentication",
  "error_message": "The project ID provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new project or confirm an existing project ID please visit the Stytch dashboard here: https://stytch.com/dashboard/api-keys.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_project_id_authentication"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_public\_token\_id

400 **Invalid public token id**

The `public_token` used to instantiate the Stytch SDK is invalid. You can find your `public_token` in the [Project ID & API keys section of the Project Overview](https://stytch.com/dashboard) in the Stytch Dashboard.

Common Causes

<ul>
  <li>No `public_token` was passed in when loading the Stytch SDK.</li>
  <li>The `public_token` passed was invalid, e.g. it contains quotes, was of an incorrect length or format, etc.</li>
</ul>

Troubleshooting

<ul>
  <li>Check that your environment contains your Stytch `public_token`.</li>
  <li>Check that you're passing the `public_token` in via the correct method. You can see how to launch each Stytch SDK by visiting their respective [Docs](https://stytch.com/docs/sdks.md).</li>
</ul>

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_public_token_id",
  "error_message": "public_token_id format is invalid.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_public_token_id"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_request\_error

400 **Invalid request error**

The request was invalid.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_request_error",
  "error_message": "The request was invalid.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_request_error"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_secret\_authentication

400 **Invalid secret authentication**

The secret provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new secret for your project or to confirm an existing secret please visit the Stytch Dashboard [here](https://stytch.com/dashboard).

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_secret_authentication",
  "error_message": "The secret provided in the basic authentication header is invalid. Please check to make sure the format is correct and there are no trailing whitespaces. To create a new secret for your project or to confirm an existing secret please visit the Stytch dashboard here: https://stytch.com/dashboard/api-keys.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_secret_authentication"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## invalid\_verdict\_reason

400 **Invalid verdict reason**

The verdict reason provided was invalid. Please see the docs for a full list of valid verdict reasons.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "invalid_verdict_reason",
  "error_message": "The verdict reason provided was invalid. Please see the docs for a full list of valid verdict reasons.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#invalid_verdict_reason"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## mock\_telemetry\_id\_in\_live\_project

400 **Mock telemetry id in live project**

Mock telemetry IDs (beta-mock-\*) can only be used in test environments. Please use a real telemetry ID or switch to a test project.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "mock_telemetry_id_in_live_project",
  "error_message": "Mock telemetry IDs (beta-mock-*) can only be used in test environments. Please use a real telemetry ID or switch to a test project.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#mock_telemetry_id_in_live_project"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## multiple\_fingerprints\_provided

400 **Multiple fingerprints provided**

The request included multiple fingerprints, IDs, and/or IPGEO attributes. The SetRules endpoint can only modify one identifier at a time.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "multiple_fingerprints_provided",
  "error_message": "The request included multiple fingerprints, IDs, and/or IPGEO attributes. The SetRules endpoint can only modify one identifier at a time.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#multiple_fingerprints_provided"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## no\_fingerprint\_provided

400 **No fingerprint provided**

The request did not include a fingerprint, ID, or IPGEO attribute. The Set Rules endpoint needs an identifier to be able to set a rule.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "no_fingerprint_provided",
  "error_message": "The request did not include a fingerprint, ID, or IPGEO attribute. The Set Rules endpoint needs an identifier to be able to set a rule.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#no_fingerprint_provided"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## project\_id\_secret\_required

400 **Project id secret required**

This request is using a public token, but a project ID and secret are required. Please provide a valid project ID and secret in the basic authentication header.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "project_id_secret_required",
  "error_message": "This request is using a public token, but a project ID and secret are required. Please provide a valid project ID and secret in the basic authentication header.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#project_id_secret_required"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## verdict\_reason\_override\_description\_too\_long

400 **Verdict reason override description too long**

The override description may not exceed 500 characters.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "verdict_reason_override_description_too_long",
  "error_message": "The override description may not exceed 500 characters.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#verdict_reason_override_description_too_long"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## verdict\_reason\_override\_invalid\_verdict\_action

400 **Verdict reason override invalid verdict action**

The override action provided was invalid. The override action must be one of ALLOW, CHALLENGE, BLOCK, or NONE (to delete an existing override).

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "verdict_reason_override_invalid_verdict_action",
  "error_message": "The override action provided was invalid. The override action must be one of ALLOW, CHALLENGE, BLOCK, or NONE (to delete an existing override).",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#verdict_reason_override_invalid_verdict_action"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***

## verdict\_reason\_override\_not\_supported

400 **Verdict reason override not supported**

You may not set an override for this verdict reason. Please see the docs for a full list of valid verdict reasons that you may set overrides on.

```js theme={null}
{
  "status_code": 400,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "verdict_reason_override_not_supported",
  "error_message": "You may not set an override for this verdict reason. Please see the docs for a full list of valid verdict reasons that you may set overrides on.",
  "error_url": "https://stytch.com/docs/api-reference/fraud/api/errors/400#verdict_reason_override_not_supported"
}
```

Need help?

> [card] [Send us an email](mailto:support@stytch.com)

> [card] [Contact us on slack](https://join.slack.com/t/stytch/shared_invite/zt-4cehhoyc1-NfCa_KH84yWx1reUbqIhYw)

***
