# agentOS API V3, Diary Call Group API

> agentOS API V3, Diary Call Group API on Apizie: 13 endpoints (Get a list of all available allocations for a date + 7 days for a specified appointment type, Get an appointment by ID, Post an appointment into a valid diary allocation, Update an existing appointment using its unique identifier, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:letmc-diary/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:letmc-diary`
- Category: E-commerce
- Status: byok
- Source: https://letmc.com
- Page: https://apizie.tech/api/ecommerce/letmc-diary
- OpenAPI: https://apizie.tech/api/ecommerce/letmc-diary/openapi.json



## Endpoints

### Get a list of all available allocations for a date + 7 days for a specified appointment type
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-allocations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| preferredDate | string | yes | The date to search from |
| appointmentType | string | yes | The unique appointment type identifier |
| lettings | boolean | no | Sales or Lettings property? |
| propertyIdentifier | string | no | The unique property identifier (Sales or Lettings) determines branch and property type |
| branchID | string | no | Branch ID to check appointments (required if no property submitted) |

### Get an appointment by ID
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-appointment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | Company short name |
| appointmentID | string | yes | Appointment ID |

### Post an appointment into a valid diary allocation
`POST https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-post-appointment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| propertyIdentifier | array | yes | The unique property identifier (Sales or Lettings) |
| lettings | boolean | no | Sales or Lettings property? |
| body | object | yes | JSON request body |

### Update an existing appointment using its unique identifier
`POST https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-put-appointment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| appointmentID | string | yes | The unique appointment id |
| lettings | boolean | no | Sales or Lettings property? |
| AllowMarketingCorrespondence | boolean | no | Sales or Lettings property? |
| body | object | yes | JSON request body |

### Delete an existing appointment using its unique identifier
`POST https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-delete-appointment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| appointmentID | string | yes | The unique appointment id |

### Submit appointment feedback
`POST https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-add-feedback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| body | object | yes | JSON request body |

### Cancel an existing appointment using its unique identifier
`POST https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-cancel-appointment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| appointmentID | string | yes | The unique appointment id |

### A collection of diary appointments linked to a company filtered between specific dates and by appointment type
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-appointments-between-dates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| branchID | string | yes | The unique ID of the Branch |
| startDate | string | yes | The search from date |
| endDate | string | yes | The search to date |
| appointmentTypesToSearch | array | yes | The appointment IDs to search for |
| offset | integer | yes | The index of the first item to return |
| count | integer | yes | The maximum number of items to return (up to 1000 per request) |

### A collection of all diary appointment types
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-appointment-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| offset | integer | yes | The index of the first item to return |
| count | integer | yes | The maximum number of items to return (up to 1000 per request) |

### All branches defined for a company
`GET https://apizie.tech/v1/ecommerce:letmc-diary/company-controller-get-branches` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| offset | integer | yes | The index of the first item to return |
| count | integer | yes | The maximum number of items to return (up to 1000 per request) |

### Get a specific branch given its unique Object ID (OID)
`GET https://apizie.tech/v1/ecommerce:letmc-diary/get-v3-diary-short-name-company-branches-branch-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| branchID | string | yes | The unique ID of the Branch |

### Retrieves all recurring appointments:-
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-recurring-appointments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortName | string | yes | The unique client short-name |
| branchID | string | yes | The unique ID of the Branch |
| appointmentTypesToSearch | array | yes | The appointment IDs to search for |
| offset | integer | yes | The index of the first item to return |
| count | integer | yes | The maximum number of items to return (up to 1000 per request) |

### Match Guest Parameters with existing applicants
`GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-search-guest` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| shortname | string | yes |  |
| branchID | string | yes |  |
| forename | string | yes |  |
| emailaddress | string | yes |  |
| surname | string | yes |  |
| offset | integer | yes |  |
| count | integer | yes |  |

## Example
```
curl "https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-allocations" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the agentOS API V3, Diary Call Group API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:letmc-diary/diary-controller-get-allocations with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the agentOS API V3, Diary Call Group API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. agentOS API V3, Diary Call Group itself also needs your own key from letmc.com.

### Can AI agents use the agentOS API V3, Diary Call Group API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:letmc-diary.

### What is the status of the agentOS API V3, Diary Call Group API?
Needs your own provider key (bring your own key)