Integrate HGS violation checks into your system
Add plates, check toll debt status, and receive webhook notifications when new violations appear.
curl https://api.hgsborcsorgulama.com/v1/vehicles \ -H "Authorization: Bearer <api-token>"{ "data": [ { "id": "01JA6TFKMZVQHPWXN3YBD8C9E2", "plate_number": "BKD9357", "formatted_plate_number": "BKD 9357", "total_due_amount": 640, "query_in_progress": false, "last_queried_at": "2026-04-16T08:24:13.000000Z", "created_at": "2025-04-12T11:02:47.000000Z" } ]}Which systems integrate with it?
Fleet Management Software
Instead of manually checking hundreds of vehicles, let your customers manage every violation from one place with scheduled queries.
Vehicle Tracking
Add an HGS debt module to your tracking product. Keep your customers informed about every violation.
Logistics and Shipping
Receive your customers' HGS violations instantly by webhook; settle toll debts before penalties compound or collections kick in.
Accounting and ERP
Add HGS violation checks to your vehicle expense module. Let scheduled queries bring every violation into the expense report, ready to go.
Courier and Delivery
Automate HGS violation tracking for your courier and cargo fleets. Works for owner-driver and subcontractor models even when the registered owner is someone else.
Car Rental
Catch HGS violations on rented vehicles when the vehicle is returned. Speed up your customer chargeback process.
Start in three steps
-
Sign in to the panel
Sign in with your email. Users who verify their phone number earn free credits.
-
Create an API key
Define multiple keys, with optional expiration dates.
-
Finish the integration
Explore the system with the interactive docs and your API key. Receive instant notifications by webhook.
Key features
Easy Start
Start free with bonus credits. No application, paperwork, commitment, or sales call.
Query by plate only
Unlike other providers, no HGS tag ownership or bank customer relationship required.
Scheduled queries
Turn on daily or weekly scheduled queries and get notified by webhook on every detection.
Frequently asked questions
How much does one query cost?
Every successfully completed new violation query costs 1 (one) credit. Listing plates, vehicle details, and query status requests are free. Credit pricing varies by pack. See the pricing page for details. New accounts get free starter credits.
What counts as a successful query?
The query request is accepted with HTTP 202 and processed in the background. If the source system errors out, queries retry automatically, and those retries do not affect your balance. The query is marked successful once the violation data for the plate is returned, and 1 credit is deducted from your account.
Why are queries asynchronous?
A single violation query takes roughly 10 seconds on average, and source-system slowness can extend that. A synchronous API would push the wait onto your side; the webhook model delivers the result once it is ready, so you never have to manage timeouts or half-finished requests on your end.
We cannot use webhooks. What should we do?
Your application may sit behind a firewall. Because our infrastructure is cloud-based, we cannot supply a fixed set of IP addresses; if you cannot allowlist our webhook origin in your firewall, you can track status by polling the vehicle detail endpoint at regular intervals after each query.
If you can expose your webhook URL publicly, you can verify the source by validating the HMAC-SHA256 signature on every request.
For more detail, see the API documentation.
Can I query on behalf of my customers?
Yes. A single API key can add and query unlimited plates on behalf of your customers. Vehicle management and credit balance stay on the integration side — your end users do not need their own accounts.
Does the service stop if my credits run out?
No. Auto credit top-up loads credits automatically whenever your balance drops below the threshold you set. Use this to guarantee uninterrupted queries on live integrations.
Can foreign plates be queried?
Yes. Every plate that has triggered an HGS violation in Turkey can be queried, including foreign plates. Plate format is normalised automatically.
Ready to integrate?
Create an API key and run your first query in minutes.