GetModelData

API Playground

Retrieve a 3D model by its UUID. Bearer token authentication required.

Token *Your authentication token will be sent as: Authorization: Bearer <token>

Query Parameters

modelId *(string)UUID of the model to retrieve

Endpoint

GET https://devapi.marketiger3d.com/v2/Model3D/GetModelData

Authentication

This endpoint requires a Bearer token. Include the token in the Authorization header:

Authorization: Bearer <your_access_token>

Parameters

Name	Type	Location	Required	Description
modelId	string	query	Yes	UUID of the model to retrieve

Parameter Schema

Field	Type	Format	Required	Description
modelId	string	uuid	Yes	The unique identifier of the 3D model

Example Request

curl -X GET "https://devapi.marketiger3d.com/v2/Model3D/GetModelData?modelId=123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

fetch('https://devapi.marketiger3d.com/v2/Model3D/GetModelData?modelId=123e4567-e89b-12d3-a456-426614174000', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  },
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://devapi.marketiger3d.com/v2/Model3D/GetModelData?modelId=123e4567-e89b-12d3-a456-426614174000");
request.Headers.Add("Content-Type", "application/json");
request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_ACCESS_TOKEN");

var response = await client.SendAsync(request);
var responseContent = await response.Content.ReadAsStringAsync();
var result = JsonSerializer.Deserialize<ApiResponse>(responseContent);

Response

Success Response (200 OK) - Processing

{
  "success": true,
  "data": {
    "modelReady": false,
    "message": "Model is being processed",
    "model": {
      "id": "08de3d76-8a57-4342-88a2-210060b5f4f6",
      "status": 2,
      "uploaded": "2025-12-17T14:14:06.953808",
      "fileName": "Example.zip",
      "volume": null,
      "supportVolume": null,
      "bounds": null,
      "price": null,
      "parts": null,
      "scale": null,
      "image": null,
      "additionalImages": []
    }
  }
}

Success Response (200 OK) - Processed

{
  "success": true,
  "data": {
    "modelReady": true,
    "message": "Model processed succesfully",
    "model": {
      "id": "08de3d76-8a57-4342-88a2-210060b5f4f6",
      "status": 3,
      "uploaded": "2025-12-17T14:18:04.554611",
      "fileName": "Example.zip",
      "volume": 7.99805,
      "supportVolume": 1.32195,
      "bounds": "x:20 y:20 z:20",
      "price": 2385,
      "parts": 1,
      "scale": 1000,
      "image": "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_0.png",
      "additionalImages": [
        "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_0.png",
        "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_1.png",
        "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_2.png",
        "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_3.png",
        "https://s3.eu-north-1.amazonaws.com/.../08de3d77-17f5-4581-81d8-fcaa04701e93_4.png"
      ]
    }
  }
}

Response Schema

Field	Type	Description
success	boolean	Indicates if the request succeeded
data	object	Response data container
data.modelReady	boolean	Indicates whether the model has finished processing
data.message	string	Human-readable status message
data.model	object	The 3D model object

data.model

Field	Type	Description
id	string (UUID)	Unique identifier of the model
status	integer	Processing status of the model
uploaded	string (ISO 8601)	Upload or processing timestamp
fileName	string	Name of the uploaded file
volume	number	Model volume
supportVolume	number	Estimated support volume
bounds	string	Bounding box dimensions
price	number	Calculated model price
parts	integer	Number of detected parts
scale	number	Scale factor
image	string (URL)	Primary preview image (temporary, pre-signed)
additionalImages[]	string (URL)	Preview image URL

Note: The model object is stored under the lowercase key "model" (not "Model"). The response includes additional fields like Price.

Error Response (400 Bad Request)

{
  "success": false,
  "error": {
    "type": "AUTHENTICATION",
    "message": "Model not found"
  }
}

Error Response (401 Unauthorized)

{
  "success": false,
  "error": {
    "type": "AUTHENTICATION",
    "message": "Authentication required. Please provide a valid Bearer token."
  }
}

Error Response (404 Not Found)

{
  "success": false,
  "error": {
    "type": "NOT_FOUND",
    "message": "Model not found"
  }
}

Error Codes

Error Type	Status	Description
AUTHENTICATION	401	Missing or invalid Bearer token
AUTHENTICATION	400	Model not found or access denied
NOT_FOUND	404	Model with specified ID does not exist

Notes

• The response includes all fields from the model object (using IncludeFields = true in the JSON serializer)
• The modelId parameter must be a valid UUID format
• The model data structure may vary depending on the model type and properties
• Thumbnail URLs (imageUrl) and additional image URLs (additionalImages) expire after 5 minutes