folk’s API uses versioning to ensure backward compatibility. By default, every request is made to the latest version of the API. You can specify the API version you want to use through the X-API-Version header.

{
  "X-API-Version": "2025-05-26"
}

Providing an invalid version will return a 400 Bad Request error.

It’s recommended to always specify the API version in your requests to avoid unexpected changes in the request or response format.

We strive to improve the API and add new features regularly. Every time a breaking change is introduced, a new version of the API is released. You can find the list of changes in the changelog section.