Getting Started

Welcome to the Marketiger API! This guide will help you integrate your services with our 3D printing and order management platform. Whether you're building a custom integration, managing orders programmatically, or automating your workflow, this documentation will get you up and running quickly.

Overview

The Marketiger API is a RESTful API that allows you to:

• Upload models to the Marketiger HUB
  Upload models to HUB where they can be viewed

• Get Model status and quote
  After a model is processed successfully you will be able to fetch the final price, volume, bounds etc. Some projects can also use upload estimates for early pricing before processing is complete.

• Place an order
  When you agree with the size/price of your model you can place an order. Some projects can also place orders before processing finishes. (After uploading orders can also placed from the HUB)

• Fetch order status
  Retrieve the current status of your order and the track and trace when it's shipped.

• Fetch your projects
  Get the projects assigned to you and the needed data.

Workflow overview

Prerequisites

Before you can use the Marketiger API, you need:

• An account on Marketiger Hub (devhub.marketiger3d.com)
• Basic understanding of REST API concepts
• Ability to make HTTP requests (using curl, Postman, or your preferred HTTP client)

Project Assignment

Important: You can use the Marketiger API with just an account, but to upload models and place orders, you must have a project assigned to your account. This project is created and assigned by Marketiger. Once Marketiger has assigned a project to your Marketiger Hub account, you can use it to upload models and create orders.

For more information about projects and how they work, see the Projects documentation page.

Base URL

All API requests should be made to:

https://devapi.marketiger3d.com/v2

Quick Start

Step 1: Create an Account

If you don't already have an account:

1. Visit Marketiger Hub
2. Click on Register
3. Fill in your registration details
4. Verify your email address in your mailbox

Step 2: Ensure Project Assignment (For Uploading Models and Placing Orders)

If you plan to upload models or place orders, you'll need a project assigned to your account. Projects are created and assigned by Marketiger. If you don't have a project assigned yet, contact Marketiger to have one assigned to your account.

Note: You can authenticate and make some API calls without a project, but uploading models and placing orders require a project assignment.

Step 3: Authenticate

Authenticate using the login endpoint to receive your access token:

curl -X POST "https://devapi.marketiger3d.com/v2/Auth/Login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

Response:

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refreshToken": "refresh_token_here"
  }
}

Save the accessToken - you'll need it for all authenticated requests.

Step 4: Make Your First API Call

Use your access token to make authenticated requests:

curl -X GET "https://devapi.marketiger3d.com/v2/Project/GetProjects" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Common Use Cases

Uploading a 3D Model

To upload a 3D model, you'll need:

• A project ID (from GetProjects)
• A model file (supported types: obj, wrl, vrml, zip, fbx)

After the upload, your model will be queued for processing.
Once processing is complete, you can view the model in the HUB (make sure to select the correct project).
If you don't use the HUB, you can fetch the current status or calculated values using GetModelData.

If your project needs pricing before processing has finished, you can send estimatedBounds and estimatedVolume with the upload. Those estimate values are used for early pricing and are replaced by the processed values once analysis is complete. All prices returned by the API are in EUR and exclude VAT/tax.

See the UploadModelFile documentation for detailed examples.

Creating an Order

To have your 3D model printed, you need to place an order. This can be done in two ways:

• Log in to the HUB, add the models to your cart, and place an order
  
• Place an order using the API

To create an order, you'll need:

• A project ID (from GetProjects)
  
• Model IDs (from your project)
  
• Shipping details
  
• An order reference (your internal order ID)
  

Orders are normally placed after processing is complete, but some projects can create orders while models are still processing. Immediate payment flows such as Stripe Checkout and AfterPay still require final processed pricing, so pending models remain blocked in those cases.

See the Order Creation documentation for detailed examples.

Retrieving Model

To see the information for you processed model you can login to the hub or fetch it by using the API.

Get model information by ID:

curl -X GET "https://devapi.marketiger3d.com/v2/Model3D/GetModelData?modelId=YOUR_MODEL_ID" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Getting Projects

Retrieve all projects you have access to:

curl -X GET "https://devapi.marketiger3d.com/v2/Project/GetProjects" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Getting Folders

Get folders for a specific project:

curl -X GET "https://devapi.marketiger3d.com/v2/Folder/GetFolders?projectId=YOUR_PROJECT_ID" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Next Steps

Now that you understand the basics:

1. Read the Authentication guide for detailed authentication information
2. Review Requests & Conventions to understand API standards
3. Learn about Error Handling to handle errors gracefully
4. Explore the API Reference for endpoint documentation

Need Help?

If you encounter any issues:

• Check the Error Handling guide for common error scenarios
• Review the API Reference for detailed endpoint documentation
• Contact support through Marketiger Hub

Happy coding! 🚀