Migration Intent

Get Migration Intent Details

Retrieve comprehensive details about a WhatsApp Business Account migration intent, including its current status and migration information.

Use Cases:

  • Monitor migration intent lifecycle and status changes
  • Verify migration intent configuration and current state
  • Check migration progress and completion status
  • Retrieve migration intent details for business workflows

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Caching: Migration intent details can be cached for short periods, but status information may change frequently during migration processes. Implement appropriate cache invalidation strategies.

get/{Version}/{Migration-Intent-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Migration-Intent-ID}
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Migration-Intent-IDstring required

Your Migration Intent ID. This ID is provided when you create the migration intent and can be found through migration management APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, status). Available fields: id, status

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Successfully retrieved migration intent details

idstring required

Unique identifier for the migration intent

status'ACCEPTED' | 'COMPLETED' | 'INITIATED' | 'REJECTED' required

Current status of the WhatsApp Business Account migration intent

Example response

{
  "id": "1234567890123456",
  "status": "INITIATED"
}

Changes

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