Skip to main content
GET
/
v2
/
citations
List
curl --request GET \
  --url https://api.app.fleetit.com/v2/citations \
  --header 'Authorization: Bearer <token>'
{
  "count": 1270,
  "next": "http://api.app.fleetit.com/v2/citations/?limit=100&offset=100",
  "previous": null,
  "results": [
    {
      "id": 62069,
      "issuing_authority": "City of Sample",
      "notice_number": "W123456",
      "violation_number": "V12345678",
      "ticket_type": "Parking",
      "received_date": "2024-06-20",
      "ticket_date": "2024-08-15",
      "ticket_time": "11:29:00",
      "vehicle": {
        "id": 119397,
        "plate_number": "XYZ123",
        "plate_state": "TX",
        "vehicle_number": "1HGCM82633A123456",
        "vehicle_make": "TOYOTA",
        "vehicle_model": "COROLLA",
        "year": "2021",
        "lessee_renter": null,
        "custom_fields": {},
        "vehicle_type_code": "72_72",
        "active": true
      },
      "description": "Tow Away Zone",
      "issue_date": "2024-05-21",
      "fine_amount": "50.00",
      "penalty_amount": "0.00",
      "billing_status": "NO_ACTION",
      "pdf": "https://storage.googleapis.com/fleet-media-site/parking_photo_enforcement_violations/sample_violation.pdf"
    }
  ]
}

Ticket Type Field

The ticket_type field represents the category of traffic violation:
IDDisplay NameDescription
1Bus CameraBus lane violations captured by camera
2ParkingParking violations and tickets
3Red Light CameraRed light violations captured by camera
4Speed CameraSpeed violations captured by camera
5OtherOther types of traffic violations
6IdlingVehicle 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.

Headers

Fleet-Id
string

ID of the fleet to which the request is scoped.

Query Parameters

vehicle
string

Filters tickets by vehicle plate number or state. Example vehicle=ABC123 or vehicle=NY.

issuing_authority
string

Filters tickets by the name of the issuing authority. Example issuing_authority=City Police.

ticket_type
integer

Filters tickets by ticket type. Pass the numeric ID representing the type. Available options: 1 - Bus Camera, 2 - Parking, 3 - Red Light Camera, 4 - Speed Camera, 5 - Other, 6 - Idling. Example: ticket_type=2 for Parking violations.

notice_number
string

Filters tickets by notice number using partial or full match. Example notice_number=W123456.

violation_number
string

Filters tickets by violation number using partial or full match. Example violation_number=V12345678.

received_date
string<date>

Filters tickets by the date they were received. Use received_date=YYYY-MM-DD for exact match, or received_date__gte=YYYY-MM-DD and received_date__lte=YYYY-MM-DD for range.

ticket_date
string<date>

Filters tickets by the date of the ticket. Use ticket_date=YYYY-MM-DD for exact match, or ticket_date__gte=YYYY-MM-DD and ticket_date__lte=YYYY-MM-DD for range.

ticket_time
string<time>

Filters tickets by the time of the ticket. Use ticket_time=HH:MM:SS for exact match, or ticket_time__gte=HH:MM:SS and ticket_time__lte=HH:MM:SS for range.

description
string

Filters tickets by description using partial or full match. Example description=Tow Away Zone.

issue_date
string<date>

Filters tickets by the issue date. Use issue_date=YYYY-MM-DD for exact match, or issue_date__gte=YYYY-MM-DD and issue_date__lte=YYYY-MM-DD for range.

fine_amount
number

Filters tickets by the fine amount. Use fine_amount=50.00 for exact match, or fine_amount__gt=50.00, fine_amount__lt=50.00, fine_amount__gte=50.00, and fine_amount__lte=50.00 for range.

penalty_amount
number

Filters tickets by the penalty amount. Use penalty_amount=0.00 for exact match, or penalty_amount__gt=0.00, penalty_amount__lt=0.00, penalty_amount__gte=0.00, and penalty_amount__lte=0.00 for range.

ordering
string

Orders the results based on specified fields. Prefix with - for descending order. Example ordering=-ticket_date.

column
string

Selects only specific columns to be returned in the response. Separate multiple column names with a comma. Example column=id,vehicle,ticket_date.

rename_column
string

Renames specified columns in the response. Format as rename_oldName=newName. Separate multiple renamings with a comma. Example rename_vehicle=vehicle_info,rename_issuing_authority=authority.

limit
integer

Limits the number of results returned. Example limit=25.

offset
integer

Specifies the starting point within the collection of results. Example offset=0.

Response

200 - application/json

Successful response

count
integer
Example:

1270

next
string
Example:

"http://api.app.fleetit.com/v2/citations/?limit=100&offset=100"

previous
string
Example:

null

results
object[]
I