---
title: "Get account"
method: GET
path: "/v1/accounts/{accountId}"
tags: ["Accounts"]
---

# Get account

`GET /v1/accounts/{accountId}`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}`
- Auth: HTTP bearer

Returns one connected account, in the same shape as an item of `GET /v1/accounts`.

The same access rules apply: a key or a team member limited to some profiles gets a 404 for an account outside them.

An account the list leaves out by default is still returned when you name it:

- one over the plan's profile limit
- one on a creator profile
- an ad account listed behind its ads login

A malformed `accountId` returns 400; an unknown account, or one you cannot access, returns 404.

## Path parameters

- `accountId` string, required

## Response `200`

The account

- object
  - `account` ListedAccount, required
    - `_id` string, required
    - `platform` 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'wix' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'redditads' | 'sms' | 'phone' | 'rcs' | 'whopads' | 'applovinads' | 'snapchatads' | 'google' | 'microsoft' | 'imap' | 'hubspot' | 'salesforce' | 'webflow' | 'googleanalytics' | 'imessage' | 'tiktokshop' | 'microsoftads' | 'line' | 'wechat' | 'googletagmanager' | 'stripe' | 'googlesearchconsole', required
    - `profileId` union, required
      - string
      - Profile
        - `_id` string
        - `userId` string
        - `name` string
        - `description` string
        - `color` string
        - `timezone` string, nullable: IANA timezone new posts on this profile use when the request names no `timezone`. Null means UTC.
        - `externalId` string, nullable: Your own identifier for this profile, set on create or update. Null when none is set.
        - `contentRetention` 'standard' | 'none': This profile's own zero content retention setting. `none` stores identifiers and metadata only for this profile. Change it with `contentRetention` on update; only the team owner can.
        - `effectiveContentRetention` 'standard' | 'none': The mode that applies to this profile: `none` when the profile or the whole team uses zero content retention.
        - `maxOutboundCallsPerHour` integer, nullable: Most outbound calls placed from this profile's numbers in any rolling hour. Null means only the team limits apply.
        - `maxDailyCallSpendUsd` number, nullable: Most billed spend, in USD, on outbound calls and calls forwarded to a phone from this profile's numbers in any rolling 24 hours. Null means only the team limits apply.
        - `maxForwardedMinutesPerDay` integer, nullable: Most minutes of inbound calls forwarded to a phone from this profile's numbers in any rolling 24 hours. Null means only the team limits apply.
        - `isDefault` boolean
        - `isOverLimit` boolean: Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
        - `accountCount` integer: In the profile list. Connected accounts on the profile, including ones that need reconnecting; phone and SMS number internals and posting accounts hidden by an ads connect are not counted.
        - `createdAt` string, date-time
    - `username` string
    - `displayName` string
    - `capabilities` EmailCapabilities: On Google, Microsoft and IMAP accounts with email access: what this mailbox provider can do, so you can branch before calling.
      - `sync` object
        - `mode` 'push' | 'poll'
        - `typicalDelaySeconds` integer
      - `sentItems` object: Outlook only: how mail sent from the user's own mail client reaches you (`message.sent`). `poll` while Microsoft will not give Zernio a Sent Items subscription for this mailbox; it switches back to `push` by itself.
        - `mode` 'push' | 'poll'
        - `typicalDelaySeconds` integer
      - `drafts` object
        - `supported` boolean
        - `clientEditsVisible` boolean: Edits the user makes in their mail client show up in the draft you read back.
        - `versioned` boolean: Drafts carry a `version` for `If-Match`.
      - `forward` object
        - `native` boolean: The provider forwards itself (Outlook's createForward); otherwise Zernio builds the forward.
        - `asAttachment` boolean
      - `sendAs` object
        - `list` 'provider' | 'partial' | 'declared': `provider`: `GET /v1/email/send-as` lists every address the provider accepts. `partial`: shared mailboxes are not listed; declare them with `POST /v1/email/send-as`.
        - `sharedMailboxes` boolean
      - `signatures` object
        - `provider` 'read' | 'none': `read`: `appendSignature` falls back to the provider signature when no Zernio default exists.
        - `zernio` boolean: Zernio-stored signatures (`/v1/email/signatures`) work on this mailbox.
      - `labels` object
        - `model` 'labels' | 'categories' | 'folders'
      - `bounces` object
        - `detection` boolean
      - `scheduledSend` object
        - `holdAsDraft` boolean
      - `tracking` boolean
    - `platformUserId` string: The account's id on its platform, as the platform reports it to Zernio. Stable across reconnects, so use it to match an account against your own records. - **Instagram Login accounts:** the app-scoped user id (the professional account id is in `metadata.instagramScopedId`). - **Instagram via Facebook Login:** the professional account id (`17841...`). - **TikTok:** the open_id of Zernio's TikTok app, which differs from the open_id any other app sees for the same user. Either value can be passed back as `expectedPlatformUserId` on GET /v1/connect/{platform}.
    - `scopeAreas` string[], nullable: The permission areas the connect requested: the `scopes` of GET /v1/connect/{platform}, or your OAuth app's areas. Null when the connect requested every area.
    - `oauthAppId` string, nullable: The id of your own OAuth app this account connected through (see /v1/connect/oauth-apps); null when it uses Zernio's app.
    - `tiktokAccountType` 'business' | 'personal' | 'unknown': TikTok accounts only. The account type TikTok reported when the account was connected. - `personal`: TikTok reported a personal account. TikTok limits Business Messaging to Business Accounts, so sends usually fail with 400 `PLATFORM_LIMITATION`; the send still goes to TikTok, which decides. The fix is switching to a Business Account in the TikTok app, then reconnecting. - `business`: the prerequisite, not a guarantee. Messaging also needs the messaging scopes granted and TikTok's regional availability. - `unknown`: accounts connected before this was captured, or whose grant left out the account-type scope.
    - `profilePicture` string, nullable: URL to the account's profile picture on the platform. May be null if the platform does not provide one.
    - `profileUrl` string: Full profile URL for the connected account on its platform.
    - `isActive` boolean, required
    - `needsReconnection` boolean: The platform definitively reported the stored OAuth token as dead. While true, GET /v1/connect/{platform}/ads returns a fresh authUrl (implicit force=true) instead of alreadyConnected, so re-running the connect flow recovers the account. Cleared automatically when the account is re-authorized.
    - `followersCount` number: Follower count (only included if user has analytics add-on)
    - `followersLastUpdated` string, date-time: Last time follower count was updated (only included if user has analytics add-on)
    - `parentAccountId` string, nullable: Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts. Meta ads business-login accounts also have no parent.
    - `enabled` boolean: Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., a posting account auto-created when the user connected ads first). - GET /v1/accounts still returns such accounts unless `excludeHidden=true` is passed. - They cannot be posted to (`ACCOUNT_NOT_ENABLED_FOR_POSTING`) and are not billed as connected accounts. - On an ads account (`metaads`, `googleads`, ...) the value does not hide the connection: ads accounts are listed whatever their `enabled` value and keep working for ads.
    - `metaAdsSyncEnabled` boolean: Facebook accounts only (absent on every other platform). Whether this Facebook account syncs the Meta ads of the ad accounts it reaches, the way a `metaads` connection does. Off by default; set it with `PUT /v1/accounts/{accountId}`. Synced active ads count on the managed ads meter like ads from a Meta Ads connection.
    - `rateLimitedUntil` string, date-time, nullable: End of the account's publishing cooldown. Compare it with the current time: a value in the past means the cooldown has ended (the field is cleared on the next successful publish); null means no cooldown since the last successful publish. **When it starts.** A post to the account fails with `errorCategory` `user_abuse` (spam, abuse or rate-limit errors), or 10 or more posts to it fail within an hour with `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. **How long.** It doubles with each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes and so on, capped at 24 hours). On a YouTube account with a recorded successful upload, it instead runs until 24 hours after that upload, or 1 hour when that upload is older than 24 hours. **Effect.** While it is in the future, POST /v1/posts (drafts excepted) and POST /v1/posts/{postId}/retry return 429 for this account. When it starts, this account's pending targets on posts scheduled before the cooldown ends are failed.
    - `metadata` object: Platform-specific metadata. Fields vary by platform. **WhatsApp accounts:** - qualityRating: phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN). - nameStatus: display name review status (APPROVED, PENDING_REVIEW, DECLINED, or NONE). A declined or pending name does not by itself block sending; sendability is reported separately via health_status (can_send_message). - messagingLimitTier: maximum unique business-initiated conversations per 24h rolling window (TIER_250, TIER_1K, TIER_10K, TIER_100K, or TIER_UNLIMITED). Scales automatically as quality rating improves. - verifiedName: Meta-verified business display name. - displayPhoneNumber: formatted phone number (e.g., "+1 555-123-4567"). - wabaId: WhatsApp Business Account ID. - phoneNumberId: Meta phone number ID. **Meta ads business-login accounts:** - tokenType: system-user. - businessId: the owning Business Manager ID when there is one owner; null for multiple owners. - businessIds: owning Business Manager IDs discovered from granted ad accounts. - grantedAdAccountIds: ad-account IDs granted to the token. - adAccountBusinesses: map from ad-account ID to its owning business ID or null. - availablePages: granted Page IDs and names. No Page tokens are exposed. - selectedPageId: the Page selected for creatives and lead forms, or null. - scopedAdAccountIds: existing sync scope preserved on reconnect. Non-expiring tokens have no tokenExpiresAt field. Parent posting reconnects do not replace this token. **LinkedIn accounts:** profileData carries profile details refreshed on each daily snapshot. - profileData.bio: the member's headline (personal accounts) or the organization description (organization accounts). null when not set. - profileData.extraData.vanityName: the member's profile slug, the /in/{vanityName} segment of profileUrl. Personal accounts only; an organization's slug is in metadata.organizationInfo.vanityName. **Instagram accounts:** - loginMethod: "facebook_login" when connected through Facebook Login; absent for Instagram Login. On facebook_login accounts, comment reads leave hidden comments out entirely instead of returning them with isHidden true. - instagramScopedId: the Instagram professional account id (`17841...`). On Instagram Login accounts it is the same whichever app connected the account, while platformUserId is app-scoped. Facebook Login accounts hold this id as platformUserId. **LINE accounts:** channelId, basicId (also in username) and webhookUrl. **WeChat accounts:** appId (also in username and platformUserId). **X (Twitter) accounts:** - profileData.extraData.isPremium: whether X reports a paid subscription (Basic, Premium, Premium+, or a blue verified badge), which raises the post length limit from 280 to 25,000 characters. Read live at connect and reconnect, refreshed by the daily follower snapshot. - Because X intermittently reports no subscription for subscribed accounts, a cancellation is stored on the fourth consecutive daily snapshot reporting it (about four days). Accounts connected before the extraData layout carry the flag at profileData.isPremium.
    - `inboundActivity` InboundActivity, nullable: When inbound messages and comments were first and last seen for the account. Only events matched to this account count. WhatsApp delivery statuses for outbound messages do not count, so the stamps of a number that only sends stay null. The stamps reset on every connect.
      - `firstMessageAt` string, date-time, nullable, required: First inbound message since the latest connect, or since tracking began for an account connected before it. Null when none yet.
      - `lastMessageAt` string, date-time, nullable, required: Latest inbound message, precise to about one hour. Null when none yet.
      - `firstCommentAt` string, date-time, nullable, required: First inbound comment since the latest connect, or since tracking began for an account connected before it. Null when none yet.
      - `lastCommentAt` string, date-time, nullable, required: Latest inbound comment, precise to about one hour. Null when none yet.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404`: Resource not found
- `503`: An upstream service or database is temporarily unavailable. Retry after the indicated delay. A timed-out write may have completed upstream; check its outcome before resubmitting.

## Changes

- **2026-11-19** `eb20b94461c8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/a8fec29e3c8e?raw)
