Skip to content

CAPTCHA verification


Creates a new captcha session

POST/api/security/captcha/create
Terminal window
https://api.cookie-api.com/api/security/captcha/create


URL Parameters
color optionalAccent color of the verification page in HEX format (Default: #4EAF54)
font optionalFont to be used. All available fonts are here: https://fonts.google.com. (Default font: Poppins)
captcha_providerCAPTCHA Provider to be used. Use either Cloudflare or Google
expires optionalUNIX Timestamp in the future to set the expiration (Default: 1 hour, Max: 2 days)

curl --location --request POST 'https://api.cookie-api.com/api/security/captcha/create?captcha_provider=cloudflare&font=balls&color=%23FFFFFF' \
--header 'Authorization: API_Key'

Responses
{
"captcha_id": "2725738690",
"success": true,
"url": "https://api.cookie-api.com/public/captcha?code=JPe-hyVw2m6l_a-W7jqfSWwtdp-jYpOADPKMBwac1-qEAYKQ-NjFcRf0oE24TjfHn0873As1n9Kr5KGcVBoy-v2ccUm_KcFam4UM7AbaiykAV-vpVScVx4Mpt06ScELSbpt-tKJRT3J-mDK4bUWHVYxTvgXunJHhkCDRb03SnrTqRO0SJnCPM9bgPfL9KqHZ3DVWmLnhpPxGrXRxB4HZ",
"url_code": "JPe-hyVw2m6l_a-W7jqfSWwtdp-jYpOADPKMBwac1-qEAYKQ-NjFcRf0oE24TjfHn0873As1n9Kr5KGcVBoy-v2ccUm_KcFam4UM7AbaiykAV-vpVScVx4Mpt06ScELSbpt-tKJRT3J-mDK4bUWHVYxTvgXunJHhkCDRb03SnrTqRO0SJnCPM9bgPfL9KqHZ3DVWmLnhpPxGrXRxB4HZ"
}


Returns a the result/status of a CAPTCHA session

GET/api/security/captcha/get-captcha
Terminal window
https://api.cookie-api.com/api/security/captcha/get-captcha


URL Parameters
captcha_idCAPTCHA ID of the CAPTCHA chellange

curl --location 'https://api.cookie-api.com/api/security/captcha/get-captcha?captcha_id=2725738690' \
--header 'Authorization: API_Key'

Responses
{
"captcha_id": "2725738690",
"created_at": "1739110385",
"solved": "YES",
"solved_at": "1739110529",
"success": true
}


Deletes a CAPTCHA session

DELETE/api/security/captcha/delete
Terminal window
https://api.cookie-api.com/api/security/captcha/delete


URL Parameters
captcha_idCAPTCHA ID of the CAPTCHA challenge

curl --location --request DELETE 'https://api.cookie-api.com/api/security/captcha/delete?captcha_id=2725738690' \
--header 'Authorization: API_Key'

Responses
{
"success": true
}


Lists all your CAPTCHA sessions

GET/api/security/captcha/list
Terminal window
https://api.cookie-api.com/api/security/captcha/list


curl --location 'https://api.cookie-api.com/api/security/captcha/list' \
--header 'Authorization: API_Key'

Responses
{
"count": 3,
"sessions": [
{
"captcha_id": "3625236803",
"created_at": "1739066578",
"solved": "YES",
"solved_at": "1739102437"
},
{
"captcha_id": "7395811932",
"created_at": "1739067793",
"solved": "YES",
"solved_at": "1739101442"
},
{
"captcha_id": "6322587024",
"created_at": "1739110162",
"solved": "NO",
"solved_at": "0"
}
],
"success": true
}


  • Minimal interaction: Most users won’t even notice they’re going through a CAPTCHA challenge, providing a seamless experience.
  • Privacy-focused: Doesn’t track users with cookies or collect personal data, offering better privacy.
  • Faster and smoother: Since it’s mostly behind-the-scenes, users rarely experience interruptions or delays.
  • No annoying challenges: For most users, there are no checkboxes or image puzzles to solve, making it less frustrating.
  • Newer system: As a newer solution, it might not be as widely recognized, so some users may not be familiar with it.
  • Widely recognized: Users are very familiar with the “I’m not a robot” checkbox, so they know what to expect.
  • Reliable: Google’s system is well-established and trusted by many websites, ensuring high accuracy in detecting bots.
  • Interruptions: Users often need to interact with the CAPTCHA by clicking the checkbox or solving image puzzles, which can be annoying or time-consuming.
  • Privacy concerns: Google collects user data (e.g., IP address, cookies) to analyze behavior, which could raise privacy concerns for users who are more privacy-conscious.
  • False positives: Sometimes, legitimate users are flagged as suspicious and forced to complete additional challenges, which can be frustrating.