{"uid":"cap_yd1oD_oB4ghsr1pul6t9a","slug":"odile-direct-business-phone-line-provisioning-for-ai-callers-36a63283","name":"Odile Direct: Business Phone Line Provisioning for AI Callers","description":"Resolve an opted-in business number, read its A2A agent card, and send a message or booking through Odile Direct.","url":"https://api.odilelabs.com/a2a/v1/x402/lines?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","maxLength":80},"pack":{"enum":["min40","min200"],"type":"string"},"extra":{"type":"string","maxLength":600},"hours":{"type":"object","description":"Opening hours by day name; omitted days are closed. Omit hours for Monday to Friday, 9 to 5.","additionalProperties":{"anyOf":[{"type":"object","required":["open","close"],"properties":{"open":{"type":"string","maxLength":12},"close":{"type":"string","maxLength":12}}},{"const":"closed"}]}},"country":{"enum":["US"],"type":"string"},"services":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":12},"languages":{"type":"array","items":{"enum":["es","pt","fr","tr","ru","de"],"type":"string"},"maxItems":6},"description":{"type":"string","maxLength":300},"owner_email":{"type":"string","format":"email","description":"Receives the number and forwarding codes, and signs in at https://odilelabs.com/owner."},"owner_mobile":{"type":"string","maxLength":40,"description":"The owner's own US mobile number, with area code."},"business_name":{"type":"string","maxLength":120,"minLength":1,"description":"The business name callers should hear."},"business_phone":{"type":"string","maxLength":40,"description":"The existing US business number, with area code."},"owner_confirmed_terms":{"type":"boolean","const":true,"description":"True only after showing the owner https://odilelabs.com/terms and receiving their agreement."}}},"responseSchema":{"type":"json","example":{"pack":"min40","manage":"Sign in at https://odilelabs.com/owner with owner@example.com; the number and forwarding codes are also emailed there.","status":"building","minutes":40,"setup_id":"example-setup","settlement":{"network":"eip155:8453","transaction":"0xexample"},"business_id":"example-plumbing","price_cents":1000,"business_name":"Example Plumbing"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0gMfHrzJasfzfV4QNje-r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provision a new AI-managed business phone line on Odile Direct by submitting business details, contact info, and a minute pack, paying $10 USDC via x402.","exampleAgentPrompt":"Set up an Odile Direct phone line for my plumbing business 'Rivera Plumbing' — the existing business number is 5125550182, my mobile is 5125550199, email me at owner@riveraplumbing.com, we're in Austin TX, we handle drain cleaning and pipe repair, open Monday to Saturday 8am to 6pm, and start me on the min40 pack. I've read and agreed to the terms.","exampleUseCases":[{"title":"New small business phone onboarding","prompt":"I want to get my bakery 'Sunrise Bakes' set up on Odile Direct — the business number is 3105550247, I'm at owner@sunrisebakes.com, mobile 3105550188, we're in Los Angeles CA, we do custom cakes and pastries, open Tuesday through Sunday 7am to 5pm. Start me on the min40 pack, I agree to the terms."},{"title":"Multilingual restaurant line setup","prompt":"Set up an Odile Direct line for 'Casa Verde Restaurant' — business number 7185550341, owner email manager@casaverde.com, mobile 7185550212, located in New York City NY. We serve traditional Mexican cuisine, open daily 11am to 10pm, and we need Spanish and French support. Get the min200 pack since we're busy. I've agreed to the terms."},{"title":"Professional services firm with custom hours","prompt":"Provision an Odile Direct AI phone line for my law firm 'Chen & Associates' — existing number 4155550090, email at admin@chenlaw.com, mobile 4155550055, San Francisco CA. We do immigration and contract law, available Monday to Thursday 9am to 7pm and Friday 9am to 3pm, closed weekends. Go with the min40 pack for now. Owner has agreed to the Odile Labs terms."}],"resultDescription":"Returns a JSON object containing the setup_id, business_id, business_name, selected minute pack, number of minutes, current status ('building'), a management sign-in URL with the owner's email, and a settlement object with the Base network transaction hash confirming the $10 USDC payment.","failureModes":["Missing required fields (business_name, owner_email, owner_mobile, business_phone, city, country, pack) returns a 4xx validation error","owner_confirmed_terms not set to true causes rejection — terms must be shown and accepted first","Invalid or non-US phone numbers or country codes cause schema validation failure","Duplicate business registration may return conflict error","Payment failure via x402 (insufficient USDC balance or wrong network) causes transaction rejection","Invalid email format causes a 422 unprocessable entity response","Services array exceeding 12 items or description over 300 characters triggers schema validation error"],"whenToPreferThis":"Use this endpoint when an agent needs to provision a brand-new AI-managed business phone line on Odile Direct and collect a minute pack. This is the creation/onboarding endpoint — use it when a business owner wants to join Odile Direct for the first time, not for sending messages or bookings to already-registered businesses. Prefer this over generic telephony APIs when the use case is specifically AI-to-agent (A2A) communication and the business needs an opted-in, structured phone presence discoverable by other AI agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:58.173Z","isFirstParty":false,"canonicalSlug":"odile-direct-business-phone-line-provisioning-for-ai-callers-36a63283"}