List - Fleetit

cURL

curl --request GET \
  --url https://api.example.com/v2/citations/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "issuing_authority": "<string>",
      "violation_number": "<string>",
      "ticket_type": "<string>",
      "received_date": "2023-12-25",
      "ticket_date": "2023-12-25",
      "ticket_time": "<string>",
      "vehicle": {
        "id": 123,
        "custom_fields": "<string>",
        "added_date": "2023-11-07T05:31:56Z",
        "fleet": {
          "id": 123,
          "region_details": [
            {
              "id": 123,
              "title": "<string>"
            }
          ],
          "title": "<string>",
          "is_active": true,
          "warning_threshold_per_vehicle": "<string>",
          "deactivation_threshold_per_vehicle": "<string>",
          "client": "<string>",
          "onboarding_vehicle_order": 123
        },
        "plate_number": "<string>",
        "plate_state": "<string>",
        "vehicle_number": "<string>",
        "active": true,
        "vehicle_make": "<string>",
        "vehicle_model": "<string>",
        "year": "<string>",
        "lessee_renter": "<string>",
        "vehicle_type_code": "<string>"
      },
      "description": "<string>",
      "fine_amount": "<string>",
      "billing_status_fk": {
        "id": 123,
        "value": "<string>",
        "display_text": "<string>",
        "ticket_type": "<string>",
        "fleet": 123,
        "is_system": "<string>"
      },
      "pdf": "<string>",
      "total": "<string>",
      "driver": {
        "id": 123,
        "first_name": "<string>",
        "address_line_1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "email": [
          "jsmith@example.com"
        ],
        "driver_id": "<string>",
        "last_name": "<string>",
        "address_line_2": "<string>",
        "contact_number": "<string>"
      },
      "notice_number": "<string>",
      "issue_date": "2023-12-25",
      "penalty_amount": "<string>",
      "service_fee": "<string>",
      "billing_status": "NO_ACTION",
      "pin": "<string>"
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

GET

citations

cURL

curl --request GET \
  --url https://api.example.com/v2/citations/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "issuing_authority": "<string>",
      "violation_number": "<string>",
      "ticket_type": "<string>",
      "received_date": "2023-12-25",
      "ticket_date": "2023-12-25",
      "ticket_time": "<string>",
      "vehicle": {
        "id": 123,
        "custom_fields": "<string>",
        "added_date": "2023-11-07T05:31:56Z",
        "fleet": {
          "id": 123,
          "region_details": [
            {
              "id": 123,
              "title": "<string>"
            }
          ],
          "title": "<string>",
          "is_active": true,
          "warning_threshold_per_vehicle": "<string>",
          "deactivation_threshold_per_vehicle": "<string>",
          "client": "<string>",
          "onboarding_vehicle_order": 123
        },
        "plate_number": "<string>",
        "plate_state": "<string>",
        "vehicle_number": "<string>",
        "active": true,
        "vehicle_make": "<string>",
        "vehicle_model": "<string>",
        "year": "<string>",
        "lessee_renter": "<string>",
        "vehicle_type_code": "<string>"
      },
      "description": "<string>",
      "fine_amount": "<string>",
      "billing_status_fk": {
        "id": 123,
        "value": "<string>",
        "display_text": "<string>",
        "ticket_type": "<string>",
        "fleet": 123,
        "is_system": "<string>"
      },
      "pdf": "<string>",
      "total": "<string>",
      "driver": {
        "id": 123,
        "first_name": "<string>",
        "address_line_1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "email": [
          "jsmith@example.com"
        ],
        "driver_id": "<string>",
        "last_name": "<string>",
        "address_line_2": "<string>",
        "contact_number": "<string>"
      },
      "notice_number": "<string>",
      "issue_date": "2023-12-25",
      "penalty_amount": "<string>",
      "service_fee": "<string>",
      "billing_status": "NO_ACTION",
      "pin": "<string>"
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

Ticket Type Field

The ticket_type field represents the category of traffic violation:

ID	Display Name	Description
1	Bus Camera	Bus lane violations captured by camera
2	Parking	Parking violations and tickets
3	Red Light Camera	Red light violations captured by camera
4	Speed Camera	Speed violations captured by camera
5	Other	Other types of traffic violations
6	Idling	Vehicle idling violations

Filtering by Ticket Type

Use the numeric ID when filtering:

GET /v2/citations?ticket_type=2  # Filter for Parking violations
GET /v2/citations?ticket_type=1  # Filter for Bus Camera violations

When filtering, use the numeric ID (1-6). The API response returns the display name (e.g., “Parking”, “Bus Camera”).

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

billing_status

enum<string>[]

Multiple values may be separated by commas.

Available options:

CARD_NOT_ON_FILE,

COD_SERVICE,

CREDIT_CARD_DECLINED,

DISPUTED_TOLL_OR_TICKET,

EMPLOYEE_USE_OR_FLEET_LIABLE,

EXPIRED_CREDIT_CARD,

INVOICED_NOT_PAID,

NO_ACTION,

PAID_SUCCESSFULLY,

USER_NOT_FOUND,

VALIDATION_ISSUES

billing_status_fk

integer

description__icontains

string

driver

integer

fine_amount

number

fine_amount__gt

number

fine_amount__gte

number

fine_amount__lt

number

fine_amount__lte

number

integer

issue_date

string<date>

issue_date__gte

string<date>

issue_date__lte

string<date>

issue_date__year__gt

number

issue_date__year__lt

number

issuing_authority

string[]

Multiple values may be separated by commas.

limit

integer

Number of results to return per page.

notice_number__icontains

string

offset

integer

The initial index from which to return the results.

ordering

string

Which field to use when ordering the results.

penalty_amount

number

penalty_amount__gt

number

penalty_amount__gte

number

penalty_amount__lt

number

penalty_amount__lte

number

received_date

string<date>

received_date__gte

string<date>

received_date__lte

string<date>

received_date__year__gt

number

received_date__year__lt

number

ticket_date

string<date>

ticket_date__gte

string<date>

ticket_date__lte

string<date>

ticket_date__year__gt

number

ticket_date__year__lt

number

ticket_time

string<time>

ticket_time__gt

string<time>

ticket_time__gte

string<time>

ticket_time__lt

string<time>

ticket_time__lte

string<time>

ticket_type

enum<integer>[]

Bus Camera - Bus Camera
Idling - Idling
Parking - Parking
Red Light Camera - Red Light Camera
Speed Camera - Speed Camera
Other - Other

Available options:

Bus Camera,

Idling,

Other,

Parking,

Red Light Camera,

Speed Camera

total_max

number

total_min

number

vehicle

integer[]

violation_number__icontains

string

Response

200 - application/json

count

integer

required

Example:

123

results

object[]

required

Show child attributes

string<uri> | null

Example:

"http://api.example.org/accounts/?offset=400&limit=100"

string<uri> | null

Example:

"http://api.example.org/accounts/?offset=200&limit=100"

Patch Fleet

Summary

Documentation Index

​Ticket Type Field

​Filtering by Ticket Type

Authorizations

Query Parameters

Response

Ticket Type Field

Filtering by Ticket Type