Skip to main content

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 price, volume, bounds etc.

  • Place an order
    When you agree with the size/price of your model you can place an order. (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​

Login and save the bearertoken/v2/Auth/LoginUpload a 3D model/v2/Model3D/UploadModelFileYou can receive the statusand calculated values/v2/Model3D/GetModelDataYou will get yourmodels: ID, volumes,bounds and pricesWhen you're happy with the price/sizeplace an order and save the order ID/v2/Order/CreateOrderUse the order ID to fetch statusand track & trace when shipped/v2/Order/GetOrderProcessingWaiting / in-progress statusFailed processingYou'll receive an error which tells you why it failed processing

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.

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)

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:

Happy coding! 🚀