{"uid":"cap_tR2dqfRBpLW_TBo7ioYgQ","slug":"rafid-voice-appointment-api-e035eb8d","name":"Rafid Voice Appointment API","description":"Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.","url":"https://api.rafidsystem.com/api/v1/x402/voice/appointment?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"action":{"enum":["propose","book","confirm","reschedule","cancel"],"type":"string"},"safety":{"type":"object","required":["recording","transcription"],"properties":{"timezone":{"type":"string","maxLength":100},"recording":{"type":"boolean","default":false},"consentNotice":{"type":"string","maxLength":500},"transcription":{"type":"boolean","default":false}},"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","maxLength":500}},"language":{"enum":["en","ar"],"type":"string"},"timezone":{"type":"string","maxLength":100,"minLength":1},"phoneNumber":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"availableSlots":{"type":"array","items":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"default":[],"maxItems":20},"appointmentType":{"type":"string","maxLength":200,"minLength":2},"maxDurationSeconds":{"type":"integer","default":300,"maximum":3600,"minimum":1}}},"responseSchema":{"type":"json","example":{"callId":"call_example","status":"confirmed","confirmedSlot":"2026-09-28T10:00:00+04:00","customerNotes":null,"calendarEventId":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VnH6XMRBqAE3CY9zBDsZ0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Schedules, confirms, reschedules, or cancels voice-call appointments by proposing time slots and managing the booking lifecycle via phone.","exampleAgentPrompt":"Book a 10-minute property consultation voice appointment with +971501234567 in the Asia/Dubai timezone for tomorrow at 10am — use English, enable transcription, and let them know the call may be recorded for quality purposes.","exampleUseCases":[{"title":"Customer callback scheduling for sales","prompt":"Propose a 15-minute sales follow-up call with +447700900123 in Europe/London timezone — offer slots this Thursday and Friday at 2pm and 4pm in English, and book whichever they confirm."},{"title":"Medical appointment phone confirmation","prompt":"Confirm the already-proposed phone appointment for +12125550199 in America/New_York timezone — appointment type is 'GP Consultation', enable recording with a consent notice saying 'This call may be recorded for medical records', and set max duration to 20 minutes."},{"title":"Reschedule a missed recruitment interview call","prompt":"Reschedule the voice interview appointment with +971509876543 in Asia/Dubai timezone — it's a 'Technical Interview' call in English, and the new available slots are next Monday at 9am and 11am. Keep transcription on."}],"resultDescription":"Returns a JSON object with a callId identifying the booking, a status field (e.g. 'confirmed', 'proposed'), the confirmed ISO 8601 datetime slot, any customer notes captured during the interaction, and a calendarEventId if the appointment was added to a calendar system.","failureModes":["Invalid phone number format (must start with + and be 8-15 digits) returns validation error","No available slots provided for propose/book actions results in scheduling failure","Unsupported timezone string returns error","Action enum value not one of propose/book/confirm/reschedule/cancel returns bad request","Max duration exceeds 3600 seconds returns validation error","Payment failure (insufficient USDC) blocks the request","Phone unreachable or no-answer results in failed call status"],"whenToPreferThis":"Use this endpoint when an AI agent needs to manage the full lifecycle of a voice-call appointment — proposing slots, booking, confirming, rescheduling, or cancelling — particularly in business workflows involving property, recruitment, finance, or customer service. It is especially suited when you need built-in safety controls like recording consent and transcription toggling, multilingual support (English and Arabic), and structured calendar output. Prefer this over generic calendar APIs when the appointment must be conducted and confirmed via a phone call rather than a digital-only booking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:40:31.396Z","isFirstParty":false,"canonicalSlug":"rafid-voice-appointment-api-e035eb8d"}