Create bulk challenges
Creates parental consent challenges for several products at once, for a single player, so one guardian interaction can cover a whole product family. The response carries a challenge per requested product. As with a single challenge, `oneTimePassword` and `url` are omitted once a challenge has passed or failed.
Authorization
api-key In: header
Request Body
application/json
Create bulk challenges request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/challenge/create-bulk" \ -H "Content-Type: application/json" \ -d '{ "jurisdiction": "US-CA", "requestedProductIds": [ 0 ], "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d" }'{ "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802", "type": "CHALLENGE_PARENTAL_CONSENT", "url": "https://example.com/challenge", "oneTimePassword": "123456", "childLiteAccessEnabled": true, "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d", "jurisdiction": "US-CA", "age": 13, "dateOfBirth": "2005-04-15", "otpExpiresAt": "2022-01-01T00:00:00Z", "materialChange": { "presentedDocuments": [ "string" ], "issuedAt": "2019-08-24T14:15:22Z", "actionedAt": "2019-08-24T14:15:22Z", "acceptanceDeadline": "2019-08-24T14:15:22Z" }, "documents": [ { "id": "privacy-policy", "name": "Privacy Policy", "url": "https://example.com/privacy", "isDataNotice": false } ]}{ "error": "INVALID_INPUT", "errorMessage": "Essential product mismatch."}Cancel a parent invite POST
Cancels an in-flight parent-invite challenge before the parent has completed it. Used when the player cancels their pending invite from inside your application while the parent is mid-verification. On cancel the challenge transitions to FAIL with `failureReason: "cancelled-by-initiator"` and any parent currently viewing the hosted widget sees the "invite canceled" state. Only `CHALLENGE_PARENT_INVITE` challenges may be cancelled via this endpoint.
Generate a new OTP for the challenge POST
This API is used to generate a new one-time password (OTP) for a given challenge.