# Pre-verified phone numbers | Developer Documentation

<div id="bkmrk-pre-verified-phone-n">## Pre-verified phone numbers

<div><span>Updated: Dec 12, 2025</span></div><div>This document explains how to offer your business customers pre-verified business phone numbers. Pre-verified business phone numbers are WhatsApp business phone numbers that have already been verified by you, eliminating the need for customers to have to contact you for a one-time password.</div><div><div>![Screenshot of pre-verified phone numbers in Embedded Signup flow](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-tu5plv9j.png)</div></div><div>Note that pre-verified business phone numbers are represented by [WhatsApp Business Pre-Verified Phone Number](/documentation/business-messaging/whatsapp/reference/business/whatsapp-business-pre-verified-phone-numbers-api) objects, which are **temporary**. When a business customer selects one of these numbers and completes the Embedded Signup flow, the temporary object will be replaced by a valid [WhatsApp Business Phone Number](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api) object. You must [get this new object's ID](#bkmrk-getting-and-register-1) and use it to [register the number](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation) within 90 days.</div><div id="bkmrk-requirements"><div id="bkmrk-requirements-1"><div>### Requirements

</div></div></div><span>Your business must be an approved Solution Partner.</span><span>The app user must be a business admin on the business account that pre-verified business phone numbers are added to.</span><span>A [User](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [System User access token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</span><span>The [business\_management](https://developers.facebook.com/docs/permissions/reference/business_management) permission.</span><span>Business phone numbers [must be valid](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation).</span><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div><span>You are responsible for keeping track of who has claimed a pre-verified business phone number.</span><span>If a pre-verified business phone number is not claimed by an end client in the Embedded Signup flow within 90 days of verification, the number will revert to an unverified status and must be verified again to have its status restored for another 90 days.</span><span>Unclaimed pre-verified business phone numbers can't be re-verified until 45 days before they are scheduled to revert to an unverified status. This time is indicated by the [`verification_expiry_time` field](/documentation/business-messaging/whatsapp/reference/business/whatsapp-business-pre-verified-phone-numbers-api#fields).</span><span>If you add a phone number to your pool of pre-verified business phone numbers (Step 1) but do not verify it within 90 days (Step 3), it will be removed from your pool and you will have to add it again.</span><span>Once a business customer claims a pre-verified business phone number, you have 90 days to register it.</span><div id="bkmrk-displaying-pre-verif"><div id="bkmrk-displaying-pre-verif-1"><div>### Displaying pre-verified numbers in Embedded Signup

</div></div></div><div>You can display pre-verified business phone numbers in the Embedded Signup flow using [pre-filled form data](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data). To do this, add a `preVerifiedPhone` object with an `ids` property to the `setup` object and assign the IDs of your pre-verified business phone numbers as an array of strings to the `ids` property:</div><div><div>```
{
  scope: '<SCOPE>',
  extras: {
    feature: '<FEATURE>',
    setup: {
      preVerifiedPhone: {
        ids: [<IDS>]
      }
    }
  }
}
```

</div></div><div>For example:</div><div><div>```
{
  scope: 'business_management,whatsapp_business_management',
  extras: {
    feature: 'whatsapp_embedded_signup',
    version: 2,
    setup: {
  business: {
    name: 'Acme Inc.',
    email: 'johndoe@acme.com',
    phone: {
      code: 1,
      number: '6505551234'
        },
    website: 'https://www.acme.com',
        address: {
          streetAddress1: '1 Acme Way',
          city: 'Acme Town',
          state: 'CA',
          zipPostal: '94000',
          country: 'US'
        },
        timezone: 'UTC-08:00'
      },
      phone: {
        displayName: 'Acme Inc.',
        category: 'ENTERTAIN',
        description: 'Gears and widgets'
      },
      preVerifiedPhone: {
        ids: ['106540352242922','105954558954427']
      }
    }
  }
}
```

</div></div><div>Note that if a pre-verified business phone number with a status of `VERIFIED` is not claimed within 90 days of verification, its status will be set to `UNVERIFIED` but it will still appear in the Embedded Signup flow. If a business customer attempts to claim an unverified number, they must complete verification on their own, which means they must request a one-time password from you.</div><div>To prevent this experience, **we recommend that you keep track of when you verified a number and re-verify it before it reverts to an unverified state.**</div><div>If you don't know when you last verified a given pre-verified business phone number, request the `code_verification_time` and `verification_expiry_time` fields on the pre-verified business phone number ID. These fields indicate its most recent verification time and its verification expiration time.</div><div id="bkmrk-determining-if-a-num"><div id="bkmrk-determining-if-a-num-1"><div>### Determining if a number has been claimed through Embedded Signup

</div></div></div><div>See [Getting claimed phone number IDs](#bkmrk-getting-and-register-1).</div><div id="bkmrk-getting-and-register"><div id="bkmrk-getting-and-register-1"><div>### Getting and registering claimed phone numbers

</div></div></div><div>Once a business customer claims a pre-verified business phone number, it will be replaced with a verified WhatsApp business phone number (a [WhatsApp Business Phone Number](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/whatsapp-business-account-phone-number-api#Reading) object with a `code_verification_status` set to `VERIFIED`).</div><div>You will have 90 days to [register this number](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation) using its ID. If you do not register it within this time frame, it will revert to an `UNVERIFIED` status and you will have to [request a new verification code](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation) and use the code to [verify the WhatsApp business phone number](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation) again.</div><div id="bkmrk-getting-claimed-numb"><div id="bkmrk-getting-claimed-numb-1"><div>#### Getting claimed numbers via session logging

</div></div></div><div>If you are using [session logging](/books/meta-whatsapp/page/implementation-developer-documentation), the ID will be returned in a message event and captured by your event listener. Send this ID to your server and then use it to register the WhatsApp business phone number.</div><div id="bkmrk-getting-claimed-numb-3"><div id="bkmrk-getting-claimed-numb-4"><div>#### Getting claimed numbers via API

</div></div></div><div>Parse for the `display_phone_number` property on each object returned in the result set. If an object in the result set has a `display_phone_number` value that matches a number you used to create a pre-verified business phone number, the object represents the WhatsApp business phone number that has replaced the pre-verified business phone number. Copy this object's ID and use it to register the WhatsApp business phone number.</div><div>Alternatively, you can use the same endpoint with `field` expansion to request the `display_phone_number` field and specify the display phone number. For example:</div><div id="bkmrk-get-pre-verified-bus"><div id="bkmrk-get-pre-verified-bus-1"><div>### Get pre-verified business phone numbers

</div></div></div><div>Results are automatically sorted in order of creation time. You can also use field expansion to request the `code_verification_status` field to have the API only return pre-verified business phone numbers with the indicated verification state:</div><div id="bkmrk-registering-pre-veri"><div id="bkmrk-registering-pre-veri-1"><div>### Registering pre-verified numbers programmatically

</div></div></div><div>If you have customized Embedded Signup to [bypass the phone number addition screen](/books/meta-whatsapp/page/bypassing-the-phone-number-addition-screen-developer-documentation), you can register pre-verified business phone numbers on an onboarded business customer's WhatsApp Business Account programmatically. To do this, first complete all of the steps to [create a pre-verified number](#bkmrk-creating-pre-verifie-1), then use the pre-verified number ID to complete **Step 1** and **Step 4** in the [Register Phone Numbers](/books/meta-whatsapp/page/registering-business-phone-numbers-developer-documentation) document.</div></div>