Fathom AnalyticsAPI

Search the API

Jump to an endpoint or topic.

Account

Information about the account and token behind your API key.

Get account#

GET/account

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#

GET/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"
}