{"uid":"cap_fqYNp1qwWANBri8uStpHG","slug":"stablephone-lookup-990b137c","name":"StablePhone iMessage/FaceTime Lookup","description":"Check if a phone number has iMessage/FaceTime ($0.05 via x402). Returns a token to poll for async results.","url":"https://stablephone.dev/api/lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","pattern":"^\\+1\\d{10}$"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}},"additionalProperties":false},"example":{"request":{"phone_number":"+12025551234"},"response":{"token":"eyJhbGciOiJIUzI1NiJ9.eyJyaWQiOiI1MDY4MmNhZi1hNTg5LTQwNGYtODM2Ni05MDRkMDdhNjJkOTUiLCJwaCI6IisxMjAyNTU1MTIzNCIsInciOiIweDljYzQyZjNkOTI0NWI4NjdhY2NjZDYzMGI0M2Y5MDZjMTY2NWIxNzYiLCJpYXQiOjE3ODA4OTEyMjksImV4cCI6MTc4MDg5NDgyOX0.ZBbmtra9nrrbVtzJzQ7oDLsEsYLEVkPgoiW0gn-FPUc"}},"exampleRequest":{"phone_number":"+12025551234"},"tags":["phone","call","voice","ai-call","imessage","ai","social"],"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":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UB1gKMHrF0yzdc98-UoHs","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_wLIKBPCm9M8MNjjD9emO1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"StablePhone","brandSlug":"stablephone","brandBaseUrl":"https://stablephone.dev","brandDocsUrl":"https://stablephone.dev","whatItDoes":"Check whether a US phone number is registered for iMessage or FaceTime, returning a polling token for async results.","exampleAgentPrompt":"Can you check if +12125551234 has iMessage or FaceTime enabled?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing a single `token` string (a JWT) that the caller must use to poll the separate Status endpoint for the actual iMessage/FaceTime lookup result. The token encodes the request ID, phone number, and expiry.","failureModes":["Invalid phone number format (must be E.164 US format +1XXXXXXXXXX) returns a validation error","Payment not completed or insufficient USDC balance returns 402 Payment Required","Phone number outside US (+1) format is rejected by schema validation","Token expiry — the returned JWT has a limited validity window; polling must happen before expiry","Network timeout on async lookup if carrier or Apple registry is slow to respond"],"whenToPreferThis":"Use this endpoint when you need to determine whether a specific US phone number supports iMessage or FaceTime before deciding on a communication channel. It is the only endpoint to use for Apple messaging capability detection in the StablePhone ecosystem. Prefer this over manual outreach or SMS-fallback guesswork when building communication automation pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:30:12.289Z","isFirstParty":false,"canonicalSlug":"stablephone-lookup-990b137c"}