Important!
The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.
GET materials¶a>
Retrieves a list of Forge print material.
Materials provide a variety of information about the substances used in 3D printing, including associated printing technology, color, extrusion details, and associated printer types.
Resource Information¶
| Method and URI | GET https:/ |
| Authentication Context | none |
| Data Format | JSON |
Request¶
Query String Parameters¶
Name |
Required |
Value Type |
Description |
|---|---|---|---|
| color | no | string | Color code of the material to return |
| technology | no | string | Technology type |
| composition | no | string | Composition |
Response¶
HTTP Status Code Summary¶
Code |
Message |
Meaning |
|---|---|---|
| 200 | OK | Successful |
| 400 | Bad Request | Invalid request. E.g., the request could not be parsed. |
| 401 | Unauthorized | Invalid authorization header. E.g., user is not logged in, or cannot access resource. |
| 404 | Not Found | Endpoint does not exist. |
| 422 | Unprocessable Entity | Semantic errors |
| 429 | Precondition Required | Request rate limit exceeded |
| 500 | Internal Server Error | An unknown error occurred on the server. |
Body Structure (200)¶
A successful response returns a JSON array of material objects.
For details about material objects, see the Field Guide section.
Examples¶
Successful Retreival of Materials List (200)¶
curl -X 'GET' -v 'https://developer.api.autodesk.com/ps/v1/printdb/materials'
{
"materials": [
{
"id": "0A296C18-8B51-42FF-A1BA-FFEC96AA946A",
"version": 1,
"name": "ABS Pink",
"technology": "FDM",
"printer_types": [
"F2F4B9B6-1D54-4A16-883E-B0385F27380C",
"3F64F6EC-A1DF-44AB-A22E-58C036F2F474",
"5D0D1DEC-DBB6-4041-AF61-EFC926D81452"
],
"cost": 48,
"filament_diameter": 1.75,
"filament_extrusion_to_flow_multiplier": 0.2,
"temp_extrude_default": 195,
"temp_min_extrude": 175,
"temp_max_extrude": 250,
"temp_bed": 120,
"extruder_fan_speed": 255,
"color": "ff8acc",
"protein_ref": 1234,
"manufacturer": "MakerBot",
"composition": "ABS",
"is_user": false
},
{
"id": "98654215-3610-497E-BA96-FDB97D867CF7",
"version": 1,
"name": "PLA Pink",
"technology": "FDM",
"printer_types": [
"F2F4B9B6-1D54-4A16-883E-B0385F27380C",
"3F64F6EC-A1DF-44AB-A22E-58C036F2F474",
"5D0D1DEC-DBB6-4041-AF61-EFC926D81452"
],
"cost": 48,
"filament_diameter": 1.75,
"filament_extrusion_to_flow_multiplier": 0.2,
"temp_extrude_default": 195,
"temp_min_extrude": 175,
"temp_max_extrude": 250,
"temp_bed": 120,
"extruder_fan_speed": 255,
"color": "ff8acc",
"protein_ref": 1234,
"manufacturer": "MakerBot",
"composition": "PLA",
"is_user": true
},
{
"id": "426F14FE-E6AF-496F-BBC7-7D6C0E16861D",
"version": 1,
"name": "PHOTORESIN BLACK",
"technology": "PHOTORESIN",
"printer_types": [
"7FAF097F-DB2E-45DC-9395-A30210E789AA"
],
"cost": 100,
"exposure_power": 1,
"cure_time_adhesion": 1,
"cure_time_intermediary": 1,
"cure_time_nominal_layers": 1,
"color": "0b0b0a",
"protein_ref": 1234,
"manufacturer": "Autodesk",
"composition": "urethane"
}
]
}
