/
Contact usSee pricingStart building
    Introduction
    Device Fingerprinting
      Fingerprint Lookup
      Fingerprint Lookup (Deprecated)
      Set Rule
      Get Rules
      Set Verdict Reason Override
      Get Verdict Reasons
    Errors
      Overview
      Error object
      400
      401
      403
      404
      408
      499
      500
      503
Get support on SlackVisit our developer forum

Contact us

Fraud and Risk Prevention

/

API reference

/

Errors

/

400

400 errors

cidr_block_invalid_prefix

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#cidr_block_invalid_prefix"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

dfp_rule_invalid_cursor

400
Bad request

The submitted cursor is not valid. Please contact support@stytch.com for assistance.

Error
{
  "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/fraud/api/errors/400#dfp_rule_invalid_cursor"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_action_for_rules

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_action_for_rules"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_asn

400
Bad request

The ASN provided was invalid.

Error
{
  "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/fraud/api/errors/400#invalid_asn"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_authorization_header

400
Bad request

The authorization header provided with the request is invalid.

Common causes

  • HTTP request is missing an Authorization header

  • The Authorization header in the HTTP request is not formatted properly

  • The Authorization header in the HTTP request has the incorrect credentials

Troubleshooting steps

  • Check the Authorization header in the HTTP request for proper formatting.

  • Always use the Basic Auth type in the header.

  • Check the project credentials you entered match your API keys in the Dashboard.

Error
{
  "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/fraud/api/errors/400#invalid_authorization_header"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_cidr_block

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_cidr_block"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_country_code

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_country_code"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_country_code_allow_rule

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_country_code_allow_rule"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_external_metadata

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_external_metadata"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_fingerprint_or_id

400
Bad request

The fingerprint or ID provided was invalid.

Error
{
  "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/fraud/api/errors/400#invalid_fingerprint_or_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_project_id_authentication

400
Bad request

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.

Error
{
  "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/fraud/api/errors/400#invalid_project_id_authentication"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_public_token_id

400
Bad request

The public_token used to instantiate the Stytch SDK is invalid. You can find your public_token in the API keys section of the Stytch Dashboard.

Common causes

  • No public_token was passed in when loading the Stytch SDK.

  • The public_token passed was invalid, e.g. it contains quotes, was of an incorrect length or format, etc.

Troubleshooting steps

  • Check that your environment contains your Stytch public_token.

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

Error
{
  "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/fraud/api/errors/400#invalid_public_token_id"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_request_error

400
Bad request

The request was invalid.

Error
{
  "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/fraud/api/errors/400#invalid_request_error"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_secret_authentication

400
Bad request

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.

Error
{
  "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/fraud/api/errors/400#invalid_secret_authentication"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

invalid_verdict_reason

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#invalid_verdict_reason"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

multiple_fingerprints_provided

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#multiple_fingerprints_provided"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

no_fingerprint_provided

400
Bad request

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
{
  "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/fraud/api/errors/400#no_fingerprint_provided"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

project_id_secret_required

400
Bad request

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
{
  "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/fraud/api/errors/400#project_id_secret_required"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

verdict_reason_override_description_too_long

400
Bad request

The override description may not exceed 500 characters.

Error
{
  "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/fraud/api/errors/400#verdict_reason_override_description_too_long"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

verdict_reason_override_invalid_verdict_action

400
Bad request

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

Error
{
  "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/fraud/api/errors/400#verdict_reason_override_invalid_verdict_action"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack

verdict_reason_override_not_supported

400
Bad request

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
{
  "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/fraud/api/errors/400#verdict_reason_override_not_supported"
}
How to get help
Visit our forum
Stytch Forum

Send us an email
support@stytch.com

Ask in Slack
Slack