---
title: "Check account health"
method: GET
path: "/v1/social-accounts/{id}/health"
tags: ["Social Accounts"]
---

# Check account health

`GET /v1/social-accounts/{id}/health`

## Request

- Base URL: `https://api.outstand.so`
- URL: `https://api.outstand.so/v1/social-accounts/{id}/health`
- Auth: none declared

Checks whether the stored access token for a social account is still valid by calling the network's identity endpoint.

If the token is expired (401), one automatic refresh is attempted and the new tokens are persisted before re-checking.

**Supported networks:** X, LinkedIn, Facebook, Instagram, Threads, TikTok, YouTube, Pinterest, Bluesky, Google Business, Vimeo, Reddit

## Path parameters

- `id` string, required

## Response `200`

Health check result (may be healthy: false)

- object: Account health response
  - `success` boolean, required
  - `data` object, required: Health status of the social account
    - `id` string, required: Social account ID
    - `network` string, required: Social network name
    - `healthy` boolean, required: Whether the stored token is currently valid
    - `checkedAt` string, required: ISO timestamp of the check
    - `details` object: Identity details from the network (e.g. username, id)
    - `error` string: Error message when unhealthy
    - `errorCode` 'unauthorized' | 'forbidden' | 'rate_limited' | 'network_error' | 'unknown': Machine-readable error code when unhealthy

## Other responses

- `404`: Social account not found
- `500`: Internal server error

---

[API](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1.md) · [All operations](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/revisions/181fad55d031?raw)