{"uid":"cap_SQH6RP7Ev0FhzVa5KoYnH","slug":"stablephone-551115bd","name":"StablePhone iMessage/FaceTime Lookup","description":"iMessage/FaceTime lookup","url":"https://stablephone.dev/api/lookup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"phone_number":{"type":"string","pattern":"^\\+1\\d{10}$"}}},"responseSchema":null,"example":{"request":{"phone_number":"+14155552671"},"response":{"token":"eyJhbGciOiJIUzI1NiJ9.eyJyaWQiOiIxOWUxZmI3Yi1kNDAzLTRjYzUtOWZlNy03OGFmYTVjOWJjYWQiLCJwaCI6IisxNDE1NTU1MjY3MSIsInciOiIweDljYzQyZjNkOTI0NWI4NjdhY2NjZDYzMGI0M2Y5MDZjMTY2NWIxNzYiLCJpYXQiOjE3ODAwODYzMjYsImV4cCI6MTc4MDA4OTkyNn0.O38o06EaRTFCJ7F9n39Wxxr6RlXFI3stYhMCGaDGhNM"}},"exampleRequest":{"phone_number":"+14155552671"},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ctbmIJgUttXFXa2T0xOL1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given phone number has iMessage or FaceTime enabled, returning a token to poll for the async result.","exampleAgentPrompt":"Can you check if +14155552671 has iMessage or FaceTime enabled? I want to know before I try to reach them through Apple's messaging.","exampleUseCases":[{"title":"Route customer messages by platform","prompt":"Before we send our next outreach, check which contacts in this batch support iMessage. I want to use Apple Messages for anyone who has it enabled, and fall back to SMS for the rest."},{"title":"Verify contact is an iPhone user","prompt":"I'm trying to confirm if this number belongs to an iPhone user before adding them to our FaceTime call list. Can you check if +14155552671 has FaceTime capability?"},{"title":"Build contact enrichment workflow","prompt":"As we import these new leads, enrich each phone number by checking whether they have iMessage or FaceTime active. I need that data so we can personalize how we communicate with each person."}],"resultDescription":"Returns a poll token (call_id or similar) that the agent can use to asynchronously retrieve the result indicating whether the queried phone number has iMessage and/or FaceTime active. The actual status (enabled/disabled for each service) is retrieved by polling the companion Status endpoint with SIWX authentication.","failureModes":["Invalid or malformed phone number returns an error response","Payment failure via x402 prevents the lookup from being initiated","Rate limiting or quota exceeded for the wallet","Phone number not found or unrecognized format","Polling token expires before status is retrieved","SIWX authentication failure when polling status"],"whenToPreferThis":"Use this endpoint when you need to determine Apple iMessage or FaceTime capability for a specific phone number before initiating communication or enriching contact records. Prefer this over generic carrier lookup APIs when the specific question is Apple ecosystem reachability. Best when building workflows that route messages differently depending on iMessage availability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:06.353Z","isFirstParty":false}