Skills extract-traffic-fine-data

Name: extract-traffic-fine-data
Author: iterationlayer

Extract violation details, fine amounts, vehicle information, and payment deadlines from traffic fine notices.

install

source · Clone the upstream repo

git clone https://github.com/iterationlayer/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/iterationlayer/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/extract-traffic-fine-data" ~/.claude/skills/iterationlayer-skills-extract-traffic-fine-data && rm -rf "$T"

manifest: skills/extract-traffic-fine-data/SKILL.md

source content

Extract Traffic Fine Data

Fleet management agencies and logistics companies use this recipe to process traffic fine notices at scale — extracting violation details, amounts, and deadlines for centralized tracking and timely payment.

APIs Used

Document Extraction (1 credit per page)

Prerequisites

You need an Iteration Layer API key. Get one at platform.iterationlayer.com — free trial credits included, no credit card required.

For full integration guidance (SDKs, auth, MCP, error handling), see the Iteration Layer Integration Guide.

Implementation

curl -X POST https://api.iterationlayer.com/document-extraction/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "type": "url",
        "name": "traffic-fine-2026-0892.pdf",
        "url": "https://example.com/fines/traffic-fine-2026-0892.pdf"
      }
    ],
    "schema": {
      "fields": [
        {
          "name": "ticket_number",
          "type": "TEXT",
          "description": "Traffic ticket or fine reference number"
        },
        {
          "name": "issue_date",
          "type": "DATE",
          "description": "Date the fine was issued"
        },
        {
          "name": "violation_type",
          "type": "TEXT",
          "description": "Type of violation, e.g. speeding, parking, red light"
        },
        {
          "name": "violation_description",
          "type": "TEXT",
          "description": "Detailed description of the violation"
        },
        {
          "name": "vehicle_plate",
          "type": "TEXT",
          "description": "License plate number of the vehicle"
        },
        {
          "name": "vehicle_make_model",
          "type": "TEXT",
          "description": "Vehicle make and model"
        },
        {
          "name": "location",
          "type": "TEXT",
          "description": "Location where the violation occurred"
        },
        {
          "name": "fine_amount",
          "type": "CURRENCY_AMOUNT",
          "description": "Total fine amount"
        },
        {
          "name": "payment_due_date",
          "type": "DATE",
          "description": "Deadline for payment"
        },
        {
          "name": "penalty_points",
          "type": "INTEGER",
          "description": "Penalty or demerit points"
        },
        {
          "name": "issuing_authority",
          "type": "TEXT",
          "description": "Authority or agency that issued the fine"
        }
      ]
    }
  }'

import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.extract({
  files: [
    {
      type: "url",
      name: "traffic-fine-2026-0892.pdf",
      url: "https://example.com/fines/traffic-fine-2026-0892.pdf",
    },
  ],
  schema: {
    fields: [
      { name: "ticket_number", type: "TEXT", description: "Traffic ticket or fine reference number" },
      { name: "issue_date", type: "DATE", description: "Date the fine was issued" },
      { name: "violation_type", type: "TEXT", description: "Type of violation, e.g. speeding, parking, red light" },
      { name: "violation_description", type: "TEXT", description: "Detailed description of the violation" },
      { name: "vehicle_plate", type: "TEXT", description: "License plate number of the vehicle" },
      { name: "vehicle_make_model", type: "TEXT", description: "Vehicle make and model" },
      { name: "location", type: "TEXT", description: "Location where the violation occurred" },
      { name: "fine_amount", type: "CURRENCY_AMOUNT", description: "Total fine amount" },
      { name: "payment_due_date", type: "DATE", description: "Deadline for payment" },
      { name: "penalty_points", type: "INTEGER", description: "Penalty or demerit points" },
      { name: "issuing_authority", type: "TEXT", description: "Authority or agency that issued the fine" },
    ],
  },
});

from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.extract(
    files=[
        {
            "type": "url",
            "name": "traffic-fine-2026-0892.pdf",
            "url": "https://example.com/fines/traffic-fine-2026-0892.pdf",
        }
    ],
    schema={
        "fields": [
            {"name": "ticket_number", "type": "TEXT", "description": "Traffic ticket or fine reference number"},
            {"name": "issue_date", "type": "DATE", "description": "Date the fine was issued"},
            {"name": "violation_type", "type": "TEXT", "description": "Type of violation, e.g. speeding, parking, red light"},
            {"name": "violation_description", "type": "TEXT", "description": "Detailed description of the violation"},
            {"name": "vehicle_plate", "type": "TEXT", "description": "License plate number of the vehicle"},
            {"name": "vehicle_make_model", "type": "TEXT", "description": "Vehicle make and model"},
            {"name": "location", "type": "TEXT", "description": "Location where the violation occurred"},
            {"name": "fine_amount", "type": "CURRENCY_AMOUNT", "description": "Total fine amount"},
            {"name": "payment_due_date", "type": "DATE", "description": "Deadline for payment"},
            {"name": "penalty_points", "type": "INTEGER", "description": "Penalty or demerit points"},
            {"name": "issuing_authority", "type": "TEXT", "description": "Authority or agency that issued the fine"},
        ]
    },
)

package main

import il "github.com/iterationlayer/sdk-go"

func main() {
	client := il.NewClient("YOUR_API_KEY")

	result, err := client.Extract(il.ExtractRequest{
		Files: []il.FileInput{
			il.NewFileFromURL("traffic-fine-2026-0892.pdf", "https://example.com/fines/traffic-fine-2026-0892.pdf"),
		},
		Schema: il.ExtractionSchema{
			"ticket_number":        il.NewTextFieldConfig("ticket_number", "Traffic ticket or fine reference number"),
			"issue_date":           il.NewDateFieldConfig("issue_date", "Date the fine was issued"),
			"violation_type":       il.NewTextFieldConfig("violation_type", "Type of violation, e.g. speeding, parking, red light"),
			"violation_description": il.NewTextFieldConfig("violation_description", "Detailed description of the violation"),
			"vehicle_plate":        il.NewTextFieldConfig("vehicle_plate", "License plate number of the vehicle"),
			"vehicle_make_model":   il.NewTextFieldConfig("vehicle_make_model", "Vehicle make and model"),
			"location":             il.NewTextFieldConfig("location", "Location where the violation occurred"),
			"fine_amount":          il.NewCurrencyAmountFieldConfig("fine_amount", "Total fine amount"),
			"payment_due_date":     il.NewDateFieldConfig("payment_due_date", "Deadline for payment"),
			"penalty_points":       il.NewIntegerFieldConfig("penalty_points", "Penalty or demerit points"),
			"issuing_authority":    il.NewTextFieldConfig("issuing_authority", "Authority or agency that issued the fine"),
		},
	})
	if err != nil {
		panic(err)
	}
	_ = result
}

{
  "name": "Extract traffic fine data in Iteration Layer",
  "nodes": [
    {
      "parameters": {
        "content": "## Extract Traffic Fine Data\n\nFleet management agencies and logistics companies use this recipe to process traffic fine notices at scale — extracting violation details, amounts, and deadlines for centralized tracking and timely payment.\n\n**Note:** This workflow uses the Iteration Layer community node (`n8n-nodes-iterationlayer`). Install it via Settings > Community Nodes before importing. Self-hosted n8n only.",
        "height": 280,
        "width": 500,
        "color": 2
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        200,
        40
      ],
      "id": "f6a7b8c9-d0e1-2345-fabc-345678901201",
      "name": "Overview"
    },
    {
      "parameters": {
        "content": "### Step 1: Extract Fine Data\nResource: **Document Extraction**\n\nConfigure the Document Extraction parameters below, then connect your credentials.",
        "height": 160,
        "width": 300,
        "color": 6
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        475,
        100
      ],
      "id": "f6a7b8c9-d0e1-2345-fabc-345678901202",
      "name": "Step 1 Note"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "f6a7b8c9-d0e1-2345-fabc-345678901203",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "documentExtraction",
        "schemaInputMode": "rawJson",
        "schemaJson": "{\"fields\":[{\"name\":\"ticket_number\",\"type\":\"TEXT\",\"description\":\"Traffic ticket or fine reference number\"},{\"name\":\"issue_date\",\"type\":\"DATE\",\"description\":\"Date the fine was issued\"},{\"name\":\"violation_type\",\"type\":\"TEXT\",\"description\":\"Type of violation\"},{\"name\":\"violation_description\",\"type\":\"TEXT\",\"description\":\"Detailed description of the violation\"},{\"name\":\"vehicle_plate\",\"type\":\"TEXT\",\"description\":\"License plate number\"},{\"name\":\"vehicle_make_model\",\"type\":\"TEXT\",\"description\":\"Vehicle make and model\"},{\"name\":\"location\",\"type\":\"TEXT\",\"description\":\"Location where the violation occurred\"},{\"name\":\"fine_amount\",\"type\":\"CURRENCY_AMOUNT\",\"description\":\"Total fine amount\"},{\"name\":\"payment_due_date\",\"type\":\"DATE\",\"description\":\"Deadline for payment\"},{\"name\":\"penalty_points\",\"type\":\"INTEGER\",\"description\":\"Penalty or demerit points\"},{\"name\":\"issuing_authority\",\"type\":\"TEXT\",\"description\":\"Authority that issued the fine\"}]}",
        "files": {
          "fileValues": [
            {
              "fileInputMode": "url",
              "fileName": "traffic-fine-2026-0892.pdf",
              "fileUrl": "https://example.com/fines/traffic-fine-2026-0892.pdf"
            }
          ]
        }
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "f6a7b8c9-d0e1-2345-fabc-345678901204",
      "name": "Extract Fine Data",
      "credentials": {
        "iterationLayerApi": {
          "id": "1",
          "name": "Iteration Layer API"
        }
      }
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Extract Fine Data",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}

Extract traffic fine data from the file at [file URL]. Use the extract_document tool with these fields:

- ticket_number (TEXT): Traffic ticket or fine reference number
- issue_date (DATE): Date the fine was issued
- violation_type (TEXT): Type of violation, e.g. speeding, parking, red light
- violation_description (TEXT): Detailed description of the violation
- vehicle_plate (TEXT): License plate number of the vehicle
- vehicle_make_model (TEXT): Vehicle make and model
- location (TEXT): Location where the violation occurred
- fine_amount (CURRENCY_AMOUNT): Total fine amount
- payment_due_date (DATE): Deadline for payment
- penalty_points (INTEGER): Penalty or demerit points
- issuing_authority (TEXT): Authority or agency that issued the fine

Response

{
  "success": true,
  "data": {
    "ticket_number": {
      "value": "VIO-2026-0892",
      "confidence": 0.99,
      "citations": [
        "Ticket No: VIO-2026-0892"
      ]
    },
    "issue_date": {
      "value": "2026-03-05",
      "confidence": 0.98,
      "citations": [
        "Issued: March 5, 2026"
      ]
    },
    "violation_type": {
      "value": "Speeding",
      "confidence": 0.97,
      "citations": [
        "Violation: Speeding — exceeding posted limit"
      ]
    },
    "violation_description": {
      "value": "Vehicle recorded at 78 km/h in a 50 km/h zone by automated speed camera",
      "confidence": 0.95,
      "citations": [
        "Recorded speed: 78 km/h in 50 km/h zone (automated camera)"
      ]
    },
    "vehicle_plate": {
      "value": "MI-4421-RZ",
      "confidence": 0.99,
      "citations": [
        "Plate: MI-4421-RZ"
      ]
    },
    "vehicle_make_model": {
      "value": "Fiat Ducato 2024",
      "confidence": 0.94,
      "citations": [
        "Vehicle: Fiat Ducato, 2024"
      ]
    },
    "location": {
      "value": "Via Emilia, km 23.4, Parma",
      "confidence": 0.96,
      "citations": [
        "Location: Via Emilia, km 23.4, Parma"
      ]
    },
    "fine_amount": {
      "value": {
        "amount": "175.00",
        "currency": "EUR"
      },
      "confidence": 0.98,
      "citations": [
        "Fine: EUR 175.00"
      ]
    },
    "payment_due_date": {
      "value": "2026-04-04",
      "confidence": 0.97,
      "citations": [
        "Payment due by: April 4, 2026"
      ]
    },
    "penalty_points": {
      "value": 3,
      "confidence": 0.96,
      "citations": [
        "Points: 3"
      ]
    },
    "issuing_authority": {
      "value": "Polizia Municipale di Parma",
      "confidence": 0.98,
      "citations": [
        "Issued by: Polizia Municipale di Parma"
      ]
    }
  }
}