---
title: "Check Credential Health"
method: GET
path: "/v2/credentials/{credential_id}/health"
tags: ["Credentials v2"]
---

# Check Credential Health

`GET /v2/credentials/{credential_id}/health`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/credentials/{credential_id}/health`
- Auth: HTTP bearer

Check if a credential's access token is still valid by making
a lightweight API call to the platform. Refreshes first where the
platform has a refresher and the stored token is stale.

Same check as POST /{id}/revalidate, kept for the callers of this shape.
It no longer marks a credential dead because a platform had no probe,
and no longer refuses a credential that is already flagged.

Returns:
    status: "healthy" | "refreshed" | "needs_reauth" | "unknown"
    platform, account_name, detail

"unknown" is the third outcome: the platform could not be asked and
nothing was changed.

## Path parameters

- `credential_id` string, required

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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