consents

Verify OTP code

Verify OTP code for informed consent. Marks consent as verified and sets 10-year expiration.

post/api/consents/verify-otp

Request

  • Base URL: https://api.corabea.it (the document declares no server; this is the origin it was published from)
  • URL: https://api.corabea.it/api/consents/verify-otp
  • Auth: HTTP bearer

Request body

consent_idstring uuid required

Consent UUID

otp_codestring required

6-digit OTP code

Example request

{
  "consent_id": "123e4567-e89b-12d3-a456-426614174001",
  "otp_code": "123456"
}

Response

Successful Response

consent_idstring uuid required

Consent UUID

status'draft' | 'pending_otp' | 'pending_approval' | 'revision_required' | 'verified' | 'expired' | 'revoked' required

Informed consent status constants.

messagestring required

Success message

verified_atstring date-time required

Verification timestamp

expires_atstring date-time required

Consent expiration date (10 years)

Example response

{
  "consent_id": "123e4567-e89b-12d3-a456-426614174001",
  "expires_at": "2035-01-16T10:00:00Z",
  "message": "Consenso verificato con successo",
  "status": "verified",
  "verified_at": "2025-01-16T10:00:00Z"
}

Changes

No recorded changes to this operation across all 55 revisions of this API.