APIHub
Back to Explore

agentOS API V3, Diary Call Group

The agentOS API V3 Diary Call Group lets a client retrieve available appointment allocations and manage diary appointments—creating, reading, updating, deleting, canceling, and submitting feedback—while also providing endpoints to list appointment types, company branches, and retrieve appointments filtered by date range and type.

Shopping
apiKeyHeader
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

1676ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/v3/diary/{shortName}/allocations

Get a list of all available allocations for a date + 7 days for a specified appointment type

  • shortName (path, required) — The unique client short-name
  • preferredDate (query, required) — The date to search from
  • appointmentType (query, required) — The unique appointment type identifier
  • lettings (query) — Sales or Lettings property?
  • propertyIdentifier (query) — The unique property identifier (Sales or Lettings) determines branch and property type
  • branchID (query) — Branch ID to check appointments (required if no property submitted)
DELETE

/v3/diary/{shortName}/appointment

Delete an existing appointment using its unique identifier

  • shortName (path, required) — The unique client short-name
  • appointmentID (query, required) — The unique appointment id
GET

/v3/diary/{shortName}/appointment

Get an appointment by ID

  • shortName (path, required) — Company short name
  • appointmentID (query, required) — Appointment ID
POST

/v3/diary/{shortName}/appointment

Post an appointment into a valid diary allocation

  • shortName (path, required) — The unique client short-name
  • propertyIdentifier (query, required) — The unique property identifier (Sales or Lettings)
  • lettings (query) — Sales or Lettings property?
PUT

/v3/diary/{shortName}/appointment

Update an existing appointment using its unique identifier

  • shortName (path, required) — The unique client short-name
  • appointmentID (query, required) — The unique appointment id
  • lettings (query) — Sales or Lettings property?
  • AllowMarketingCorrespondence (query) — Sales or Lettings property?
POST

/v3/diary/{shortName}/appointment/feedback

Submit appointment feedback

  • shortName (path, required) — The unique client short-name
PATCH

/v3/diary/{shortName}/appointment/{appointmentID}/cancel

Cancel an existing appointment using its unique identifier

  • shortName (path, required) — The unique client short-name
  • appointmentID (path, required) — The unique appointment id
GET

/v3/diary/{shortName}/appointmentsbetweendates

A collection of diary appointments linked to a company filtered between specific dates and by appointment type

  • shortName (path, required) — The unique client short-name
  • branchID (query, required) — The unique ID of the Branch
  • startDate (query, required) — The search from date
  • endDate (query, required) — The search to date
  • appointmentTypesToSearch (query, required) — The appointment IDs to search for
  • offset (query, required, offset) — The index of the first item to return
  • count (query, required, limit) — The maximum number of items to return (up to 1000 per request)
GET

/v3/diary/{shortName}/appointmenttypes

A collection of all diary appointment types

  • shortName (path, required) — The unique client short-name
  • offset (query, required, offset) — The index of the first item to return
  • count (query, required, limit) — The maximum number of items to return (up to 1000 per request)
GET

/v3/diary/{shortName}/company/branches

All branches defined for a company

  • shortName (path, required) — The unique client short-name
  • offset (query, required, offset) — The index of the first item to return
  • count (query, required, limit) — The maximum number of items to return (up to 1000 per request)
GET

/v3/diary/{shortName}/company/branches/{branchID}

Get a specific branch given its unique Object ID (OID)

  • shortName (path, required) — The unique client short-name
  • branchID (path, required) — The unique ID of the Branch
GET

/v3/diary/{shortName}/recurringappointment

Retrieves all recurring appointments:-

  • shortName (path, required) — The unique client short-name
  • branchID (query, required) — The unique ID of the Branch
  • appointmentTypesToSearch (query, required) — The appointment IDs to search for
  • offset (query, required, offset) — The index of the first item to return
  • count (query, required, limit) — The maximum number of items to return (up to 1000 per request)
GET

/v3/diary/{shortname}/{branchID}/guest/search

Match Guest Parameters with existing applicants

  • shortname (path, required)
  • branchID (path, required)
  • forename (query, required)
  • emailaddress (query, required)
  • surname (query, required)
  • offset (query, required, offset)
  • count (query, required, limit)

13 endpoints auto-detected

Authentication

This API uses an API key, passed in the "ApiKey" header. No OAuth required.

curl -X GET \
  "https://live-api.letmc.com/v3/diary/{shortName}/allocations" \
  -H "ApiKey: YOUR_API_KEY"

live-api.letmc.com · HTTPS only