Claim a registration

POST

/registrations/{id}/claim

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

Id of a registration the calling account started.

Body

application/json

emailstringrequired

Email address that receives the verification email and becomes the account's email once verified.

Response

application/json

Success

idstringrequired

Registration id, used to get or claim the registration.

statusenum<string>required

awaiting_email until an email address is given, awaiting_verification once the verification email is sent, verified once the address is confirmed and the account is active.

Available options: awaiting_email, awaiting_verification, verified

emailstring | nullrequired

Email address being verified; null until one is given.

verification_sent_atstring | nullrequired

When the last verification email was sent, as an ISO 8601 timestamp; null if none was sent.

expires_atstringrequired

When the registration expires, as an ISO 8601 timestamp. An account still unverified by then is due for deletion.

accountobjectrequired

The account the registration created.

Claim a registration

curl --request POST \
  --url https://api.bavlio.com/registrations/{id}/claim \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

curl --request POST \  --url https://api.bavlio.com/registrations/{id}/claim \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{  "email": "<string>"}'

{
  "id": "<string>",
  "status": "awaiting_email",
  "email": "<string>",
  "verification_sent_at": "<string>",
  "expires_at": "<string>",
  "account": {
    "id": "<string>",
    "email": "<string>",
    "status": "ephemeral",
    "created_at": "<string>",
    "verified_at": "<string>"
  }
}

{  "id": "<string>",  "status": "awaiting_email",  "email": "<string>",  "verification_sent_at": "<string>",  "expires_at": "<string>",  "account": {    "id": "<string>",    "email": "<string>",    "status": "ephemeral",    "created_at": "<string>",    "verified_at": "<string>"  }}