Skip to main content
The TurboFiles API follows the JSON:API specification and requires HTTPS for all requests.

​
Requirements

All requests must be sent to https://api.turbofiles.io using HTTPS. Any HTTP requests will be rejected. Authenticated endpoints require valid API credentials, and all requests must include these JSON:API headers: 
Accept: application/vnd.api+json
Content-Type: application/vnd.api+json

​
Authentication

TurboFiles uses API keys for request authentication. You can manage your keys through the TurboFiles dashboard.
Keep your API keys secure - never expose them in public repositories or client-side code.
Here’s an example authenticated request: 
curl "https://api.turbofiles.io/v1/users/me" \
  -H 'Accept: application/vnd.api+json'  \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer {api_key}'

​
Pagination

TurboFiles uses cursor-based pagination for all list endpoints. Each paginated response includes a links object containing URL-encoded navigation paths: 
{
  "links": {
    "next": "https://api.turbofiles.io/v1/files?page%5Bafter%5D=2024-11-22T16%3A20%3A28.048315893Z",
    "prev": "https://api.turbofiles.io/v1/files?page%5Bbefore%5D=2024-11-22T16%3A19%3A28.048315893Z"
  }
}
Navigate through results using the links.next URL. Each response also includes pagination metadata: 
{
  "meta": {
    "rangeTruncated": true
  }
}
You can customize pagination using two parameters:
  • page[size]: Number of results per page (default: 10, range: 1-100)
  • page[after]: Cursor for fetching results after this point
  • page[before]: Cursor for fetching results before this point