Skip to main content
GET
Check account health

Authorizations

Authorization
string
header
required

An API key from Settings → API keys in the inDM app, sent as Authorization: Bearer indm_.... Keys belong to one workspace and carry a scope: read for GET routes and the validate dry run, full for everything. Keep keys on your server; never ship one to a browser or a mobile app.

Path Parameters

account_id
string<uuid>
required

The account id from List accounts.

Response

The account's health.

account_id
string<uuid>
required
Example:

"6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10"

username
string
required

The Instagram handle, without the @.

Example:

"maya.grows"

status
enum<string>
required

connected when everything is running. needs_reconnect when Instagram has paused the connection; nothing syncs or sends until it is reconnected in the app.

Available options:
connected,
needs_reconnect,
disconnected,
error
Example:

"connected"

live_automations
integer
required

Automations live on this account now.

Example:

2

automations_that_cannot_fire
string[]
required

Names of live automations set up in a way that can never trigger, such as one with no keywords. Empty when there are none.

Example:
send_speed_per_hour
integer
required

How many messages this account sends per hour, at most. inDM spaces sends on purpose so Instagram keeps trusting the account.

Example:

200

messages_waiting
integer
required

Messages queued for this account right now. A queue drains at send_speed_per_hour; it is not a fault.

Example:

4

messages_failed_last_24h
integer
required

Messages Instagram refused in the last 24 hours.

Example:

0

messages_failed_last_7d
integer
required

Messages Instagram refused in the last 7 days. The true total for the window instagram_errors_last_7d breaks down.

Example:

1

instagram_errors_last_7d
object
required

What Instagram refused in the last 7 days and how often, keyed by a plain-words summary of each refusal. The keys are written for people, so show them rather than branching on them. Read the total from messages_failed_last_7d. Empty when nothing was refused.

Example:
reason
string

A stable slug for why the account isn't connected. Present only when it isn't.

Example:

"token_expired"

dark_since
string<date-time>

When the account stopped working. Present only when it has.

last_inbound_received_at
string<date-time>

When inDM last heard from Instagram about a comment or message on this account. A long silence on an active account is worth a look.

Example:

"2026-11-05T08:52:40Z"