Fathom AnalyticsAPI

Command Palette

Search for a command to run...

v1

Account

Information about the account and token behind your API key.

Get account#

GEThttps://api.usefathom.com/v1/account

Permissions: Requires a token with full account access (the * scope).

Retrieve information about the account that owns the API key.

Returns

An account object.

GET
curl "https://api.usefathom.com/v1/account" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Response
{
    "id": 500302232,
    "object": "account",
    "name": "Homer Simpson",
    "email": "homer@simpsonsfamily.doh"
}

Get token#

GEThttps://api.usefathom.com/v1/token

Permissions: Any valid API token.

Retrieve metadata about the API token used to make the request, including its name, permissions (abilities), token-format version and timestamps. Your secret token value is never returned.

Returns

A token object.

GET
curl "https://api.usefathom.com/v1/token" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Response
{
    "name": "Production server",
    "version": 4,
    "abilities": [
        "*"
    ],
    "last_used_at": "2024-01-15 09:24:00",
    "expires_at": null,
    "created_at": "2024-01-01 12:00:00",
    "updated_at": "2024-01-15 09:24:00"
}