v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

HST

Get challenge result

Receive challenge result.

post/v1/challenge-result

Request body

idstring required

Pismo-generated unique authentication ID

decision'approve' | 'reject' required

Client's anti-fraud decision

answered_atstring required

End-user action RFC3339 timestamp

metadatastring required

Any data object with key/value pairs. No limit on length.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example request

{
  "id": "ff77635e-1cd6-4fda-992d-5ceb71d75644",
  "decision": "approve",
  "answered_at": "2022-12-21T10:08:58Z",
  "metadata": "{ \"key\": \"value\"}"
}

Response

authenticatedboolean

descriptionstring

Challenge result

Example response

{
  "description": "Challenge expired"
}