Protection API

post/validate-request/

Request

  • Base URL
    https://api.datadome.co
  • URL
    https://api.datadome.co/validate-request/
  • Auth
    none required

Headers

Content-Typestring required

Should be application/x-www-form-urlencoded

Request body application/x-www-form-urlencoded

Keystring required

The server-side API key provided on your dashboard

Acceptstring required

The value of the Accept request header

AcceptCharsetstring required

The value of the Accept-Charset request header

AcceptEncodingstring required

The value of the Accept-Encoding request header

AcceptLanguagestring required

The value of the Accept-Language request header

APIConnectionStatestring

new if the API request is using a new connection, or reuse if it reused a keep-alive connection

AuthorizationLeninteger required

The length of the Authorization request header's value

CacheControlstring required

The value of the Cache-Control request header

ClientIDstring required

The value of the datadome cookie attached to the client request

Connectionstring

The value of the Connection request header

ContentTypestring required

The value of the Content-Type request header

CookiesLeninteger required

The length of the Cookie request header's value (including all cookies)

CookiesListstring required

A comma-separated list of all cookies' keys coming from the client request, with their original order preserved

CustomFieldFloat1number float

User-defined float value

CustomFieldInteger1integer

User-defined integer value

CustomFieldInteger2integer

User-defined integer value

CustomFieldString1string

User-defined string value

CustomFieldString2string

User-defined string value

CustomFieldString3string

User-defined string value

Fromstring required

The value of the From request header

GraphQLOperationCountinteger

Number of GraphQL operation in the request

GraphQLOperationNamestring

Name of the GraphQL operation

GraphQLOperationTypestring

Type of the GraphQL operation (query/mutation/subscription)

HeadersListstring required

A comma-separated list of all headers coming from the client request, with their original order preserved

Hoststring required

The value of the Host request header

IPstring required

The IP address (v4 or v6) of the client that sent the request

JA3string

Value of JA3 TLS Fingerprinting coming from an implementation of https://github.com/salesforce/ja3

JA4string

Value of JA4 TLS Fingerprinting coming from an implementation of https://github.com/FoxIO-LLC/ja4

JsonRpcRequestIdstring

The ID of the JSON-RPC request

JsonRpcVersionstring

The version of the JSON-RPC protocol

McpMethodstring

The value of the Model Context Protocol method

McpParamsClientInfoNamestring

Name of the Model Context Protocol client implementation used in the initialize method

McpParamsClientInfoVersionstring

Version of the Model Context Protocol client implementation used in the initialize method

McpParamsToolNamestring

Name of the tool invoked in the tools/call method

McpProtocolVersionstring

The value of the Mcp-Protocol-Version request header

McpSessionIdstring

The value of the Mcp-Session-Id request header

Methodstring required

The method name of the request (GET, POST, OPTIONS, etc.)

ModuleVersionstring required

The version number of the module that is processing the request

Originstring required

The value of the Origin request header

Portinteger required

The port number of the TCP/IP connection that issued the request (from the client)

PostParamLeninteger required

The length of a POST request payload reported by the Content-Length header

Pragmastring required

The value of the Pragma request header

ProductIdstring

The value of the product Id being seen or added to the customer basket

Protocolstring required

The protocol scheme used on the request's URL

Refererstring required

The value of the Referer request header

Requeststring required

The path and query parts of the request's URL

RequestModuleNamestring required

The name of the module that is processing the request

SecCHDeviceMemorystring

The value of the Sec-CH-Device-Memory request header

SecCHUAstring

The value of the Sec-CH-UA request header

SecCHUAArchstring

The value of the Sec-CH-UA-Arch request header

SecCHUAFullVersionListstring

The value of the Sec-CH-UA-Full-Version-List request header

SecCHUAMobilestring

The value of the Sec-CH-UA-Mobile request header

SecCHUAModelstring

The value of the Sec-CH-UA-Model request header

SecCHUAPlatformstring

The value of the Sec-CH-UA-Platform request header

SecFetchDeststring

The value of the Sec-Fetch-Dest request header

SecFetchModestring

The value of the Sec-Fetch-Mode request header

SecFetchSitestring

The value of the Sec-Fetch-Site request header

SecFetchStorageAccessstring

The value of the Sec-Fetch-Storage-Access request header

SecFetchUserstring

The value of the Sec-Fetch-User request header

ServerHostnamestring required

The virtual hostname of the server that is processing the request

ServerNamestring required

The name of the server which is processing the request

ServerRegionstring

The region of the server which is processing the request

Signaturestring

The value of the Signature request header

SignatureAgentstring

The value of the Signature-Agent request header

SignatureInputstring

The value of the Signature-Input request header

SkyfirePayIdstring

The value of the Skyfire-Pay-Id request header for AI bot monetization

TimeRequestinteger required

A timestamp in microseconds marking the time at which the request was processed by the module

TlsCipherstring

Hexadecimal value representing all cipher suites that are available, in order of preference

TlsProtocolstring

TlsProtocol

TrueClientIPstring required

The value of the True-Client-IP request header

UserAgentstring required

The value of the User-Agent request header

UserIDstring

Internal customer or client ID (apply only when your customer is log in)

Viastring required

The value of the Via request header

XForwardedForIPstring required

The value of the X-Forwarded-For request header

X-Requested-Withstring required

The value of the X-Requested-With request header

X-Real-IPstring required

The value of the X-Real-IP request header

Changes

No recorded changes to this operation across all 2 revisions of this API.