- Overview
- Getting Started
- OAuth 2.0 User Guide
- API Index
- Organization API
- Domains API
- postAdd domain
- getFetch all domains
- getFetch a specific domain
- putVerify domain
- putSet as primary domain
- putEnable email hosting
- putAdd domain alias
- putRemove domain alias
- PUTVerify MX record
- PUTVerify SPF record
- PUTAdd DKIM details
- PUTSet Default DKIM
- PUTRegenerate DKIM public key
- PUTVerify DKIM Public Key
- PUTDelete DKIM
- PUTEnable Subdomain stripping
- PUTDiable Subdomain stripping
- PUTAdd catch-all address
- PUTDelete catch-all address
- PUTAdd notification address
- PUTDelete notification address
- deleteDelete domain
- Groups API
- postCreate a group
- getGet all group details
- getGet a specific group details
- getGet all emails held for moderation
- getGet moderation email content
- putModerate emails in a group
- putUpdate group name
- putEnable streams for a group
- putAdd group members
- putUpdate member status
- putUpdate member role
- putUpdate member settings
- putUpdate threshold limit
- putUpdate advanced admin settings
- putAdd group email alias
- putRemove group email alias
- deleteDelete group
- Users API
- postAdd User to Organization
- getFetch All Org Users Details
- getFetch a Specific User Details
- putChange User Role
- putReset User Password
- putChange TFA Status
- putAdd Email Alias
- putRemove Email Alias
- putEnable User Account
- putDisable User Account
- Enable User
- PUTDisable User
- putChange Incoming Status
- putChange Outgoing Status
- putChange IMAP Status
- putChange POP Status
- putChange ActiveSync Status
- deleteDelete User Accounts
- Mail Policy API
- POSTCreate org policy
- POSTCreate email restriction
- POSTCreate account restriction
- POSTCreate access restriction
- POSTCreate forward restriction
- getGet all policies
- getGet all email restrictions
- getGet all account restrictions
- getGet all access restrictions
- getGet all forward restrictions
- getGet policy users
- getGet policy groups
- PUTApply policy to users/groups
- PUTAssign email restriction to policy
- PUTAssign account restriction to policy
- PUTAssign access restriction to policy
- PUTAssign forward restriction to policy
- Accounts API
- getGet all accounts of a user
- getGet a specific account details
- putUpdate display name
- putUpdate email address
- putAdd send mail details
- putUpdate display name and email address
- putUpdate mail account sequence
- putUpdate Reply To Address
- putResend verification for Reply To Address
- putAdd email forwarding
- putVerify email forwarding
- putResend verification for email forwarding
- putEnable email forwarding
- putDisable email forwarding
- putDelete copy while email forwarding
- putRemove email forwarding
- putAdd vacation reply
- putUpdate vacation reply
- putRemove vacation reply
- Folders API
- Labels API
- Email API
- postSend an email
- postSend email with attachments
- POSTUpload attachments
- postSave draft/ template
- POSTReply to an email
- getList emails
- getList emails based on search
- getGet email headers
- getGet email content
- getGet original message
- getGet email meta data
- getGet email attachment info
- GETGet email attachment content
- GETDownload inline image
- putMark email as read
- putMark email as unread
- putMove emails
- putFlag emails
- putApply labels to emails
- putRemove labels from emails
- putRemove all labels from emails
- putArchive Email
- putUnarchive Email
- putMark Emails As Spam
- putMark emails As not spam
- deleteDelete Email
- Inline Image Download API
- Signatures API
- Threads API
- Tasks API
- postAdd a new group/personal task
- postAdd a new project
- getGet all tasks in a group/personal tasks
- getGet all tasks assigned to you
- getGet all tasks created by you
- getGet a specific task
- getGet all subtasks under a task
- getGet all projects in a group
- getGet all tasks in a project
- getGet all tasks in a project with given status
- getGet all groups
- getGet all tasks in a group with given status
- getGet all members in a group
- putChange task title
- putChange task description
- putChange task priority
- putChange task status
- putChange task project
- putChange task assignee
- putSet or change task due date
- putSet or change task reminder
- putSet or change task reminder based on due date
- putSet or change recurring task
- putEdit a project under group
- deleteDelete a project
- deleteDelete a group/personal task
- Bookmarks API
- postCreate a bookmark
- postCreate a collection
- getGet all groups
- getGet all bookmarks
- getGet all favourite bookmarks
- getGet all shared bookmarks
- getGet all bookmarks in trash
- getGet all collections in group/personal
- getGet all collections in groups
- getGet all bookmarks in a collection
- getGet a bookmark
- putEdit a bookmark
- putRestore a bookmark
- putEdit a collection
- putMark as favorite
- deleteUnmark as favorite
- deleteDelete a bookmark
- deleteDelete a collection
- Notes API
- postCreate a note
- postCreate a book
- postAdd an attachment to a note
- getGet all groups
- getGet all notes
- getGet all books
- getGet all favourite notes
- getGet all shared notes
- getGet all notes in a book
- getGet all attachments in a note
- getGet a note
- getGet an attachment in a note
- putEdit a note
- putEdit a book
- putMark a note as favorite
- deleteUnmark a note as favorite
- deleteDelete attachment in a note
- deleteDelete a book
- deleteDelete a note
- Logs API
- Developer Space SDK
- Get compose details
- On compose open event
- On draft save event
- Get mail details
- Compose mail
- Get contact details
- Attachments
- Responding to mail
- Email Relation data
- Application Parameters
- Application data
- Drop for app
- Invoke URL
- On mail preview event
- On mail settings change event
- On app visibility event
- On mail close event
- On drag or drop event
- Response codes
GET - Get a Specific Account Details
Purpose
This API is used to retrieve details of a specific account.
OAuth Scope
Use the scope
ZohoMail.accounts.ALL (or) ZohoMail.accounts.READ
to generate the Authtoken.
ALL - Grants full access to accounts.
READ - Grants access to read account information.
Request URL
Method: GET
https://mail.zoho.com/api/accounts/{accountId}
Path Parameters
- accountId* long
- This parameter is used to identify the account whose details are retrieved.
- This parameter can be retrieved from the Get User Account Details API.
* - Mandatory parameter
Response Codes
Refer here for the response codes and their meaning.
Sample Request
Copiedcurl "https://mail.zoho.com/api/accounts/2560636000000008002" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"
Sample Response
Copied {
"status": {
"code": 200,
"description": "success"
},
"data": {
"country": "us",
"lastLogin": 1708054510447,
"mxStatus": true,
"activeSyncEnabled": false,
"mobileNumber": "",
"incomingBlocked": false,
"language": "en",
"type": "ZOHO_ACCOUNT",
"extraStorage": {},
"incomingUserName": "rebecca@zylker.com",
"emailAddress": [
{
"isAlias": false,
"isPrimary": true,
"mailId": "rebecca@zylker.com",
"isConfirmed": true
}
],
"mailboxStatus": "enabled",
"popBlocked": false,
"usedStorage": 143295,
"spamcheckEnabled": true,
"imapAccessEnabled": true,
"timeZone": "America/Los_Angeles",
"accountCreationTime": 1682488069407,
"zuid": 809451734,
"webBlocked": false,
"planStorage": 100,
"firstName": "rebecca",
"accountId": "2560636000000008002",
"sequence": 1,
"mailboxAddress": "rebecca@zylker.com",
"lastPasswordReset": 1682488070541,
"tfaEnabled": false,
"phoneNumer": "",
"status": true,
"lastName": "training",
"accountDisplayName": "rebecca_training",
"role": "member",
"gender": "NOT_SPECIFIED",
"accountName": "zylker",
"displayName": "rebecca training",
"isLogoExist": false,
"URI": "https://mail.zoho.com/api/accounts/2560636000000008002",
"primaryEmailAddress": "rebecca@zylker.com",
"enabled": true,
"mailboxCreationTime": 1682488072077,
"basicStorage": "professional",
"lastClient": "WEB_ZM",
"allowedStorage": 104857600,
"sendMailDetails": [
{
"sendMailId": "2560636000000008004",
"displayName": "rebecca training",
"serverName": "smtpout.mail.zoho.com",
"signatureId": "null",
"serverPort": 25,
"userName": "rebecca@zylker.com",
"connectionType": "plain",
"mode": "mailbox",
"validated": false,
"fromAddress": "rebecca@zylker.com",
"smtpConnection": 0,
"validationRequired": true,
"validationState": 0,
"status": true
},
{
"sendMailId": "2560636000000082001",
"verifyCode": 200193088841352729,
"displayName": "rebeccatraining",
"serverName": "smtpout.mail.zoho.com",
"signatureId": "null",
"serverPort": 25,
"userName": "rebecca@zylker.com",
"connectionType": "plain",
"mode": "extfrom",
"validated": false,
"fromAddress": "rebecca@zylkertraining.com",
"smtpConnection": 0,
"validationRequired": true,
"validationState": 0,
"status": false
},
{
"sendMailId": "2560636000000143001",
"verifyCode": 5686021185181369376,
"displayName": "ckrbjr nb",
"serverName": "smtpout.mail.zoho.com",
"signatureId": "null",
"serverPort": 25,
"userName": "rebecca@zylker.com",
"connectionType": "plain",
"mode": "extfrom",
"validated": false,
"fromAddress": "p3487260@gmail.com",
"smtpConnection": 0,
"validationRequired": true,
"validationState": 0,
"status": false
}
],
"popFetchTime": -1,
"address": {
"country": "",
"streetAddr": "",
"city": "",
"postalCode": "",
"state": ""
},
"planType": 82,
"userExpiry": -1,
"popAccessEnabled": true,
"imapBlocked": false,
"iamUserRole": "member",
"outgoingBlocked": false,
"policyId": {
"1082700000003462021": "home POLICY1.",
"zoid": 3226386
},
"smtpStatus": true,
"extraEDiscoveryStorage": {}
}
}
Show full
Show less
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.