Get Base Asset

GET 
/api/v2/rawmodel/:id

Returns detailed information about an uploaded 3D model asset, including its processing status, metadata, and available downloads. Use this endpoint to monitor upload status or use our webhook to get notified when the upload is complete.

Key Field upload_status

The upload_status field tracks the model's progress through various processing stages.

Most important values are:

• "complete": All processing completed successfully
• "Importing Failed": General processing failure

Other values are:

• "incomplete": Initial state, upload not yet finished
• "waiting": Upload complete, waiting to start processing
• "unzipping": Extracting uploaded files
• "analysing": Analyzing model structure and contents
• "dataprepping": Preparing data for processing
• "dataprepping failed": Data preparation encountered an error
• "RapidQC": Model is in quality control phase
• "Importing Failed Import Limit Exceeded": Processing failed due to import limits

Error Handling:

1. Check upload_status first:

   • "complete" indicates successful processing

2. If has_errors is true:

   • Set to true if RapidPipeline 3D Processor creates a error.log file with errors
   • Check "error.log" in the downloads section for details

Model statistics (rpd_info.json): Once upload_status is "complete", downloads contains a signed URL for rpd_info.json. It holds the statistics of the base asset: bounding box, vertex/triangle counts, meshes, materials, textures and animations. See the example rpd_info.json.

Request

Path Parameters

id integerrequired
The id of the base asset
Example: 281

Responses

200

Success

application/json

Schema

Schema

object

Example (from schema)

{}

complete

Complete

{
  "data": {
    "id": 281,
    "name": "teapot",
    "external": false,
    "upload_status": "complete",
    "size": 438680,
    "created_at": "2021-02-08T16:59:52+01:00",
    "scale_factor": "10",
    "has_errors": false,
    "format": "glb",
    "tags": [],
    "downloads": {
      "error.log": "signed url for the error.log - Validation and processing errors",
      "info.log": "signed url for info.log - Processing information",
      "metrics.json": "signed url for the metrics.json - Processor run metadata",
      "rpd_info.json": "signed url for the rpd_info.json - Model statistics incl. animations",
      "teapot.glb": "signed url for the teapot.glb - Original uploaded file",
      "thumb.jpg": "signed url for the thumb.jpg - Thumbnail preview"
    }
  }
}

failed

Failed

{
  "data": {
    "id": 281,
    "upload_status": "Importing Failed"
  }
}

Loading...