---
title: "Initiate a verification group challenge"
method: POST
path: "/verification/group-challenge"
tags: ["verification"]
---

# Initiate a verification group challenge

`POST /verification/group-challenge`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/verification/group-challenge`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

## Request body

- EnforcerV3InternalUsecaseVerificationsGroupChallengeInput
  - `action` string
  - `meta` object
  - `provider` string

## Response `200`

OK

- InternalDeliveryHttpHandlerChallengeResponse
  - `data` EnforcerV3InternalUsecaseVerificationsGroupChallengeResult
    - `expires_at` string
    - `group_added` string
    - `sensitive_data` object
    - `session_id` string
    - `status` string
  - `success` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `429`: challenge_in_progress — same-type async challenge initiated within the last 10s; honour Retry-After
- `502`: Bad Gateway

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)