Get a job - Reality Conversion

Reality Conversion

This API is a Technical Preview and is available for testing purposes only. Do not use in production.

Get a job

GET https://api.bentley.com/reality-conversion/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

Yes

Job Id.

Request headers

Authorization

Yes

OAuth access token with itwin-platform scope

Yes

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

Response 200 OK

json

{
    "job": {
        "id": "535d7f39-34cd-45a2-8b4c-e79486252355",
        "state": "Cancelled",
        "userId": "2c5f9681-62dc-4502-b03d-1a23adee2168",
        "executionInfo": {
            "startedDateTime": "2026-04-05T12:58:15Z",
            "endedDateTime": "2026-04-05T12:58:15Z",
            "createdDateTime": "2026-04-05T12:55:42Z",
            "processingUnits": 0
        },
        "specifications": {
            "inputs": {
                "pointCloud": "56dfc9f9-91be-472d-9e81-114429b382b6"
            },
            "output": "8805bab6-af30-43f8-a1bc-dca122b7ac84",
            "options": {
                "outputFormat": "OPC"
            }
        },
        "name": "PC Conversion Job",
        "type": "PointCloudConversion",
        "iTwinId": "31bcc0d0-b5ab-4a36-8be7-ab84aa472726"
    }
}

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

retry-after

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

Definitions

Job State

Job current state.

Queued

String

Active

String

TerminatingOnCancel

String

TerminatingOnFailure

String

Cancelled

String

Failed

String

Success

String

json

{
    "title": "Job State",
    "enum": [
        "Queued",
        "Active",
        "TerminatingOnCancel",
        "TerminatingOnFailure",
        "Cancelled",
        "Failed",
        "Success"
    ],
    "type": "string",
    "description": "Job current state."
}

Execution Information

Execution information of a job.

createdDateTime

Date-time

Creation time of the job.

startedDateTime

Date-time, null

Start time of the job.

endedDateTime

Date-time, null

End time of the job.

processingUnits

Number, null

The number of processing units consumed by the job.

json

{
    "title": "Execution Information",
    "required": [
        "createdDateTime"
    ],
    "type": "object",
    "properties": {
        "createdDateTime": {
            "type": "string",
            "description": "Creation time of the job.",
            "format": "date-time"
        },
        "startedDateTime": {
            "type": "string",
            "description": "Start time of the job.",
            "format": "date-time",
            "default": null,
            "nullable": true
        },
        "endedDateTime": {
            "type": "string",
            "description": "End time of the job.",
            "format": "date-time",
            "default": null,
            "nullable": true
        },
        "processingUnits": {
            "type": "number",
            "description": "The number of processing units consumed by the job.",
            "default": null,
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Execution information of a job."
}

PointCloud Conversion Inputs

pointCloud

String

Reality data Id of point cloud to convert

json

{
    "title": "PointCloud Conversion Inputs",
    "required": [
        "pointCloud"
    ],
    "type": "object",
    "properties": {
        "pointCloud": {
            "title": "pointCloud",
            "type": "string",
            "description": "Reality data Id of point cloud to convert"
        }
    },
    "additionalProperties": false
}

PointCloud Conversion Format

OPC

String

3DTilesPNTS

String

3DTilesGLBC

String

LAS

String

LAZ

String

E57

String

POD

String

json

{
    "title": "PointCloud Conversion Format",
    "enum": [
        "OPC",
        "3DTilesPNTS",
        "3DTilesGLBC",
        "LAS",
        "LAZ",
        "E57",
        "POD"
    ],
    "type": "string"
}

PointCloud Conversion Options

outputFormat

All of: PCConversionFormat, null

Output format for the conversion.

inputCrs

String, null

CRS for the input data

outputCrs

String, null

CRS for the output data

json

{
    "title": "PointCloud Conversion Options",
    "type": "object",
    "properties": {
        "outputFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/PCConversionFormat"
                }
            ],
            "description": "Output format for the conversion.",
            "nullable": true
        },
        "inputCrs": {
            "type": "string",
            "description": "CRS for the input data",
            "nullable": true
        },
        "outputCrs": {
            "type": "string",
            "description": "CRS for the output data",
            "nullable": true
        }
    },
    "additionalProperties": false
}

PointCloud Conversion Specifications

Specifications for PointCloud Conversion.

inputs

PCConversionInputs

output

String

Reality Data id of the converted point cloud

options

All of: PCConversionOptions, null

Options

json

{
    "title": "PointCloud Conversion Specifications",
    "required": [
        "inputs",
        "output"
    ],
    "type": "object",
    "properties": {
        "inputs": {
            "$ref": "#/components/schemas/PCConversionInputs"
        },
        "output": {
            "title": "output",
            "type": "string",
            "description": "Reality Data id of the converted point cloud"
        },
        "options": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PCConversionOptions"
                }
            ],
            "description": "Options",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Specifications for PointCloud Conversion."
}

PointCloud Optimization Inputs

pointClouds

String[]

Reality data Ids of point cloud(s) to convert

json

{
    "title": "PointCloud Optimization Inputs",
    "required": [
        "pointClouds"
    ],
    "type": "object",
    "properties": {
        "pointClouds": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Reality data Ids of point cloud(s) to convert"
        }
    },
    "additionalProperties": false
}

PointCloud Optimization Format

OPC

String

3DTilesPNTS

String

3DTilesGLBC

String

LAS

String

LAZ

String

E57

String

POD

String

json

{
    "title": "PointCloud Optimization Format",
    "enum": [
        "OPC",
        "3DTilesPNTS",
        "3DTilesGLBC",
        "LAS",
        "LAZ",
        "E57",
        "POD"
    ],
    "type": "string"
}

PointCloud Optimization Options

outputFormat

All of: PCOptimizationFormat, null

Output format for the conversion.

inputCrs

String, null

CRS for the input data

outputCrs

String, null

CRS for the output data

json

{
    "title": "PointCloud Optimization Options",
    "type": "object",
    "properties": {
        "outputFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/PCOptimizationFormat"
                }
            ],
            "description": "Output format for the conversion.",
            "nullable": true
        },
        "inputCrs": {
            "type": "string",
            "description": "CRS for the input data",
            "nullable": true
        },
        "outputCrs": {
            "type": "string",
            "description": "CRS for the output data",
            "nullable": true
        }
    },
    "additionalProperties": false
}

PointCloud Optimization Specifications

Specifications for PointCloud Optimization.

inputs

PCOptimizationInputs

output

String

Reality Data id of the converted point cloud

options

All of: PCOptimizationOptions, null

Options

json

{
    "title": "PointCloud Optimization Specifications",
    "required": [
        "inputs",
        "output"
    ],
    "type": "object",
    "properties": {
        "inputs": {
            "$ref": "#/components/schemas/PCOptimizationInputs"
        },
        "output": {
            "title": "output",
            "type": "string",
            "description": "Reality Data id of the converted point cloud"
        },
        "options": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PCOptimizationOptions"
                }
            ],
            "description": "Options",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Specifications for PointCloud Optimization."
}

TileMap Optimization Inputs

tileMaps

String[]

Reality data Ids of tile maps to convert

json

{
    "title": "TileMap Optimization Inputs",
    "required": [
        "tileMaps"
    ],
    "type": "object",
    "properties": {
        "tileMaps": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Reality data Ids of tile maps to convert"
        }
    },
    "additionalProperties": false
}

TileMap Optimization Format

XYZTileMap

String

json

{
    "title": "TileMap Optimization Format",
    "enum": [
        "XYZTileMap"
    ],
    "type": "string"
}

TileMap Image Format

JPG

String

PNG

String

json

{
    "title": "TileMap Image Format",
    "enum": [
        "JPG",
        "PNG"
    ],
    "type": "string"
}

TileMap Optimization Options

outputFormat

All of: TileMapOptimizationFormat, null

Output format for the conversion.

inputCrs

String, null

CRS for the input data

outputCrs

String, null

CRS for the output data

topLevel

Integer, null

Top level of the tile map to generate.

bottomLevel

Integer, null

Bottom level of the tile map to generate.

imageFormat

All of: TileMapImageFormat, null

Image format

jpgQuality

Integer, null

Quality of JPG tiles to generate

backgroundColor

String, null

Background color to use for tiles

json

{
    "title": "TileMap Optimization Options",
    "type": "object",
    "properties": {
        "outputFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/TileMapOptimizationFormat"
                }
            ],
            "description": "Output format for the conversion.",
            "nullable": true
        },
        "inputCrs": {
            "type": "string",
            "description": "CRS for the input data",
            "nullable": true
        },
        "outputCrs": {
            "type": "string",
            "description": "CRS for the output data",
            "nullable": true
        },
        "topLevel": {
            "type": "integer",
            "description": "Top level of the tile map to generate.",
            "nullable": true
        },
        "bottomLevel": {
            "type": "integer",
            "description": "Bottom level of the tile map to generate.",
            "nullable": true
        },
        "imageFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/TileMapImageFormat"
                }
            ],
            "description": "Image format",
            "nullable": true
        },
        "jpgQuality": {
            "maximum": 99,
            "minimum": 10,
            "type": "integer",
            "description": "Quality of JPG tiles to generate",
            "nullable": true
        },
        "backgroundColor": {
            "pattern": "^#[a-fA-F0-9]{6}$",
            "type": "string",
            "description": "Background color to use for tiles",
            "nullable": true
        }
    },
    "additionalProperties": false
}

TileMap Optimization Specifications

Specifications for TileMap Optimization.

inputs

TileMapOptimizationInputs

output

String

Reality Data id of the tile map

options

All of: TileMapOptimizationOptions, null

Options

json

{
    "title": "TileMap Optimization Specifications",
    "required": [
        "inputs",
        "output"
    ],
    "type": "object",
    "properties": {
        "inputs": {
            "$ref": "#/components/schemas/TileMapOptimizationInputs"
        },
        "output": {
            "title": "output",
            "type": "string",
            "description": "Reality Data id of the tile map"
        },
        "options": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/TileMapOptimizationOptions"
                }
            ],
            "description": "Options",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Specifications for TileMap Optimization."
}

Vector Optimization Inputs

vectors

String[]

Reality data Ids of vectors to consolidate

json

{
    "title": "Vector Optimization Inputs",
    "required": [
        "vectors"
    ],
    "type": "object",
    "properties": {
        "vectors": {
            "title": "vectors",
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Reality data Ids of vectors to consolidate"
        }
    },
    "additionalProperties": false
}

Vector Optimization Format

GeoJSON

String

FeatureDB

String

json

{
    "title": "Vector Optimization Format",
    "enum": [
        "GeoJSON",
        "FeatureDB"
    ],
    "type": "string"
}

Vector Optimization Options

outputFormat

All of: VectorOptimizationFormat, null

Output format for the conversion.

inputCrs

String, null

CRS for the input data

outputCrs

String, null

CRS for the output data

featureClassDisplayName

String, null

Feature class name

json

{
    "title": "Vector Optimization Options",
    "type": "object",
    "properties": {
        "outputFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/VectorOptimizationFormat"
                }
            ],
            "description": "Output format for the conversion.",
            "nullable": true
        },
        "inputCrs": {
            "type": "string",
            "description": "CRS for the input data",
            "nullable": true
        },
        "outputCrs": {
            "type": "string",
            "description": "CRS for the output data",
            "nullable": true
        },
        "featureClassDisplayName": {
            "type": "string",
            "description": "Feature class name",
            "nullable": true
        }
    },
    "additionalProperties": false
}

Vector Optimization Specifications

Specifications for Vector Optimization.

inputs

VectorOptimizationInputs

output

String

Reality Data id of the vector data or Feature DB index (fdb:)

options

All of: VectorOptimizationOptions, null

Options

json

{
    "title": "Vector Optimization Specifications",
    "required": [
        "inputs",
        "output"
    ],
    "type": "object",
    "properties": {
        "inputs": {
            "$ref": "#/components/schemas/VectorOptimizationInputs"
        },
        "output": {
            "title": "output",
            "type": "string",
            "description": "Reality Data id of the vector data or Feature DB index (fdb:)"
        },
        "options": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/VectorOptimizationOptions"
                }
            ],
            "description": "Options",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Specifications for Vector Optimization."
}

Mesh Sampling Inputs

meshes

String[]

Reality data Ids of meshes to sample

json

{
    "title": "Mesh Sampling Inputs",
    "required": [
        "meshes"
    ],
    "type": "object",
    "properties": {
        "meshes": {
            "title": "meshes",
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Reality data Ids of meshes to sample"
        }
    },
    "additionalProperties": false
}

MeshSamplingFormat

OPC

String

3DTilesPNTS

String

3DTilesGLBC

String

LAS

String

LAZ

String

E57

String

POD

String

json

{
    "title": "MeshSamplingFormat",
    "enum": [
        "OPC",
        "3DTilesPNTS",
        "3DTilesGLBC",
        "LAS",
        "LAZ",
        "E57",
        "POD"
    ],
    "type": "string"
}

Mesh Sampling Options

outputFormat

All of: MeshSamplingFormat, null

Output format for the conversion.

inputCrs

String, null

CRS for the input data

outputCrs

String, null

CRS for the output data

sampling

Number, null

Sampling value in meter

json

{
    "title": "Mesh Sampling Options",
    "type": "object",
    "properties": {
        "outputFormat": {
            "type": "string",
            "allOf": [
                {
                    "$ref": "#/components/schemas/MeshSamplingFormat"
                }
            ],
            "description": "Output format for the conversion.",
            "nullable": true
        },
        "inputCrs": {
            "type": "string",
            "description": "CRS for the input data",
            "nullable": true
        },
        "outputCrs": {
            "type": "string",
            "description": "CRS for the output data",
            "nullable": true
        },
        "sampling": {
            "type": "number",
            "description": "Sampling value in meter",
            "nullable": true
        }
    },
    "additionalProperties": false
}

Mesh Sampling Specifications

Specifications for Mesh Sampling.

inputs

MeshSamplingInputs

output

String

Reality Data id of the sampled point cloud

options

All of: MeshSamplingOptions, null

Options

json

{
    "title": "Mesh Sampling Specifications",
    "required": [
        "inputs",
        "output"
    ],
    "type": "object",
    "properties": {
        "inputs": {
            "$ref": "#/components/schemas/MeshSamplingInputs"
        },
        "output": {
            "title": "output",
            "type": "string",
            "description": "Reality Data id of the sampled point cloud"
        },
        "options": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/MeshSamplingOptions"
                }
            ],
            "description": "Options",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Specifications for Mesh Sampling."
}

Job Types

Supported job types

PointCloudConversion

String

PointCloudOptimization

String

TileMapOptimization

String

VectorOptimization

String

MeshSampling

String

json

{
    "title": "Job Types",
    "enum": [
        "PointCloudConversion",
        "PointCloudOptimization",
        "TileMapOptimization",
        "VectorOptimization",
        "MeshSampling"
    ],
    "description": "Supported job types"
}

Job

Job information.

String

Unique id of the job.

state

JobState

userId

String

Identifier of the user that created the job.

executionInfo

ExecutionInformation

specifications

Any of: PointCloudConversionSpecifications PointCloudOptimizationSpecifications TileMapOptimizationSpecifications VectorOptimizationSpecifications MeshSamplingSpecifications

List of inputs, outputs and options for the job, must be in sync with the type.

name

String, null

Name of the job.

type

JobTypes

iTwinId

String

iTwin Id for the job.

json

{
    "title": "Job",
    "required": [
        "iTwinId",
        "specifications",
        "type",
        "executionInfo",
        "id",
        "state",
        "userId"
    ],
    "type": "object",
    "properties": {
        "id": {
            "type": "string",
            "description": "Unique id of the job."
        },
        "state": {
            "$ref": "#/components/schemas/JobState"
        },
        "userId": {
            "type": "string",
            "description": "Identifier of the user that created the job."
        },
        "executionInfo": {
            "$ref": "#/components/schemas/ExecutionInformation"
        },
        "specifications": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/PointCloudConversionSpecifications"
                },
                {
                    "$ref": "#/components/schemas/PointCloudOptimizationSpecifications"
                },
                {
                    "$ref": "#/components/schemas/TileMapOptimizationSpecifications"
                },
                {
                    "$ref": "#/components/schemas/VectorOptimizationSpecifications"
                },
                {
                    "$ref": "#/components/schemas/MeshSamplingSpecifications"
                }
            ],
            "description": "List of inputs, outputs and options for the job, must be in sync with the type."
        },
        "name": {
            "maxLength": 256,
            "minLength": 3,
            "pattern": "^([^\"<>|:*?\\\\/\\u0000-\\u001f])+$",
            "type": "string",
            "description": "Name of the job.",
            "default": null,
            "nullable": true
        },
        "type": {
            "$ref": "#/components/schemas/JobTypes"
        },
        "iTwinId": {
            "type": "string",
            "description": "iTwin Id for the job."
        }
    },
    "additionalProperties": false,
    "description": "Job information."
}

Error

Contains error information.

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.

json

{
    "required": [
        "code",
        "message"
    ],
    "type": "object",
    "properties": {
        "code": {
            "type": "string",
            "description": "One of a server-defined set of error codes."
        },
        "message": {
            "type": "string",
            "description": "A human-readable representation of the error."
        },
        "target": {
            "type": "string",
            "description": "The target of the error.",
            "nullable": true
        }
    },
    "description": "Contains error information."
}

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.

error

Error

json

{
    "title": "Error Response",
    "required": [
        "error"
    ],
    "type": "object",
    "properties": {
        "error": {
            "$ref": "#/components/schemas/Error"
        }
    },
    "additionalProperties": false,
    "description": "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."
}

Job Response

job

Job

json

{
    "title": "Job Response",
    "required": [
        "job"
    ],
    "type": "object",
    "properties": {
        "job": {
            "$ref": "#/components/schemas/Job"
        }
    },
    "additionalProperties": false
}

Was this page helpful?