Get display preferences
Returns how dates, times and the calendar are shown: time format, week start, default view and event length.
GET
/v1/mail/settings
Permission
The key must be granted mail.settings.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Always returns a complete document: stored values overlaid on defaults, so there is no empty state to handle and no 404 for a mailbox that has never changed anything.
Request
curl https://api.veruapis.com/v1/mail/settings \
-H "Authorization: Bearer vak_live_..."Response
| Field | Type | Description |
|---|---|---|
time_format |
string |
auto follows the browser or client.
auto1224
|
date_format |
string |
autodmymdyymd
|
timezone |
string | An IANA name such as Europe/Vilnius. Empty means the client decides. |
week_start |
integer | 0 is Sunday through 6 is Saturday. |
default_view |
string |
dayweekmonthagenda
|
default_event_minutes |
integer | How long a new event is when no end is given. |
speedy_meetings |
boolean | Ends events a few minutes early so back-to-back meetings have a gap. |
default_reminder_minutes |
integer | Minutes before an event to remind. 0 means at the start. |
{
"data": { ... },
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}A worked example for this endpoint has not been written yet.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Create a draft
- POST Create a mail filter
- POST Create a mail folder
- DELETE Delete a draft
- DELETE Delete a mail filter
- DELETE Delete a mail folder
- DELETE Delete a message
- GET Download an attachment
- GET Get a message
- GET List attachments
- GET List drafts
- GET List mail filters
- GET List mail folders
- GET List messages
- POST Move messages
- PUT Replace a draft
- POST Send an email
- POST Change flags and labels
- PATCH Rename a mail folder
- PATCH Update display preferences