AI Integration · Gera Action Warranty
Gera Action Warranty for AI Agents
Gera Action Warranty issues signed, machine-readable service guarantee receipts for eligible Gera bookings. AI agents retrieve warranty receipts, check their validity, and initiate claims if the service was not completed to standard.
What Gera Action Warranty does
Every eligible GeraHome booking automatically generates a signed Action Warranty receipt. The receipt contains the booking ID, provider Passport ID, service type, guarantee terms, expiry date, and claim URL. If the service is not completed to standard, the warranty triggers either a replacement provider dispatch or a full refund — automatically, within the dispute window, without requiring the user to contact support.
AI agents integrated with GeraHome should retrieve and present the warranty receipt URL to the user after every completed booking. When a user reports a service issue, the agent can check warranty validity and file a claim directly through the API.
API endpoints for agents
- GET /api/v1/warranties/:booking_id — Retrieve warranty receipt for a booking
- GET /api/v1/warranties/:id/validity — Check if warranty is still claimable
- POST /api/v1/claims — Initiate a warranty claim
- GET /api/v1/claims/:id — Claim status and resolution timeline
- GET /api/v1/warranties/eligible-bookings — List user bookings with active warranties
Base URL: https://warranty.gera.services. All endpoints require user Bearer token.
Agent behaviour guidelines
- After every completed GeraHome booking, retrieve and surface the warranty receipt URL to the user.
- When a user reports a service issue, check the warranty validity before advising them on next steps.
- When filing a claim, collect the issue description and, if possible, any photo evidence from the user.
- Do not file a claim without the user's explicit instruction — claims trigger provider communications.