Account Claims
Verify the claim OTP and reveal the claim-eligible account
Verifies the OTP issued by POST /v1/auth/methods. On success returns the claim-eligible child organization's details plus a single-use claim token for POST /v1/account_claims/complete. Every challenge-verification failure returns an identical 422, so this step cannot be used to tell whether a claim is in progress for an email. Once the OTP is accepted the claim preconditions are re-checked and may answer 409 — the email gained a user, or the organization already has an owner — which discloses nothing, since reaching it requires the correct code.
post/v1/account_claims
Request
- Base URLhttps://identity-api.paymongo.com
- URLhttps://identity-api.paymongo.com/v1/account_claims
- Authnone required
Request body
Example request
{
"data": {
"attributes": {
"code": "123456",
"email": "user@example.com"
}
}
}Response
Created
Example response
{
"data": {
"attributes": {
"account_type": "merchant",
"email": "user@example.com",
"expires_at": 1735690800,
"first_name": "Juan",
"last_name": "dela Cruz",
"organization_id": "org_123",
"token": "3mJr7AoUXx2Wqd8Lz9Kf"
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.