Create new electric pole

Prev Next
Post
/el_poles/

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

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters

Electric Pole to be created

object
address
integer

Id of address

base_change_date
string (date)

Base change date

base_manufacturer
integer

Id of base manufacturer

base_material
integer

Id of base material

base_type
integer

Id of base type

change_date
string (date)

Change data

checkout_year
integer

Checkout year

coating
integer

Id of coating

color
integer

Available from product version 2025.2.0

contractor
integer

Id of contractor

decay_class
integer

Id of decay class

engineering_fit
integer

Id of engineering fit

hatch_count
integer

Hatch count

height_accuracy
integer

Id of height accuracy

install_date
string (date)

Install date

install_year
integer

Install year

lantern_angle
integer

Available from product version 2025.2.0

length
number (float)

Electric Pole length

location
string (ewkt)

Locatin of pole in EWKT

location_accuracy
integer

Id of location accuracy

mapper
string

Survey mapper

mapping_date
string (date)

Mapping date

mapping_method
integer

Id of mapping method

material
integer

Id of material

net_type
integer

Id of net type

network_area
integer

Id of network area

owner
integer

Id of owner

plan
integer

Id of plan

pole_manufacturer
integer

Id of electric pole manufacturer

pole_number
string

Electric Pole number

pole_type
integer Required

Id of electric pole type

purlin_change_date
string (date-time)

Pole purlin date. Available from product version 2025.2.0

purlin_material
integer

Available from product version 2025.2.0

purlin_surface
integer

Available from product version 2025.2.0

purlin_type
integer

Available from product version 2025.2.0

remarks
string

Remarks. Available from product version 3.2.14.

renter
integer

Id of renter

safety_class
integer

Id of safety class

shade
integer

Id of shade

stanchion
integer

Id of stanchion

streetname
string

Street name

survey_amount
string

Survey amount

trunk
integer

Id of trunk

type_drawing
string

Type drawing

usage_state
integer Required

Id of state

warranty_exp_date
string (date)

Warranty expiration date

warranty_period
integer

Warranty period in months

Responses
201

A created electric pole

{
  "address": null,
  "base_change_date": null,
  "base_manufacturer": null,
  "base_material": null,
  "base_type": null,
  "change_date": null,
  "checkout_year": null,
  "coating": null,
  "color": null,
  "contractor": null,
  "created_by": "api@keypro.fi",
  "created_ts": "2018-02-26T12:17:22Z",
  "decay_class": null,
  "engineering_fit": null,
  "hatch_count": null,
  "height_accuracy": null,
  "id": 1001,
  "install_date": null,
  "install_year": null,
  "length": null,
  "location": "SRID=3067;POINT Z (499160.9904789999709465 6705680.7634800001978874 0.0000000000000000)",
  "location_accuracy": null,
  "mapper": "",
  "mapping_method": null,
  "material": null,
  "net_type": 304290,
  "network_area": 1,
  "owner": null,
  "plan": null,
  "pole_manufacturer": null,
  "pole_number": "",
  "pole_type": 302550,
  "purlin_change_date": null,
  "purlin_material": null,
  "purlin_surface": null,
  "purlin_type": null,
  "renter": null,
  "safety_class": null,
  "shade": null,
  "stanchion": null,
  "streetname": "",
  "survey_amount": "",
  "trunk": null,
  "type_drawing": "",
  "updated_by": "api@keypro.fi",
  "updated_ts": "2018-02-26T12:17:22Z",
  "usage_state": 790,
  "warranty_exp_date": null,
  "warranty_period": null
}
object
address
integer

Id of address

base_change_date
string (date)

Base change date

base_manufacturer
integer

Id of base manufacturer

base_material
integer

Id of base material

base_type
integer

Id of base type

change_date
string (date)

Change data

checkout_year
integer

Checkout year

coating
integer

Id of coating

color
integer

Available from product version 2025.2.0

contractor
integer

Id of contractor

created_by
string

Created by

created_ts
string (date-time)

Created timestamp

decay_class
integer

Id of decay class

engineering_fit
integer

Id of engineering fit

hatch_count
integer

Hatch count

height_accuracy
integer

Id of height accuracy

id
integer

Primary key

install_date
string (date)

Install date

install_year
integer

Install year

lantern_angle
integer

Available from product version 2025.2.0

length
number (float)

Electric Pole length

location
string (ewkt)

Locatin of pole in EWKT

location_accuracy
integer

Id of location accuracy

mapper
string

Survey mapper

mapping_date
string (date)

Mapping date

mapping_method
integer

Id of mapping method

material
integer

Id of material

net_type
integer

Id of net type

network_area
integer

Id of network area

owner
integer

Id of owner

plan
integer

Id of plan

pole_manufacturer
integer

Id of electric pole manufacturer

pole_number
string

Electric Pole number

pole_type
integer

Id of electric pole type

purlin_change_date
string (date-time)

Pole purlin date. Available from product version 2025.2.0

purlin_material
integer

Available from product version 2025.2.0

purlin_surface
integer

Available from product version 2025.2.0

purlin_type
integer

Available from product version 2025.2.0

remarks
string

Remarks. Available from product version 3.2.14.

renter
integer

Id of renter

safety_class
integer

Id of safety class

shade
integer

Id of shade

stanchion
integer

Id of stanchion

streetname
string

Street name

survey_amount
string

Survey amount

trunk
integer

Id of trunk

type_drawing
string

Type drawing

updated_by
string

Last updated by

updated_ts
string (date-time)

Last updated timestamp

usage_state
integer

Id of state

warranty_exp_date
string (date)

Warranty expiration date

warranty_period
integer

Warranty period in months

400

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

{
  "pole_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