Easypol pagoPA API
  1. Payment API
Easypol pagoPA API
  • Getting Started
  • Payment API
    • Testing Data
    • Result Codes
    • Create Vehicle
      POST
    • Create Payment URL
      POST
    • Get Receipt
      GET
  • Webhooks
    • Pagopa Payment Result
      POST
  • Schemas
    • Vehicle
    • PayableVehicleTax
    • PaidVehicleTax
    • ExternallyPaidVehicleTax
    • ExemptedVehicleTax
    • ErrorVehicleTax
    • UnknownVehicleTax
    • PayngVehicleTax
    • Inspection
  1. Payment API

Create Vehicle

POST
https://partners.easypol.io/api/v5/vehicles
Retrieves information about the vehicle’s tax (Bollo ACI), insurance, and technical specifications.
The ACI tax payment status is available for all vehicle types, while technical data and insurance information are only available for cars and motorcycles and if the feature has been enabled for your app.
If the current tax payment was made outside Easypol (for example with a different service/app or physically at an ACI office), additional details such as the amount or validity period may not be available and the payment will be marked as PAID_OUTSIDE_EP.
If status of the vehicle tax is PAYABLE, an id will be returned that can be used to create a payment URL

Dates#

Vehicle Tax#

A vehicle tax usually has a validity of 12 months. For example:
validFrom: 2025-08-31T22:00:00.000+00:00
validUntil: 2026-08-31T21:59:59.999+00:00
The owner of the vehicle usually has 1 month from validFrom to pay the tax without any additional fine or interest from ACI. This date is represented by paymentDeadline, for example:
paymentDeadline: 2025-09-30T21:59:59.999+00:00.
 
If the owner does not pay the tax before validUntil, a new period will start, and they will not be able to pay the old one with Easypol. Creating the same vehicle will display information for the new period.
The owner will have to reach out to ACI to pay unpaid previous periods.
vehicle_tax_date.png

Insurance#

The insurance paymentDeadline represents the last day for the vehicle owner to renew with their insurance company. Even if the payment has not been made yet, the vehicle is still allowed to circulate on public streets for an additional 15 days, represented by validUntil.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢200OK
application/json
OK
Body

🟠422Unprocessable Entity
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://partners.easypol.io/api/v5/vehicles' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "licencePlate": "AB125CD",
    "type": 1
}'
Response Response Example
200 - Success
{
    "type": 1,
    "licencePlate": "AB125CD",
    "tax": {
        "status": 7,
        "id": "68e7804f093a3087b2f82b3f",
        "amount": 136.62,
        "validFrom": "2025-04-30T22:00:00.000Z",
        "validUntil": "2026-04-30T21:59:59.999Z",
        "paymentDeadline": "2025-05-30T22:00:00.000Z",
        "fine": 1.04,
        "interest": 0.01,
        "fee": 2.00
    },
    "brand": "LANCIA",
    "model": "Ypsilon 2a serie ('06'-'13')",
    "setup": "Ypsilon 1.2 69 CV Elle (51 kW)",
    "logoUrl": "https://easypol.io/lancia.png",
    "cylinderCapacity": 1200,
    "fiscalHorsePower": 14,
    "horsePower": 69,
    "power": 51,
    "environmentalClass": "EURO5",
    "registrationDate": "2011-01-01T00:00:00.000Z",
    "registrationState": "ME",
    "supply": "Benzina",
    "insurance": {
        "company": "IPTIQ EMEA P&C SA",
        "contractNumber": "BLP304845681",
        "paymentDeadline": "2026-06-04T00:00:00.000Z",
        "status": 1,
        "validUntil": "2026-05-20T00:00:00.000Z"
    },
    "stolenReport": {
        "updatedAt": {
            "$date": "2025-12-02T23:00:00.000Z"
        },
        "stolen": false
    },
    "inspections": {
        "updatedAt": "2025-12-05T09:12:59.130Z",
        "nextInspectionDeadline": "1999-03-30T22:00:00.000Z",
        "history": [
            {
                "date": "2024-05-08T00:00:00.000Z",
                "status": 1,
                "kilometers": 86465
            },
            {
                "date": "2022-04-14T00:00:00.000Z",
                "status": 1,
                "kilometers": 81882
            },
            {
                "date": "2019-12-10T00:00:00.000Z",
                "status": 1,
                "kilometers": 77057
            }
        ]
    },
    "noviceDriverEligible": true
}
Modified at 2025-12-19 11:36:04
Previous
Result Codes
Next
Create Payment URL
Built with