API Documentation

Integrate your systems with FireCustos using our REST API. Sync personnel data, bulk import firefighter records, and build custom integrations.

Quick Start #

Make your first API call in three steps.

1. Create an API Key

   Go to Settings → API Keys in the FireCustos admin panel and create a new API key. Copy the key — it is shown only once.

2. Make Your First Request

   Use the API key to list firefighters in your department:

   bash

   Copy

   curl -X GET https://app.firecustos.com/api/v1/firefighters \
     -H "Authorization: Bearer fc_your_api_key_here"

3. See the Response

   The API returns JSON with paginated results:

   json

   Copy

   {
     "data": {
       "items": [
         {
           "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
           "firstName": "Ivan",
           "lastName": "Horvat",
           "phoneNumber": "+385 91 234 5678",
           "email": "ivan.horvat@example.com",
           "dateOfBirth": "1990-05-15T00:00:00Z",
           "invitationStatus": null,
           "userId": null
         }
       ],
       "page": 1,
       "pageSize": 20,
       "totalCount": 1,
       "totalPages": 1,
       "hasPreviousPage": false,
       "hasNextPage": false
     },
     "totalCount": 1
   }

Base URL #

All API endpoints are served from:

https://app.firecustos.com/api/v1/

Conventions #

All request and response bodies use JSON. Set the Content-Type header to application/json for requests with a body. Dates are in ISO 8601 format (e.g. 2024-01-15T00:00:00Z). All IDs are UUIDs.