KEYSTONE API Standard
  1. Driver
KEYSTONE API Standard
  • Overview
  • Data Schema
    • Diagram
    • Transport Operation
    • Vehicle
    • Driver
    • Organization
  • Paths
    • Transport Operation
      • Create new transport operation data
      • Get all transport operation data
      • Get a specific transport operation data by ID
      • Update data for a specific transport operation by ID
      • Delete specific transport operation data by ID
      • Get schedule data related to a specific transport operation by ID
      • Update schedule data for a specific transport operation by ID
      • Get all phase data related to a specific transport operation by ID
      • Append phase data for a specific transport operation by ID
      • Get specific phase data by transport operation ID and phase ID
      • Update specific phase data by transport operation ID and phase ID
      • Get all international consignment notes related to a specific transport operation by ID
      • Append international consignment notes data for a specific transport operation by ID
      • Get specific international consignment notes data by transport operation ID and reference code
      • Update specific international consignment notes data by transport operation ID and reference code
      • Delete specific international consignment notes data by transport operation ID and reference code
      • Get ongoing transport operation data by country code and license plate number
      • Get details about the schedule of the ongoing transport operation by country code and license plate number
      • Get details about all the phases of the ongoing transport operation by country code and license plate number
      • Get specific phase data related to the ongoing transport operation by country code, license plate number, and phase ID
      • Get all international consignment notes related to the ongoing transport operation by country code and license plate number
      • Get specific international consignment notes data related to the ongoing transport operation by country code, license plate number, and reference code
      • Get all locations related to transport operations
      • Get all locations related to transport operations by location mode
      • Create a new eCMR
      • Get a specific eCMR by ID
      • Update an eCMR by ID
      • Delete an eCMR by ID
    • Vehicle
      • Create new vehicle data
      • Get all vehicle data
      • Get vehicle data by country code and license plate number
      • Update vehicle data by country code and license plate number
      • Delete specific vehicle data by country code and license plate number
      • Get details about the geolocation of vehicle by country code and license plate number
      • Append new vehicle's geolocation data by country code and license plate number
      • Get details about the owner of vehicle by country code and license plate number
      • Get details about the insurances of vehicle by country code and license plate number
      • Get details about the insurance of vehicle by country code, license plate number and insurance id
      • Get details about the revisions of vehicle by country code and license plate number
      • Get details about the revision of vehicle by country code, license plate number and revision id
    • Driver
      • Create new driver data
        POST
      • Get all driver data
        GET
      • Get driver data by country code and vat number
        GET
      • Update driver data by country code and vat number
        PUT
      • Delete specific driver data
        DELETE
      • Get details about the driver's license by country code and vat number
        GET
      • Get details about the driver's traffic violations by country code and vat number
        GET
      • Get specific driver's traffic violation data by country code, vat number and traffic violation id
        GET
      • Get details about the driver's tachograph cards data by country code and vat number
        GET
      • Get specific driver's tachograph card data by country code, vat number and tachograph card id
        GET
    • Organization
      • Create new organization data
      • Get all organization data
      • Get organization data by organization ID
      • Update organization data by organization ID
      • Delete specific organization data by organization ID
  • Schemas
    • Schemas
      • TransportOperation
      • Organization
      • Document
      • OrganizationType
      • Location
      • Coordinates
      • Mode
      • Load
      • Phases
      • Component
      • Status
      • Phase
      • Vehicle
      • Schedule
      • State
      • Geolocation
      • Owner
      • Insurance
      • Revision
      • Driver
      • Licence
      • Category
      • TrafficViolation
      • License
      • TachographCard
      • DrivingInterval
      • e-CMRRequest
      • CarrierContactInformation
      • ExceededTimeLimits
      • Shipping
      • CarrierCountryCode
      • Payload
      • Player
      • PhaseUpdate
      • CarrierInformation
      • CarriersReservationsAndObservationsOnTakingOverTheGoods
      • ConsignorSender
      • CashOnDelivery
      • Seller
      • ConsigneeContactInformation
      • Consignee
      • ConsigneeCountryCode
      • Carrier
      • ConsigneeInformation
      • FreightForwarder
      • OtherUsedTransportEquipment
      • CustomCharge
      • EcmrEquipmentCategory
      • DeliveryOfTheGoods
      • ShippingMandate
      • DocumentsHandedToCarrier
      • Established
      • ContractualCarrierAcceptanceLocation
      • ContractualConsigneeReceiptLocation
      • GoodsReceived
      • GrossWeightInKg
      • EcmrDocument
      • Item
      • IncludedConsignmentItems
      • LogisticsShippingMarksCustomBarcode
      • TransportDetails
      • MarksAndNos
      • HashcodeDetails
      • MethodOfPacking
      • eCMRID
      • MultiConsigneeShipment
      • PostalAddress
      • NatureOfTheGoods
      • User
      • Signature
      • NonContractualPartReservedForTheCarrier
      • Plate
      • NumberOfPackages
      • TransportPackage
      • OtherUsefulParticulars
      • ReferenceIdentificationNumber
      • GeographicalCoordinates
      • e-CMRResponse
      • SenderContactInformation
      • EcmrCarrierUpdate
      • SenderCountryCode
      • EcmrCarrierUpdateShipping
      • SenderInformation
      • SendersInstructions
      • EcmrCarrierUpdateLeg
      • EcmrCarrierUpdateAcceptanceLocation
      • SpecialAgreementsSenderCarrier
      • EcmrExtended
      • EcmrManagement
      • SuccessiveCarrierContactInformation
      • SuccessiveCarrierCountryCode
      • SuccessiveCarrierInformation
      • TakingOverTheGoods
      • ToBePaidBy
      • VolumeInM3
      • EcmrConsignment
      • EcmrModel
  1. Driver

Create new driver data

POST
https://api.company-server/v2/drivers/

Request

Body Params application/jsonRequired

Example
{
    "id": 1515665415,
    "firstName": "John",
    "lastName": "Doe",
    "countryCode": "IT",
    "vat": "IT0011228901",
    "license": {
        "id": "IT1234567890",
        "countryCode": "IT",
        "category": [
            {
                "type": "C",
                "issueDate": "2020-01-01",
                "expiryDate": "2025-12-31",
                "status": "VALID",
                "code95": "95 (13.02.25)"
            }
        ]
    },
    "trafficViolation": [
        {
            "id": 9998871454,
            "code": "SV-123",
            "countryCode": "IT",
            "fine": 150,
            "paymentDueDate": "2023-07-15",
            "paymentDate": "2023-07-10",
            "isPaid": true,
            "validityPoints": 1
        }
    ],
    "tachographCard": [
        {
            "id": "IT1234567890123456",
            "drivingInterval": [
                {
                    "startDateTime": "2023-06-20T08:00:00Z",
                    "endDateTime": "2023-06-20T18:00:00Z",
                    "etl": [
                        {
                            "type": "Daily driving limit",
                            "hours": 1,
                            "minutes": 30,
                            "seconds": 0
                        }
                    ]
                }
            ]
        }
    ]
}

Responses

🟢201Created
application/json
Driver data created successfully
Body

Example
{
    "id": 1515665415,
    "firstName": "John",
    "lastName": "Doe",
    "countryCode": "IT",
    "vat": "IT0011228901",
    "license": {
        "id": "IT1234567890",
        "countryCode": "IT",
        "category": [
            {
                "type": "C",
                "issueDate": "2020-01-01",
                "expiryDate": "2025-12-31",
                "status": "VALID",
                "code95": "95 (13.02.25)"
            }
        ]
    },
    "trafficViolation": [
        {
            "id": 9998871454,
            "code": "SV-123",
            "countryCode": "IT",
            "fine": 150,
            "paymentDueDate": "2023-07-15",
            "paymentDate": "2023-07-10",
            "isPaid": true,
            "validityPoints": 1
        }
    ],
    "tachographCard": [
        {
            "id": "IT1234567890123456",
            "drivingInterval": [
                {
                    "startDateTime": "2023-06-20T08:00:00Z",
                    "endDateTime": "2023-06-20T18:00:00Z",
                    "etl": [
                        {
                            "type": "Daily driving limit",
                            "hours": 1,
                            "minutes": 30,
                            "seconds": 0
                        }
                    ]
                }
            ]
        }
    ]
}
🟠400Bad Request
🔴500Internal Server Error
Previous
Driver
Next
Get all driver data
Built with