Welcome to the Driversnote Public API. It is a GraphQL API, so you send a POST request with the exact query or mutation you need and receive only the fields you ask for.

Send requests to https://api.driversnote.com/v1/driversnote with Content-Type: application/json and your API key in the x-api-key header.

API key

You can create or rotate an API key in your Driversnote account. The API key lets you access everything the user that provisions the API key has access to.

This means that if you want to access for example reports submitted to your team, you need to make sure that the user that provisions the API key is an admin or manager on the team.

Core Resources

• Trips are mileage records. They are private to the user that tracks them.
• Reports collect trips for reimbursement or tax documentation. They are private, but can be shared externally or submitted to a team.
• Teams typically represents a group of coworkers that tracks trips in a uniform manner and submits reports to team managers.
• Locations are saved places used on trips to help determine their purpose.
• Organisations are called workplaces in the UI. Note that what is called "Organisations" in the UI is called "ParentTeams" in the API.
• Vehicles are the vehicles used for trips. Odometer readings and distance specific rates are scoped to vehicles.
• Tags help categorise trips and reports.

Request Shape

POST /v1/driversnote HTTP/1.1
Host: api.driversnote.com
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "query": "query { vehicles(first: 10) { nodes { id name } } }"
}

Examples

Categorise Trips

First, fetch the trips you want to categorise.

Request

{
  "query": "query TripsToCategorise(: ISO8601Date!, : ISO8601Date!) {
    trips(startDate: , endDate: , first: 50) {
      nodes {
        id
        startAt
        stopAt
        routeOrigin
        tripType {
          id
          name
        }
        tags {
          id
          name
        }
      }
    }
  }
  ",
  "variables": {
    "startDate": "2026-01-01",
    "endDate": "2026-01-31"
  }
}

Response

{
  "data": {
    "trips": {
      "nodes": [
        {
          "id": "trip_123",
          "startAt": "2026-01-06T08:15:00Z",
          "stopAt": "2026-01-06T08:42:00Z",
          "routeOrigin": "gps",
          "tripType": { "id": "business", "name": "Business" },
          "tags": []
        }
      ]
    }
  }
}

Then update each trip with the right trip type and tags.

Request

{
  "query": "mutation CategoriseTrip(: ID!, : ID!, : [ID!]) {
    tripUpdate(
      input: {
        id: 
        attributes: { tripTypeId: , tagIds:  }
        markAsReviewed: true
      }
    ) {
      trip {
        id
        reviewStatus
        tripType {
          id
          name
        }
        tags {
          id
          name
        }
      }
    }
  }
  ",
  "variables": {
    "id": "trip_123",
    "tripTypeId": "business",
    "tagIds": ["tag_client_visit"]
  }
}

Response

{
  "data": {
    "tripUpdate": {
      "trip": {
        "id": "trip_123",
        "reviewStatus": "done",
        "tripType": { "id": "business", "name": "Business" },
        "tags": [{ "id": "tag_client_visit", "name": "Client visit" }]
      }
    }
  }
}

Create a Report

Request

{
  "query": "mutation CreateReport(
    : ID!
    : ID!
    : ISO8601Date!
    : ISO8601Date!
  ) {
    reportCreate(
      input: {
        vehicleId: 
        organisationId: 
        startDate: 
        endDate: 
        showOdometer: false
      }
    ) {
      report {
        id
        title
        startDate
        endDate
        totalDistance
        totalAmount
        pdfUrl
        excelUrl
      }
    }
  }
  ",
  "variables": {
    "vehicleId": "vehicle_123",
    "organisationId": "organisation_123",
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "tagIds": ["tag_client_visit"]
  }
}

Response

{
  "data": {
    "reportCreate": {
      "report": {
        "id": "report_123",
        "title": "January 2026",
        "startDate": "2026-01-01",
        "endDate": "2026-01-31",
        "totalDistance": 428,
        "totalAmount": 312.44,
        "pdfUrl": "https://api.driversnote.com/...",
        "excelUrl": "https://api.driversnote.com/..."
      }
    }
  }
}

Fetch Team Reports

Request

{
  "query": "query TeamReports(
    : ID!
    : ISO8601Date!
    : ISO8601Date!
  ) {
    teamReports(
      teamId: 
      startDate: 
      endDate: 
      first: 20
    ) {
      nodes {
        id
        state
        stateLabel
        teamMember {
          id
          userName
          userEmail
        }
        report {
          id
          title
          startDate
          endDate
          totalDistance
          totalAmount
          pdfUrl
        }
      }
    }
  }
  ",
  "variables": {
    "teamId": "team_123",
    "startDate": "2026-01-01",
    "endDate": "2026-01-31"
  }
}

Response

{
  "data": {
    "teamReports": {
      "nodes": [
        {
          "id": "team_report_123",
          "state": "submitted",
          "stateLabel": "Submitted",
          "teamMember": {
            "id": "team_member_123",
            "userName": "Alex Driver",
            "userEmail": "alex@example.com"
          },
          "report": {
            "id": "report_123",
            "title": "January 2026",
            "startDate": "2026-01-01",
            "endDate": "2026-01-31",
            "totalDistance": 428,
            "totalAmount": 312.44,
            "pdfUrl": "https://api.driversnote.com/..."
          }
        }
      ]
    }
  }
}

https://api.driversnote.com/v1/driversnote