Skip to main content
This documentation describes Fathom’s REST API.

​
Authentication

All REST API resources are authenticated with API keys generated via the Fathom website’s settings area.

​
Rate limiting

We use several rate limiting strategies to ensure the availability of our APIs. Rate-limited calls to our APIs return a 429 status code. Calls to our APIs include headers indicating the current rate limit status.

​
Global rate limits

Authenticated requests are subject to a global limit. This is the maximum number of calls that your account can make to the API per minute. Endpoints subject to rate limits may return the headers below.
HeaderDescription
RateLimit-LimitThe maximum number of requests allowed in a time window
RateLimit-RemainingThe number of requests remaining in the current time window
RateLimit-ResetThe time remaining in the current time window
Currently, you are able to make a maximum of 60 calls to the API in a 60 second window.

​
Heavy Requests rate limits

For heavy requests, the maximum allowed number of calls is 30 in a 60 second window. During periods of elevated activity this limit may be adjusted down to 5 every 60 seconds. Heavy requests are:
  • All requests under the /recordings endpoints
  • Requests to /meetings that set include_summary or include_transcript to true

​
OAuth Rate Limits

60 requests per 60 seconds per OAuth app for the https://api.fathom.ai/external/v1/oauth2/token endpoint