# Appointment Management

Retrieve and reserve appointments for installing a service at a given address.

This follows the concepts in TMF646 - Appointment API.


## Return available appointment slots for a given service and address.

 - [GET /available-appointments](https://docs.thefibrecafe.net/openapi/prod/supplier-api/gen/appointment-management/handleappointmentavailability.md): This endpoint is called to find what appointments a supplier has available
to install service(s) at a given address.

An address query parameter will be supplied specifying address ID and type along
with the required serviceSpecification(s) as returned by the /service-availability
endpoint.

All parameters are mandatory and will always be supplied by the Fibre Cafe.

## Reserve an appointment slot.

 - [POST /appointments](https://docs.thefibrecafe.net/openapi/prod/supplier-api/gen/appointment-management/handlereserveappointment.md): This endpoint is called to reserve an appointment with a supplier to install
service(s) at a given address.

This endpoint will be supplied a previously returned available appointment
slot to be reserved according to the supplier reservation policy. Where the
reservation has a TTL (time to live) before being released, the expiry time
should be returned.

The returned appointment ID will be sent as part of the order at which point
it should be considered confirmed.