Amzy: AI agent access

Amzy is the customer-facing service provider. Amzy powers its estimate, scheduling and booking tools.

Appointments follow Amzy network routing. The API does not promise assignment to a particular contractor, reserve a slot, authorize payment, or guarantee an arrival interval.

Discover and use the tools

check_service_area: Validate a pickup ZIP and material profile against live Amzy coverage. Coverage does not reserve a contractor or slot.
get_business_hours: Read configured business hours; missing hours are explicitly unconfigured. Appointment windows are checked separately.
get_service_information: Read the service provider, contact information, configured service areas, and enabled capabilities.
get_estimate: Continue the existing Amzy estimator using pickup ZIP and junk items. Follow-up questions may be required. Estimates are approximate.
check_availability: Read live appointment options for an existing quoted conversation and date. Returned options do not hold a slot.
book_junk_removal: Prepare customer details and the selected appointment in the existing booking conversation; submit only after explicit approval of its final summary. Fulfillment follows Amzy network routing; named contractor assignment is not guaranteed.

Business information

Service areas require a live ZIP check.

Hours: Not configured. Request live appointment options separately.

Booking workflow

Conversation tokens expire one hour after the initial coverage check. Replacement tokens keep that original expiry. If a token expires, start a new coverage check, obtain a fresh estimate, and prepare a new summary for customer approval.

POST a ZIP and material_profile to https://amzy.me/api/agent/check_service_area?provider=amzy.
Keep the returned conversation_token private and send it as Authorization: Bearer <token>. Retain replacement tokens on each response.
Call get_estimate with the same ZIP and junk items. Answer the estimator's follow-up questions in its message field.
Call check_availability with the quoted conversation's ZIP and requested ISO date.
Call book_junk_removal with customer details, items, selected time and customer_approved: false. Continue until ready_for_confirmation: true.
Show the returned final summary to the customer. Only after explicit approval, resend identical booking fields with customer_approved: true and the new token. Check the backend booking result.

A2A 1.0

POST JSON-RPC SendMessage to https://amzy.me/api/a2a with A2A-Version: 1.0. Use params.message.role: ROLE_USER and one parts entry containing data: {operation, ...operationFields} and mediaType: application/json. The same scoped Bearer token and confirmation rules apply.

Use the OpenAPI examples for exact inputs. Examples are illustrative and do not establish coverage or prices.