Table of contents
Reality Analysis
Download API definition:
This API is a Technical Preview and is available for testing purposes only. Do not use in production.
GET https://dev-api.bentley.com/reality-analysis/jobs/{id}

Retrieve job details.

Authentication

Requires Authorization header with valid Bearer token for scope itwin-platform.

For more documentation on authorization and how to get access token visit OAUTH2 Authorization page.

Request parameters

Name
Required?
Description
id
Yes

Job id

Request headers

Name
Required?
Description
Authorization
Yes

OAuth access token with itwin-platform scope

Accept
Yes

Setting to application/vnd.bentley.itwin-platform.v2+json is recommended.

Response 200 OK

OK

json
{
    "job": {
        "id": "8ee1aeca-1b3c-4063-a298-042681febcda",
        "state": "Active",
        "userId": "8791f3ca-3313-4c50-b0e7-76b32d0bab9e",
        "executionInfo": {
            "createdDateTime": "2025-08-05T12:38:12Z"
        },
        "specifications": {
            "inputs": {
                "photos": "cf90403c-5d86-4844-85da-66c4aac64572",
                "photoSegmentationDetector": "47c121b3-0b0b-4510-8f9a-d93803de18ab"
            },
            "outputs": {
                "segmentation2D": "a5a0356c-bb72-4149-87ff-8f22908534ee",
                "segmentedPhotos": "4c0e3562-fbbd-4683-987e-b149b8488e4d"
            },
            "options": {
                "computeLineWidth": true,
                "minPhotos": 10
            }
        },
        "name": "Segmentation2D Job",
        "type": "Segmentation2D",
        "iTwinId": "5ad3c614-83aa-41e2-b3f8-fbd6d18b93b9"
    }
}

Response 401 Unauthorized

This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.

json
{
    "error": {
        "code": "HeaderNotFound",
        "message": "Header Authorization was not found in the request. Access denied."
    }
}

Response 404 Not Found

This response indicates that the specified job was not found.

json
{
    "error": {
        "code": "JobNotFound",
        "message": "Requested job is not available."
    }
}

Response 429 Too many requests

This response indicates that the client sent more requests than allowed by this API for the current tier of the client.

json
{
    "error": {
        "code": "RateLimitExceeded",
        "message": "The client sent more requests than allowed by this API for the current tier of the client."
    }
}

Response headers

Name
Description
retry-after

Number of seconds to wait until client is allowed to make more requests.

Job type

Supported job types

Name
Type
Description
Objects2D
String
Segmentation2D
String
Segmentation3D
String
SegmentationOrthophoto
String
ChangeDetection
String
EvalO2D
String
EvalO3D
String
EvalS2D
String
EvalS3D
String
EvalSOrtho
String
TrainingO2D
String
TrainingS3D
String

Job State

Job current state.

Name
Type
Description
Queued
String
Active
String
Terminating
String
Cancelled
String
Failed
String
Success
String

Job Response

Name
Type
Description
job

Job

Job information.

Name
Type
Description
id
String

Unique id of the job.

state

Current state of the job.

userId
String

Identifier of the user that created the job.

executionInfo

Known execution information for the job.

name
String

Name of the job.

type

Type of the job.

iTwinId
String

iTwin Id for the job.

Execution Information

Execution information of a job.

Name
Type
Description
startedDateTime
Date-time

Start time of the job.

endedDateTime
Date-time

End time of the job.

createdDateTime
Date-time

Creation time of the job.

estimatedUnits
Number

Estimated number of units consumed by the job.

Objects2D Specifications

Specifications for Objects2D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

Objects2D Inputs

Following are the different inputs for the job.

Name
Type
Description
model3D
String

Reality data id of ContextScene pointing to a collection of point clouds/meshes to process, or a point cloud, or a mesh.

objects2D
String

Reality data id of ContextScene annotated with embedded 2D objects. This input replaces the photoObjectDetector input.

photoObjectDetector
String

Reality data id of photo object detector or photo object detector identifier from the Detector Library.

photos
String

Reality data id of ContextScene pointing to the photos to process.

Objects2D Outputs

Following are the different output types for the job.

Name
Type
Description
locations3DAsGeoJSON
String

Reality data id of 3D objects locations as GeoJSON file, objects3d output must be defined.

locations3DAsSHP
String

Reality data id of 3D objects locations as SHP file, objects3d output must be defined.

objects2D
String

Reality data id of ContextScene, annotated with embedded 2D objects.

objects3D
String

Reality data id of ContextScene, annotated with embedded 3D objects.

objects3DAs3DTiles
String

Reality data id of 3D objects as 3D Tiles file, objects3d output must be defined.

objects3DAsGeoJSON
String

Reality data id of 3D objects as GeoJSON file, objects3d output must be defined.

Objects2D Options

Options for Objects2D job.

Name
Type
Description
crs
String

CRS used by locations3DAsSHP outputs.

maxDist
Number

Maximum distance between photos and 3D objects.

minPhotos
Integer

Minimum number of 2D objects to generate a 3D object.

useTiePoints
Boolean

Improve detection using tie points in oriented photos.

Segmentation2D Inputs

Following are the different inputs for the job.

Name
Type
Description
model3D
String

Reality data id of ContextScene pointing to a collection of point clouds/meshes to process, or a point cloud, or a mesh.

segmentation2D
String

Reality data id of ContextScene pointing to segmented photos. This input replaces photoSegmentationDetector input.

photoSegmentationDetector
String

Either reality data id of photo segmentation detector or photo segmentation detector identifier from the Detectors Library.

photos
String

Reality data id of the ContextScene pointing to the photos to process.

Segmentation2D Options

Options for Segmentation2D job.

Name
Type
Description
computeLineWidth
Boolean

Estimation 3D line width at each vertex.

removeSmallLines
Number

Remove 3D lines with total length smaller than this value.

minPhotos
Integer

Minimum number of 2D detection to generate a 3D detection.

Segmentation2D Specifications

Specifications for Segmentation2D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

Segmentation2D Outputs

Following are the different output types.

Name
Type
Description
segmentation2D
String

Reality data id of ContextScene pointing to segmented photos.

segmentedPhotos
String

Reality data id of segmented photos.

lines3D
String

Reality data id of ContextScene annotated with embedded 3D lines.

lines3DAs3DTiles
String

Reality data id of 3D lines as 3D Tiles file, lines3d output must be defined.

lines3DAsGeoJSON
String

Reality data id of 3D lines as GeoJSON file, lines3d output must be defined.

polygons3D
String

Reality data id of ContextScene annotated with embedded 3D polygons.

polygons3DAs3DTiles
String

Reality data id of 3D polygons as 3D Tiles file, polygons3d output must be defined.

polygons3DAsGeoJSON
String

Reality data id of 3D polygons as GeoJSON file, polygons3d output must be defined.

SegmentationOrthophoto Inputs

Following are the different inputs for job.

Name
Type
Description
orthophoto
String

Reality data id of ContextScene pointing to orthophotos to process.

orthophotoSegmentationDetector
String

Either reality data id of orthophoto segmentation detector or orthophoto segmentation detector identifier from the Detectors Library.

SegmentationOrthophoto Specifications

Specifications for SegmentationOrthophoto job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

SegmentationOrthophoto Outputs

Following are the different output types.

Name
Type
Description
segmentation2D
String

Reality data id of ContextScene pointing to segmented orthophotos.

segmentedPhotos
String

Reality data id of segmented orthophotos.

polygons2D
String

Reality data id of ContextScene annotated with embedded 2D polygons.

polygons2DAsSHP
String

Reality data id of 2D polygons as SHP file, polygons2d output must be defined.

polygons2DAsGeoJSON
String

Reality data id of 2D polygons as GeoJSON file, polygons2d output must be defined.

lines2D
String

Reality data id of ContextScene annotated with embedded 2D lines.

lines2DAsSHP
String

Reality data id of 2D lines as SHP file, lines2d output must be defined.

lines2DAsGeoJSON
String

Reality data id of 2D lines as GeoJSON file, lines2d output must be defined.

ChangeDetection Inputs

Following are the different inputs for the job.

Name
Type
Description
reference
String

Reality data id of ContextScene, point cloud or mesh.

toCompare
String

Reality data id of ContextScene, point cloud or mesh.

ChangeDetection Options

Options for ChangeDetection job.

Name
Type
Description
filterThreshold
Number

Low threshold to detect spatial changes (hysteresis detection).

meshSamplingResolution
Number

Target point cloud resolution when starting from meshes.

minPointsPerChange
Integer

Minimum number of points in a region to be considered as a change.

outputCrs
String

CRS used by locations3DAsSHP output.

threshold
Number

High threshold to detect spatial changes (hysteresis detection).

ChangeDetection Specifications

Specifications for ChangeDetection job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

ChangeDetection Outputs

Following are the different output types for the job.

Name
Type
Description
added
String

Points in toCompare not in reference as OPC.

removed
String

Points in reference not in toCompare as OPC.

locations3DAsGeoJSON
String

Reality data id of 3D objects locations as GeoJSON file.

locations3DAsSHP
String

Reality data id of 3D objects locations as SHP format.

objects3D
String

Reality data id of ContextScene annotated with embedded 3D objects.

Segmentation3D Options

Options for Segmentation3D job.

Name
Type
Description
computeLineWidth
Boolean

Estimation 3D line width at each vertex.

crs
String

CRS used by POD, LAS, LAZ, PLY and SHP outputs.

keepInputResolution
Boolean

To make segmentation 3D output exact same point input.

removeSmallComponents
Number

Remove 3D lines with total length smaller than this value.

saveConfidence
Boolean

Save confidence in 3D segmentation.

Segmentation3D Inputs

Following are the different inputs for the job.

Name
Type
Description
extent
String

Path in the bucket of the clipping polygon to apply.

model3D
String

Reality data id of ContextScene pointing to a collection of point clouds/meshes to process, or a point cloud, or a mesh.

pointCloudSegmentationDetector
String

Either reality data id of point cloud segmentation detector or point cloud segmentation detector identifier from the Detectors Library.

segmentation3D
String

Reality data id of ContextScene pointing to a segmented point cloud, this input replaces pointCloudSegmentationDetector and model3D inputs.

Segmentation3D Specifications

Specifications for Segmentation3D job.

Name
Type
Description
inputs

Inputs for the job.

options

Options for the job.

outputs

Outputs for the job.

Segmentation3D Outputs

Following are the different output types for the job.

Name
Type
Description
lines3D
String

Reality data id of ContextScene annotated with embedded 3D lines.

lines3DAs3DTiles
String

Reality data id of 3D lines as 3D Tiles file, lines3d output must be defined.

lines3DAsGeoJSON
String

Reality data id of 3D lines as GeoJSON file, lines3d output must be defined.

locations3DAsGeoJSON
String

Reality data id of 3D objects locations as GeoJSON file, objects3d output must be defined.

locations3DAsSHP
String

Reality data id of 3D objects locations as SHP file, objects3d output must be defined.

objects3D
String

Reality data id of ContextScene annotated with embedded 3D objects.

objects3DAs3DTiles
String

Reality data id of 3D objects as 3D Tiles file, objects3d output must be defined.

objects3DAsGeoJSON
String

Reality data id of 3D objects as GeoJSON file, objects3d output must be defined.

polygons3D
String

Reality data id of ContextScene annotated with embedded 3D polygons.

polygons3DAs3DTiles
String

Reality data id of 3D polygons as 3D Tiles file, polygons3d output must be defined.

polygons3DAsGeoJSON
String

Reality data id of 3D polygons as GeoJSON file, polygons3d output must be defined.

segmentation3D
String

Reality data id of ContextScene pointing to the segmented point cloud.

segmentation3DAsLAS
String

Reality data id of the segmented point cloud as LAS file, segmentation3D output must be defined.

segmentation3DAsLAZ
String

Reality data id of the segmented point cloud as LAZ file, segmentation3D output must be defined.

segmentation3DAsPLY
String

Reality data id of the segmented point cloud as PLY file, segmentation3D output must be defined.

segmentation3DAsPOD
String

Reality data id of the segmented point cloud as POD file, segmentation3D output must be defined.

segmentedPointCloud
String

Reality data id of the 3D segmentation as OPC file.

Eval Objects 2D Inputs

Following are the different inputs for the job.

Name
Type
Description
prediction
String

Reality data id of ContextScene annotated with embedded 2D object predictions.

reference
String

Reality data id of ContextScene annotated with embedded 2D object references.

Eval Objects 2D Options

Options for Eval Objects 2D job.

Name
Type
Description
thresholdIOU
Number

Intersection over union threshold.

Eval Objects 2D Specifications

Specifications for Eval Objects 2D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

Eval Objects 2D Outputs

Following are the different output types for the job.

Name
Type
Description
objects2d
String

Reality data id of ContextScene annotated with classified embedded 2D objects.

report
String

Path in Bucket of json report with binary classification.

Eval Objects 3D Inputs

Following are the different inputs for the job.

Name
Type
Description
prediction
String

Reality data id of ContextScene annotated with embedded 3D object predictions.

reference
String

Reality data id of ContextScene annotated with embedded 3D object references.

Eval Objects 3D Options

Options for Eval Objects 3D job.

Name
Type
Description
thresholdIOU
Number

Intersection over union threshold.

Eval Objects 3D Specifications

Specifications for Eval Objects 3D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

Eval Objects 3D Outputs

Following are the different output types for the job.

Name
Type
Description
objects3d
String

Reality data id of ContextScene annotated with classified embedded 3D objects.

report
String

Path in Bucket of json report with binary classification.

Eval Segmentation 2D Inputs

Following are the different inputs for the job.

Name
Type
Description
prediction
String

Reality data id of ContextScene pointing to segmented photos prediction.

reference
String

Reality data id of ContextScene, pointing to segmented photos reference.

Eval Segmentation 2D Specifications

Specifications for Eval Segmentation 2D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

Eval Segmentation 2D Outputs

Following are the different output types for the job.

Name
Type
Description
segmentation2D
String

Reality data id of ContextScene pointing to segmented photos.

report
String

Path in Bucket of json report with confusion matrix.

segmentedPhotos
String

Reality data id of segmented photos annotated with confusion matrix index.

Eval Segmentation 3D Inputs

Following are the different inputs for the job.

Name
Type
Description
prediction
String

Reality data id of ContextScene pointing to segmented point cloud prediction.

reference
String

Reality data id of ContextScene, pointing to segmented point cloud reference.

Eval Segmentation 3D Specifications

Specifications for Eval Segmentation 3D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

Eval Segmentation 3D Outputs

Following are the different output types for the job.

Name
Type
Description
segmentation3D
String

Reality data id of ContextScene pointing to segmented point cloud.

report
String

Path in Bucket of json report with confusion matrix.

segmentedPointCloud
String

Reality data id of segmented point cloud annotated with confusion matrix index.

Eval Segmentation Orthophoto Inputs

Following are the different inputs for the job.

Name
Type
Description
prediction
String

Reality data id of ContextScene pointing to segmented photos prediction.

reference
String

Reality data id of ContextScene pointing to segmented photos reference.

Eval Segmentation Orthophoto Specifications

Specifications for Eval Segmentation Orthophoto job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

Eval Segmentation Orthophoto Outputs

Following are the different output types.

Name
Type
Description
segmentation2D
String

Reality data id of ContextScene pointing to segmented photos.

report
String

Path in Bucket of json report with confusion matrix.

segmentedPhotos
String

Reality data id of segmented photos annotated with confusion matrix index.

TrainingO2D Inputs

Following are the inputs for the job.

Name
Type
Description
scene
String

Reality data id of a ContextScene pointing to photos with annotations (in the contextscene file).

TrainingO2D Options

Options for TrainingO2D job.

Name
Type
Description
epochs
Integer

Number of time to iterate over the entire dataset.

maxTrainingSplit
Number

Ratio (between 0.0 excluded and 1.0 included) of training data used to train the detector, the rest will be used to evaluate the model after each epoch and compute extra evaluation metrics. Set it to 1.0 for no evaluation and use everything for training.

TrainingO2D Specifications

Specifications for TrainingO2D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

TrainingO2D Outputs

Following are the different output types for the job.

Name
Type
Description
detector
String

Reality data id of the detector.

metrics
String

Path in the bucket of the training metrics.

TrainingS3D Inputs

Following are the inputs for TrainingS3D job.

Name
Type
Description
scene
String

Reality data id of a ContextScene pointing to photos with annotations (in the contextscene file).

TrainingS3D Options

Options for TrainingS3D job.

Name
Type
Description
epochs
Integer

Number of time to iterate over the entire dataset.

maxTrainingSplit
Number

Ratio (between 0.0 excluded and 1.0 included) of training data used to train the detector, the rest will be used to evaluate the model after each epoch and compute extra evaluation metrics. Set it to 1.0 for no evaluation and use everything for training.

spacing
Number

Spacing of the pointcloud seen by the detector.

TrainingS3D Specifications

Specifications for TrainingS3D job.

Name
Type
Description
inputs

Inputs for the job.

outputs

Outputs for the job.

options

Options for the job.

TrainingS3D Outputs

Following are the outputs for the job.

Name
Type
Description
detector
String

Reality data id of the detector.

Error

Contains error information.

Name
Type
Description
code
String

One of a server-defined set of error codes.

message
String

A human-readable representation of the error.

target
String, null

The target of the error.

Error Response

Gives details for an error that occurred while handling the request. Note that clients MUST NOT assume that every failed request will produce an object of this schema, or that all of the properties in the response will be non-null, as the error may have prevented this response from being constructed.

Name
Type
Description
error

Error information.

Was this page helpful?