Create new streetlight

  • 6 minute(s) read
Prev Next
Post
/el_streetlights/

Operation is used to create new streetlight. Available from product version 3.2.2.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters

Streetlight to be created

object
additional_information
string

Additional information about warranty fix details. Available from product version 2025.3.

capacitor
integer

Streetlight capacitor type id

capacitor_change_date
string (date-time)

Streetlight capacitor date

choker
integer

Streetlight choker type id

color
integer

Streetlight color type id

color_rendering_index
integer

Streetlight color rendering index. Available from product version 3.2.20.

color_temperature
integer

Streetlight color temperature type id

contractor
integer

Streetlight contractor id

control_device
integer

Streetlight control device type id. Available from product version 3.2.20.

control_profile
integer

Streetlight control profile type id. Available from product version 3.2.20.

cope
integer

Streetlight cope type id

cope_change_date
string (date-time)

Streetlight cope change date

group_change_date
string (date-time)

Streetlight group change date

group_cleaning_date
string (date-time)

Streetlight group cleaning date

height_accuracy
integer

Height accuracy id

ik_class
integer

Streetlight IK class type id. Available from product version 3.2.20.

installation_date
string (date)

Installation date

installation_height
number (float)

Installation height

installation_type
integer

Streetlight installation type id

installation_year
integer

Installation year

ip_class
integer

Streetlight IP class type id. Available from product version 3.2.20.

lamp_change_date
string (date-time)

Streetlight lamp change date

lamp_count
integer

Lamp count

lamp_dimmer
integer

Streetlight lamp dimmer type id

lamp_dimmer_change_date
string (date-time)

Streetlight lamp dimmer change date

lamp_dimming_class
integer

Streetlight lamp dimming class id

lamp_lighter
integer

Streetlight lamp lighter type id

lamp_lighter_change_date
string (date-time)

Streetlight lamp lighter checkout date

lamp_manufacturer
integer

Streetlight lamp manufacturer id

lamp_model
integer

Streetlight lamp model id

lamp_position
string

Lamp position

lamp_power
integer Required

Streetlight lamp power type id. Required field from product version 3.2.22

lamp_shade
integer

Streetlight lamp shade type id

lamp_socket
integer

Streetlight lamp socket type id

lamp_type
integer Required

Streetlight lamp type id

lamp_usage_class
integer

Streetlight lamp usage class id

lamp_warranty_exp_date
string (date-time)

Streetlight lamp warranty expiration date

lamp_warranty_period
integer

Lamp warranty period length

lantern_angle
integer

Available from product version 3.2.22

latest_warranty_fix_date
string (date)

Latest warranty fix date. Available from product version 2025.3.

light_change_date
string (date-time)

Streetlight change date

light_checkout_date
string (date-time)

Streetlight checkout date

light_condition
integer

Streetlight condition id

light_connection
integer

Streetlight connection type id

light_connection_change_date
string (date-time)

Streetlight connection change date

light_distribution
integer

Streetlight distribution type id

light_manufacturer
integer

Streetlight manufacturer id

light_power
integer

Streetlight light power type id

light_specifier
integer

Streetlight specifier type id

light_warranty_exp_date
string (date-time)

Streetlight warranty expiration date

light_warranty_period
integer

Streetlight warranty period length

lightning_class
integer

Streetlight lightning class id

location
string (ewkt)

Geographical location

location_accuracy
integer

Location accuracy id

luminaire_angle
integer

Available from product version 3.2.22

luminous_flux
integer

Luminous flux

mapper
string

mapper name

mapping_date
string (date-time)

mapping date

mapping_method
integer

Mapping method id

network_area
integer

Network area id

next_group_change_date
string (date-time)

Streetlight group next change date

next_group_cleaning_date
string (date-time)

Streetlight group next cleaning date

owner
integer

Owner id

plan
integer

Plan id

pole
integer

Streetlight pole id

protection
integer

Streetlight protection type id. Available from product version 3.2.20.

purlin_angle
number (float)

purlin angle

purlin_change_date
string (date-time)

Streetlight purlin date

purlin_diameter
number (float)

Purlin diameter

purlin_holder
integer

Streetlight purlin holder type id

purlin_material
integer

Streetlight purlin material id

purlin_phase
integer

Streetlight connection phase type id

purlin_saving
boolean

purlin phase saving enabled

purlin_surface
integer

Streetlight purlin surface type id

purlin_type
integer

Streetlight purlin type id

reflector_position
string

Reflector position

renter
integer

Renter id

riser
integer

Streetlight riser cable type id

riser_change_date
string (date-time)

Streetlight riser change date

survey_amount
integer

unknown

usage_state
integer Required

Usage state id

warranty_fix_type
integer

Warranty fix type id. Available from product version 2025.3.

Responses
201

A created Streetlight

{
  "capacitor": null,
  "capacitor_change_date": null,
  "choker": null,
  "color_rendering_index": null,
  "color_temperature": null,
  "contractor": null,
  "control_device": null,
  "control_profile": null,
  "cope": null,
  "cope_change_date": null,
  "creation_date": "2019-05-03T15:28:22.508Z",
  "creator": "api@keypro.fi",
  "group_change_date": null,
  "group_cleaning_date": null,
  "height_accuracy": null,
  "id": 85511,
  "ik_class": null,
  "installation_date": null,
  "installation_height": null,
  "installation_type": null,
  "installation_year": null,
  "ip_class": null,
  "lamp_change_date": null,
  "lamp_count": null,
  "lamp_dimmer": null,
  "lamp_dimmer_change_date": null,
  "lamp_dimming_class": null,
  "lamp_lighter": null,
  "lamp_lighter_change_date": null,
  "lamp_manufacturer": null,
  "lamp_model": null,
  "lamp_position": "",
  "lamp_power": 300510,
  "lamp_shade": null,
  "lamp_socket": null,
  "lamp_type": 300750,
  "lamp_usage_class": null,
  "lamp_warranty_exp_date": null,
  "lamp_warranty_period": null,
  "light_change_date": null,
  "light_checkout_date": null,
  "light_condition": null,
  "light_connection": null,
  "light_connection_change_date": null,
  "light_distribution": null,
  "light_manufacturer": null,
  "light_power": null,
  "light_specifier": null,
  "light_warranty_exp_date": null,
  "light_warranty_period": null,
  "lightning_class": null,
  "location": null,
  "location_accuracy": null,
  "luminous_flux": null,
  "mapper": "",
  "mapping_date": null,
  "mapping_method": null,
  "network_area": null,
  "next_group_change_date": null,
  "next_group_cleaning_date": null,
  "owner": null,
  "plan": null,
  "pole": null,
  "protection": null,
  "purlin_angle": null,
  "purlin_diameter": null,
  "purlin_holder": null,
  "reflector_position": "",
  "renter": null,
  "riser": null,
  "riser_change_date": null,
  "survey_amount": "",
  "update_date": "2019-05-03T15:28:22.508Z",
  "updated_by": "api@keypro.fi",
  "usage_state": 303350
}
object
additional_information
string

Additional information about warranty fix details. Available from product version 2025.3.

capacitor
integer

Streetlight capacitor type id

capacitor_change_date
string (date-time)

Streetlight capacitor date

choker
integer

Streetlight choker type id

color
integer

Streetlight color type id

color_rendering_index
integer

Streetlight color rendering index. Available from product version 3.2.20.

color_temperature
integer

Streetlight color temperature type id

contractor
integer

Streetlight contractor id

control_device
integer

Streetlight control device type id. Available from product version 3.2.20.

control_profile
integer

Streetlight control profile type id. Available from product version 3.2.20.

cope
integer

Streetlight cope type id

cope_change_date
string (date-time)

Streetlight cope change date

creation_date
string (date-time)

creation date and time

creator
string

object creator

group_change_date
string (date-time)

Streetlight group change date

group_cleaning_date
string (date-time)

Streetlight group cleaning date

height_accuracy
integer

Height accuracy id

id
integer

Primary key

ik_class
integer

Streetlight IK class type id. Available from product version 3.2.20.

installation_date
string (date)

Installation date

installation_height
number (float)

Installation height

installation_type
integer

Streetlight installation type id

installation_year
integer

Installation year

ip_class
integer

Streetlight IP class type id. Available from product version 3.2.20.

lamp_change_date
string (date-time)

Streetlight lamp change date

lamp_count
integer

Lamp count

lamp_dimmer
integer

Streetlight lamp dimmer type id

lamp_dimmer_change_date
string (date-time)

Streetlight lamp dimmer change date

lamp_dimming_class
integer

Streetlight lamp dimming class id

lamp_lighter
integer

Streetlight lamp lighter type id

lamp_lighter_change_date
string (date-time)

Streetlight lamp lighter checkout date

lamp_manufacturer
integer

Streetlight lamp manufacturer id

lamp_model
integer

Streetlight lamp model id

lamp_position
string

Lamp position

lamp_power
integer

Streetlight lamp power type id. Required field from product version 3.2.22

lamp_shade
integer

Streetlight lamp shade type id

lamp_socket
integer

Streetlight lamp socket type id

lamp_type
integer

Streetlight lamp type id

lamp_usage_class
integer

Streetlight lamp usage class id

lamp_warranty_exp_date
string (date-time)

Streetlight lamp warranty expiration date

lamp_warranty_period
integer

Lamp warranty period length

lantern_angle
integer

Available from product version 3.2.22

latest_warranty_fix_date
string (date)

Latest warranty fix date. Available from product version 2025.3.

light_change_date
string (date-time)

Streetlight change date

light_checkout_date
string (date-time)

Streetlight checkout date

light_condition
integer

Streetlight condition id

light_connection
integer

Streetlight connection type id

light_connection_change_date
string (date-time)

Streetlight connection change date

light_distribution
integer

Streetlight distribution type id

light_manufacturer
integer

Streetlight manufacturer id

light_power
integer

Streetlight light power type id

light_specifier
integer

Streetlight specifier type id

light_warranty_exp_date
string (date-time)

Streetlight warranty expiration date

light_warranty_period
integer

Streetlight warranty period length

lightning_class
integer

Streetlight lightning class id

location
string (ewkt)

Geographical location

location_accuracy
integer

Location accuracy id

luminaire_angle
integer

Available from product version 3.2.22

luminous_flux
integer

Luminous flux

mapper
string

mapper name

mapping_date
string (date-time)

mapping date

mapping_method
integer

Mapping method id

network_area
integer

Network area id

next_group_change_date
string (date-time)

Streetlight group next change date

next_group_cleaning_date
string (date-time)

Streetlight group next cleaning date

owner
integer

Owner id

plan
integer

Plan id

pole
integer

Streetlight pole id

protection
integer

Streetlight protection type id. Available from product version 3.2.20.

purlin_angle
number (float)

purlin angle

purlin_change_date
string (date-time)

Streetlight purlin date

purlin_diameter
number (float)

Purlin diameter

purlin_holder
integer

Streetlight purlin holder type id

purlin_material
integer

Streetlight purlin material id

purlin_phase
integer

Streetlight connection phase type id

purlin_saving
boolean

purlin phase saving enabled

purlin_surface
integer

Streetlight purlin surface type id

purlin_type
integer

Streetlight purlin type id

reflector_position
string

Reflector position

renter
integer

Renter id

riser
integer

Streetlight riser cable type id

riser_change_date
string (date-time)

Streetlight riser change date

survey_amount
integer

unknown

update_date
string (date-time)

last update date time

updated_by
string

object last updater

usage_state
integer

Usage state id

warranty_fix_type
integer

Warranty fix type id. Available from product version 2025.3.

400

There was an error in request. Usually field validation failed.

{
  "type": [
    "This field is required."
  ],
  "usage_state": [
    "This field is required."
  ]
}
object

Fields which failed validation

property*
Array of string additionalProperties

List of validation errors for this fieldname

string

Validation error

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object
details
string

Detailed description of error