AWS WAF Captcha Solver | CaptchaSonic Docs

Bypass AWS WAF challenges using the AwsWafImage task type. Submit base64-encoded images with the question format aws:grid:<target>.

Create Task

POST/createTask

Hostapi.captchasonic.com

Content-Typeapplication/json

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "AwsWafImage",
        "question": "aws:grid:traffic_light",
        "queries": ["BASE64_GRID_IMAGE"],
        "websiteURL": "https://example.com"
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [1, 5, 8]
}

answers contains the indices of grid cells matching the target object.

Question Format

The question field follows the pattern aws:<type>:<target>:

Pattern	Description
`aws:grid:traffic_light`	Select grid cells with traffic lights
`aws:grid:chair`	Select grid cells with chairs
`aws:grid:bus`	Select grid cells with buses

Task Parameters

Property	Type	Required	Description
`type`	`string`	✅	`AwsWafImage`
`question`	`string`	✅	Challenge instruction in `aws:<type>:<target>` format
`queries`	`string[]`	✅	Base64-encoded grid images
`websiteURL`	`string`	No	Target website URL for context

API Playground

POSTapi.captchasonic.com

Payload

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "AwsWafImage",
    "question": "aws:grid:traffic_light",
    "queries": [
      "BASE64_GRID_IMAGE"
    ],
    "websiteURL": "https://example.com"
  }
}

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "AwsWafImage",
    "question": "aws:grid:traffic_light",
    "queries": [
      "BASE64_GRID_IMAGE"
    ],
    "websiteURL": "https://example.com"
  }
}

Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY

taskobject{...}

└ typestringAwsWafImage

└ questionstringaws:grid:traffic_light

└ queriesarray[1 items]

└ websiteURLstringhttps://example.com

Error Codes

1KEY_DOES_NOT_EXIST— API key is invalid or not found.

2NO_SLOT_AVAILABLE— All solver slots are occupied.

3ZERO_BALANCE— Account balance is zero.

10ERROR_BAD_PARAMETERS— Invalid or missing request fields.

12ERROR_CAPTCHA_UNSOLVABLE— Captcha could not be solved.

14PLAN_EXPIRED— Your plan has expired.

16RATE_LIMITED— Too many requests. Slow down.

17DAILY_LIMIT_EXCEEDED— Daily usage limit reached.

18QUOTA_LIMIT_EXCEEDED— Plan quota exhausted.

21SERVICE_UNAVAILABLE— Backend is temporarily unavailable.

Code

terminal