Skip to main content
POST
/
presets
/
batch
cURL
curl --request POST \
  --url https://api.sandbox.humanity.org/v2/presets/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "presets": [
    "<unknown>"
  ]
}
'
{
  "results": [
    {
      "preset": "<unknown>",
      "value": "<unknown>",
      "status": "<unknown>",
      "expires_at": "<string>",
      "verified_at": "<string>",
      "evidence": {}
    }
  ],
  "errors": [
    {
      "preset": "<unknown>",
      "error": {
        "error": "<string>",
        "error_code": "<unknown>",
        "error_description": "<string>",
        "error_subcode": "<string>",
        "context": {}
      }
    }
  ]
}
SDK equivalent
const batch = await sdk.verifyPresets(['is_human', 'is_21_plus'], accessToken);
Send one or more preset keys (for example is_human, is_21_plus, humanity_user) to receive the latest verdict, evidence payload, and expiration metadata for each.
  • Include presets[].name + optional presets[].value when requesting dynamic checks.
  • Responses return results[] with status (valid, expired, pending, unavailable) plus timestamps.
  • Use the SDK helper verifyPresets for a typed wrapper around this endpoint.

Body

application/json
​
presets
any[]
required

Response

200 - application/json
​
results
object[]
required
​
errors
object[]
required