Traffic Police Fines by Driving License

Get GIBDD (traffic police) fines by driving license series and number. Returns a list of unpaid fines with payment details, amounts, dates, and discounts.

URL

Method: POST

• Production: https://registry.wallet.kvell.group/reg2/fines/driving-license

Request parameters

Name	Type	Required	Description
doc_number	string	Yes	Driving license series and number

Request example

{
  "doc_number": "9933 164103"
}

Request headers

Name	Type	Required	Description
X-Api-Key	string	Yes	Unique identifier (UUID)

Response

Response example

200: OK

{
  "data": {
    "error": {
      "errorCode": 0,
      "errorMessage": ""
    },
    "hasUnidentifiedBills": false,
    "userHasInn": true,
    "bills": [
      {
        "billId": 12345,
        "billNumber": "18810577260325072757",
        "billName": "Превышение установленной скорости движения",
        "billDate": 1742899800000,
        "isPaid": false,
        "amount": 500.0,
        "serviceCategory": {
          "code": "GIBDD",
          "name": "Штраф ГИБДД"
        },
        "addAttrs": {
          "attrs": [
            {
              "value": "9933 164103",
              "name": "driving_license",
              "title": "Водительское удостоверение"
            }
          ]
        }
      }
    ],
    "counts": {
      "total": 1,
      "amount": 500.0,
      "fine": {
        "total": 1,
        "amount": 500.0
      }
    },
    "errors": [],
    "payOptions": [],
    "payedBillIds": [],
    "unidentifiedBillIds": [],
    "fkPayments": []
  },
  "proxy_used": null,
  "proxy_enabled": false
}

Response parameters

Name	Type	Description
data	object	Response data
data.error	object	Error information
data.error.errorCode	integer	Error code
data.error.errorMessage	string	Error message
data.hasUnidentifiedBills	boolean	Whether there are unidentified decrees
data.userHasInn	boolean	Whether the document holder has an INN
data.bills	array	List of fines
data.bills[].billId	integer	Internal decree ID
data.bills[].billNumber	string	Decree number
data.bills[].billName	string	Fine name
data.bills[].billDate	integer	Decree date (timestamp in milliseconds)
data.bills[].isPaid	boolean	Whether the fine is paid
data.bills[].amount	number	Fine amount (in rubles)
data.bills[].serviceCategory	object	Fine category
data.bills[].serviceCategory.code	string	Category code
data.bills[].serviceCategory.name	string	Category name
data.bills[].addAttrs	object	Additional attributes
data.bills[].addAttrs.attrs	array	List of attributes
data.bills[].addAttrs.attrs[].value	string	Attribute value
data.bills[].addAttrs.attrs[].name	string	Attribute code
data.bills[].addAttrs.attrs[].title	string	Attribute name
data.counts	object	Totals
data.counts.total	integer	Total number of fines
data.counts.amount	number	Total fine amount (in rubles)
data.counts.fine	object	Fine statistics
data.counts.fine.total	integer	Number of unpaid fines
data.counts.fine.amount	number	Amount of unpaid fines (in rubles)
data.errors	array	List of errors by data source
data.payedBillIds	array	IDs of paid decrees
data.unidentifiedBillIds	array	IDs of unidentified decrees
proxy_used	string	Proxy used
proxy_enabled	boolean	Whether the proxy is enabled