Quick start

Get your API key

Contact your Customer Success Manager or reach out to engineering@withforerunner.com to obtain your API key.

Make your first request

Try listing files with a simple GET request:

curl https://app.withforerunner.com/api/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY"

Sending from Postman gets you a 403 even with a valid API key, because our firewall blocks its default User-Agent. See Errors for the fix.

Explore the endpoints

Every operation is listed under Endpoints in the sidebar, with its parameters, response shape, and a request you can send from the page.

Authentication

All API requests require authentication using your API key in the Authorization header. See the Authentication page for complete details.

All API responses are returned in JSON format. List endpoints return 25 results per page and include pagination metadata.

Obtain, use, and store an API key

Headers, response format, and pagination

Set up real-time notifications

Handle errors and troubleshoot issues