---
title: "Verify the CAPTCHA solution,"
method: POST
path: "/api/v1/siteverify"
tags: ["CoreApi"]
---

# Verify the CAPTCHA solution,

`POST /api/v1/siteverify`

The response will tell you whether the CAPTCHA solution is valid and hasn't been used before.
If you receive a response code other than 200 in production,
you should probably accept the user's form despite not having been able to verify the CAPTCHA solution.

## Request body

- SiteverifyPOSTRequest
  - `secret` string, required — An API key that proves it's you, create one on the Friendly Captcha website
  - `sitekey` string — Optional: the sitekey that you want to make sure the puzzle was generated from.
  - `solution` string, required — The solution value that the user submitted in the frc-captcha-solution field

## Response `200`

OK

- SiteverifyPOSTResponse
  - `details` string
  - `errors` string[] — If you are seeing status code 400 or 401 your server code is probably not configured correctly. secret_missing (400) You forgot to add the secret (=API key) parameter. secret_invalid (401) The API key you provided was invalid. solution_missing (400) You forgot to add the solution parameter. bad_request (400) Something else is wrong with your request, e.g. your request body is empty. solution_invalid (200) The solution you provided was invalid (perhaps the user tried to tamper with the puzzle). solution_timeout_or_duplicate (200) The puzzle that the solution was for has expired or has already been used.
  - `success` boolean, required — If success is false, errors will be a list containing at least one of the error codes.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `502` — Bad Gateway

---

[API](https://skmtc.dev/friendlycaptcha/apis/friendly-captcha-api.md) · [All operations](https://skmtc.dev/friendlycaptcha/apis/friendly-captcha-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/friendlycaptcha/friendly-captcha-api/revisions/a6b8878cf24b/schema)