Skip to main content

Block Model API

Version: 1.25.0

Get a Report Specification

GET
/blockmodel/orgs/{org_id}/workspaces/{workspace_id}/block-models/{bm_id}/report-specifications/{rs_id}

Get an individual Report Specification

Request

Path parameters

Example: "e478e8de-f6ba-4920-8c6e-0882e90f00e2"

ID of the Report Specification that this call is scoped to. Represented as a v4 UUID.

Example: "860be2f5-fe06-4c1b-ac8b-7d34d2b6d2ef"

ID of the workspace this call is scoped to. Represented as a v4 UUID.

Example: "bf1a040c-8c58-4bc2-bec2-c5ae7de8bd84"

ID of the organization this call is scoped to. Represented as a v4 UUID.

Example: "e3c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the block model this call is scoped to. Represented as a v4 UUID.

Responses

200

Successful Response

Default: true

Whether to automatically run this Report Specification when a new version is published

Example: {"i_minmax":{"max":1,"min":0},"j_minmax":{"max":1,"min":0},"k_minmax":{"max":1,"min":0}}

Bounding box for the report

Minimum and maximum values for the i column in the file

Maximum value for the column

Minimum value for the column

Minimum and maximum values for the j column in the file

Maximum value for the column

Minimum value for the column

Minimum and maximum values for the k column in the file

Maximum value for the column

Minimum value for the column

Minimum and maximum values for the x column in the file

Maximum value for the column

Minimum value for the column

Minimum and maximum values for the y column in the file

Maximum value for the column

Minimum value for the column

Minimum and maximum values for the z column in the file

Maximum value for the column

Minimum value for the column

null

Example: "e3c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the block model this Report Specification is associated with

Example: [{"col_id":"11c277c2-edc6-4a7a-8380-251dd19231f2","label":"Grade","values":["low","medium","high"]}]

Category columns within this Report Specification. If null or empty, the report will have a single total row for each cut-off.

Example: [{"aggregation":"SUM","col_id":"abc277c2-edc6-4a7a-8380-251dd19231f2","label":"Au content","output_unit_id":"kg"}]

Columns within this Report Specification

Examples: "SUM", "MASS_AVERAGE"

The aggregation method to use for the column

Example: "13c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the column in the block model

Example: "Au Content"

The human-readable label used to identify the column

Example: "kg"

ID of the unit to use for the column output

Example: "13c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the column to use for cut-off evaluation

Example: [0.5,1.5,5]

Values to use for cut-off evaluation

Example: "24c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the column to use for block density

Example: "kg/m3"

ID of the unit to use for block density. The unit must be of type MASS_PER_VOLUME.

Example: 2.5

Value to use for block density

Example: "Gold resource report for test purposes"

User-supplied description of the report

Example: "2021-01-01T00:00:00Z"

Creation date of the Report Result

Example: 2

Version ID of the version of the block model that the report was run on

Example: "t"

ID of the unit to use for total mass. The unit must be of type MASS

The human-readable label used to identify the report

Example: "USE"

Default: "IGNORE_BLOCK"

Policy for handling negative values in the report's cut-off or value columns

Example: "ZERO"

Default: "IGNORE_BLOCK"

Policy for handling null values in the report's cut-off or value columns

Example: "e3c277c2-edc6-4a7a-8380-251dd19231f2"

ID of the Report Specification

Revision number of this Report Specification

{
"autorun": true,
"bbox": {
"i_minmax": {
"max": 0,
"min": 0
},
"j_minmax": {
"max": 0,
"min": 0
},
"k_minmax": {
"max": 0,
"min": 0
}
},
"bm_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"categories": [
{
"col_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"label": "string",
"values": [
"string"
]
}
],
"columns": [
{
"aggregation": "SUM",
"col_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"label": "string",
"output_unit_id": "string"
}
],
"cutoff_col_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cutoff_values": [
0
],
"density_col_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"density_unit_id": "string",
"density_value": 0,
"description": "string",
"last_result_created_at": "2024-07-29T15:51:28.071Z",
"last_result_version_id": 0,
"mass_unit_id": "string",
"name": "string",
"negative_values_policy": "USE",
"null_values_policy": "ZERO",
"report_specification_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"revision": 0
}

401

Unauthorized

Example: "Invalid authentication credentials"

A human-readable explanation specific to this occurrence of the problem.

Example: 401

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "Invalid authentication credentials"

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/block-model-service/auth/unauthorized"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}

403

Forbidden

Example: "Permission denied"

A human-readable explanation specific to this occurrence of the problem.

Example: 403

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "Permission Denied"

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/block-model-service/auth/forbidden"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}

404

Not Found

Example: "Block model 11111111-2222-3333-4444-555555555555 not found."

A human-readable explanation specific to this occurrence of the problem.

Example: 404

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "Resource Not Found"

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/block-model-service/not-found"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}

410

Gone

Example: "The requested resource was not found."

A human-readable explanation specific to this occurrence of the problem.

Example: 410

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "Workspace soft deleted."

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/workspace/gone"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}

422

Unprocessable Content

Example: "1 validation error for 'HTTP Request' body -> block_rotation value is not a valid list (type=type_error.list)"

A human-readable explanation specific to this occurrence of the problem.

Example: 422

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "1 validation error for Request"

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/block-model-service/validation"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}

500

Internal Server Error

Example: "An error occurred"

A human-readable explanation specific to this occurrence of the problem.

Example: 500

The HTTP status code generated by the origin server for this occurrence of the problem.

Example: "Service Error"

A short, human-readable summary of the problem type.

Example: "https://seequent.com/error-codes/block-model-service/service"

A URI reference that is the primary identifier of the problem type.

{
"detail": "string",
"status": 0,
"title": "string",
"type": "string"
}