---
# System prepended metadata

title: '[80200] Get Fines Information'

---

[УКР](https://hackmd.io/q3baQG6gSpe9igShE8JHag) | ENG
![](https://i.imgur.com/ULmPUgP.jpg)
:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)

# [80200] Get Fines Information

## Usage

Request [80200] is used to get detailed information about the client's fines.


## Request

*See the description of the "Partner", "KeyAES" and "Sign" attributes in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)".*


### Data Structure

To get the fines' information in the "Data" structure, the following parameters must be sent:

1. *OR driver's license data:*

:::info
<details>
<summary>1. Data structure formation (examples are below)</summary>
<br>

~~~
{
    "LicenseSeries": "",
    "LicenseNumber": "",
    "LicenseDate": "",
    "Transaction": {
        "TransactionID": "",
        "TerminalID": "",
        "DateTime": ""
    }
}
~~~
</details>
:::


|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
|`LicenseSeries`|Yes|String|Driver's license series.|`ООО`|
|`LicenseNumber`|Yes|String|Driver's license number.|`321456`|
|`LicenseDate`|Yes|String|Driver's license issue date in the format: YYYY-MM-DD.|`2015-05-05`|
|`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.|


2. *OR passport/ID card data (one of two) and vehicle registration plate*:

:::info
<details>
<summary>2. Data structure formation (examples are below)</summary>
<br>

~~~
{
    "PassportSeries": "",
    "PassportNumber": "",
    "IDcardNumber": "",
    "RegPlate": "",
    "Transaction": {
        "TransactionID": "",
        "TerminalID": "",
        "DateTime": ""
    }
}
~~~
</details>
:::


|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
|`PassportSeries`|Yes/No|String|Passport series.|`AB`|
|`PassportNumber`|Yes/No|String|Passport number.|`165433`|
|`IDcardNumber`|Yes/No|String|ID card number - unique entry number in the register (Ukrainian, "УНЗР").| `19910824-00026`|
|`RegPlate`|Yes|String|Vehicle registration plate.|`AI1387SK`|
|`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.|


3. *OR resolution data and vehicle registration plate:*


:::info
<details>
<summary>3. Data structure formation (examples are below)</summary>
<br>

~~~
{
    "ResolutionSeries": "",
    "ResolutionNumber": "",
    "RegPlate": "",
    "Transaction": {
        "TransactionID": "",
        "TerminalID": "",
        "DateTime": ""
    }
}
~~~
</details>
:::


|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
|`ResolutionSeries`|Yes|String|Resolution series.| `AR`|
|`ResolutionNumber`|Yes|String|Resolution number.| `123456`|
|`RegPlate`|Yes|String|Vehicle registration plate.|`AI1387SK`|
|`Transaction`|Yes|Structure|Structure transmits transaction data. See section "[Transaction Structure](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#2-Data)".|See example below.|


:::success
<details>
<summary>Example of the request [80200] (driver's license data)</summary>
<br>

~~~md
{
   "Partner": {
     "PartnerToken": "72a8ddb8-9145-4a41-af1a-8c48ecaa4be1",
     "OperationType": 80200
   },
   "Data": "{\"LicenseSeries\":\"ООО\",\"LicenseNumber\":\"321456\",\"LicenseDate\":\"2015-05-05\",\"Transaction\ ":{\"TransactionID\":\"321466\",\"TerminalID\":\"1\",\"DateTime\":\"2019-02-11 13:37:17\"}}" ,
   "KeyAES": "",
   "Sign": ""
}
~~~
</details>
:::


## Response

*See the general information on the response structure formation in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)"*.

Successful response to the request [80200] contains the array of structures `Fines`, which transmits data of the requested fines:


|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
| `Department`|No | String | Police department that issued the report. |`LIVIV REGION PATROL POLICE DEPARTMENT`|
| `fab` | No | String | Crime plot (fabula). |`M06 508 SOLID LINE CROSSING OF ROAD MARKINGS 1.1`|
| `kupap` |No | String | Violated article of the Code of Administrative Offenses. |`ST.122 Part 1. Exceeding established speed limits by vehicle drivers and violations of other traffic rules`|
| `region` | No | String | Region. | `LVIVSKA`|
| `district` |No | String | District.| `BUSKY`|
| `city` |No | String | City. | `LVIV`|
| `street` |No | String | Street. | `MYRNA`|
| `roadKm` | No | String | Road kilometer, where the offense was committed. | `17`|
| `send` | No | String | Сourt, where the protocol was sent for consideration. | `Sykhiv District Court of Lviv`|
| `consider` |No | String | Person, who considered. |`Borachok M.V.`|
| `decision` |No | String | Decision. | `FINE WAS IMPOSED FOR ST. KUPAP`|
| `penalty` |No| String | Type of penalty. | `FINE`|
| `sumFine` |No | String | Sum of fine. |`255`|
| `sumPenalty` | No | String | Sum of penalty. | `255`|
| `paidPenalty` | No | String | Sum of paid penalty. |`255` |
| `licensePlate` |No | String | Vehicle license plate. |`AI1387SK`|
| `brand` |No | String | Vehicle make and model. |`KIA SOUL`|
| `pdd` | No | String | Violated article of traffic rules. |`p.8.5.1. Traffic regulations - Violation of the requirements of horizontal road markings` |
| `mark` |No | String | Marks to the protocol. |`<Marks>`|
| `drecord` |No | String | Date of database recording. |`2019-06-23T00:00:00` |
| `dsignPost` |No | String | Date of protocol signing.|`2019-06-23T00:00:00` |
| `dperpetration` |No | String | Date of offense perpetration. | `2019-06-23T00:00:00`|
| `dateDelivery` | No | String | Delivery date. |`2019-06-23T00:00:00`|
| `dsend` | No | String | Date of protocol sending. |`2019-06-23T00:00:00` |
| `decision` | No | String | Date of decision. |`2019-06-23T00:00:00`|
| `dpaid` | No | String | Payment date. |`2019-07-02T00:00:00`|
| `dcanceled` | No| String | Date of cancellation of the decision. |`2019-10-02T00:00:00`|
| `sprotocol` |No | String | Series of protocol. |`EAV`|
| `nprotocol` |No | String | Number of protocol. | `1258836`|
|`sdecree`|No | String| Series of decree. |`ASDK`|
|`ndecree`|No | String| Number of decree.| `103437587`|
| `paidinfo` |No | String | Details of fine payment. |`UA088999980333209397000026001` |
| `docId` | No | String |Unique fine identifier. |`30191745443969447370`|
| `typeFine`|No| Integer | Type of fine: </br> `1` - ordinary, </br> `2` - photo fixation, </br> `3` - parking. |`1`|
| `payStatus` | No | Integer | Fine payment status: </br> `0` - unpaid, </br> `1` - paid, </br> `2` - repaid.|`2`|


### Response Examples

:::success
<details>
<summary>Operation Successfully Completed</summary>
<br>

~~~md
{
  "Code": 200,
  "Message": "done",
  "Data": {
    "Fines": [
      {
        "CanPay": false,
        "brand": "KIA SOUL",
        "city": null,
        "consider": "Borachok M.V.",
        "dateDelivery": null,
        "dcanceled": null,
        "decision": "2019-06-23T00:00:00",
        "decision": "FINE WAS IMPOSED FOR ST. KUPAP",
        "department": "LIVIV REGION PATROL POLICE DEPARTMENT",
        "district": "BUSKY",
        "docId": "30191745443969447370",
        "dpaid": "2019-07-02T00:00:00",
        "dperpetration": "2019-06-23T00:00:00",
        "drecord": "2019-06-23T00:00:00",
        "dsend": null,
        "dsignPost": "2019-06-23T00:00:00",
        "fab": "M06 508 SOLID LINE CROSSING OF ROAD MARKINGS 1.1",
        "kupap": "ST.122 Part 1. Exceeding established speed limits by vehicle drivers and violations of other traffic rules",
        "licensePlate": "AI1387SK",
        "mark": null,
        "ndecree": null,
        "nprotocol": "1258836",
        "paidPenalty": "255",
        "paidinfo": null,
        "payStatus": 2,
        "pdd": "p.8.5.1. Traffic regulations - Violation of the requirements of horizontal road markings",
        "penalty": "FINE",
        "region": "LVIVSKA",
        "roadKm": null,
        "sdecree": null,
        "send": "NOT SENT",
        "sprotocol": "EAV",
        "status": null,
        "street": "MYRNA",
        "sumFine": "255",
        "sumPenalty": "255",
        "typeFine": 1
      }
    ],
    "OperationStatus": 10
  },
  "KeyAES": "",
  "Sign": ""
}
~~~
</details>
:::

:::success
<details>
<summary>Operation Failed</summary>
<br>

~~~md
{
   "Code": 200,
   "Message": "done",
   "Data": {
     "OperationID": 111,
     "OperationStatus": 21,
     "Reason": 3
   },
   "KeyAES": "",
   "Sign": ""
}
~~~
</details>
:::


## Related Requests
[[80001] Fines Payment by Card for Mobile Application](https://hackmd.io/fWnQXFk5T2-sYiloHg6IaQ)
[Fines Payment Form for Partner Resource](https://hackmd.io/sFCB2G7OT2eMgGx4LqOg2g)


## Reference Materials

General parameters of the XPAY system are given in the section ["Reference Materials"](https://hackmd.io/16yLv895Qo-FWTvrWWQwbg):  operation types, payment types, response codes, operation status, reasons of operation rejection, etc.


![](https://i.imgur.com/17gAyWb.png)
:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)
:arrow_left: [General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)

<details>
<summary>XPAY Support</summary>
</br>

Phone: +38 093 891 92 00
Email: info@xpay.com.ua
Telegram: @xpaysupportbot
</details>


