List Supported Formats
GET
formats
Returns an up-to-date list of supported translations. It lets you determine the types of derivatives supported for each source design file type. Furthermore, you can get it to retrieve only the translations that have been updated since a date you specify.
See the Supported Translation Formats table for more details.
Note: We keep adding new file formats to our supported translations list, constantly.
Resource Information
Method and URI | GET https://developer.api.autodesk.com/modelderivative/v2/designdata/formats |
Authentication Context | user context optional |
Required OAuth Scopes | none |
Data Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via
POST /authentication/v2/token |
If-Modified-Since string | Specifies a date in the Day of the week, DD Month YYYY HH:MM:SS GMT format. The response will contain only the formats modified since the specified date and time. If you specify an invalid date, the response will contain all supported formats. If no changes have been made after the specified date, the service returns HTTP status 304 , NOT MODIFIED.’ |
Accept-Encoding string | A comma separated list of the algorithms you want the response to be encoded in, specified in the order of preference.
If you specify |
* Required
Response
HTTP Status Code Summary
200 OK | Success. |
304 NOT MODIFIED | Supported formats have not changed since the date specified by the If-Modified-Since header. |
400 BAD REQUEST | Invalid request. |
401 UNAUTHORIZED | Invalid authorization header |
403 FORBIDDEN | Access denied regardless of authorization status. |
404 NOT FOUND | Endpoint does not exist. |
500 INTERNAL SERVICE ERROR | Unexpected service interruption. |
Response
HTTP Headers
Last-Modified time | Indicates the date and time the supported formats were last modified. |
x-ads-app-identifier string | The service identifier comprise service name, version and environment. |
x-ads-startup-time string | The service startup time with data format EEE MMM dd HH:mm:ss Z yyyy . |
x-ads-duration string | The request duration in milliseconds. |
x-ads-troubleshooting string | Provides information about the server failure. |
Response
Body Structure (200)
Expand all
formats object | A dictionary object that contains a collection of key/value pairs, where each pair represents the target file format and the corresponding source file formats. |
key string | A target file format. |
value array:string | A list of source design file formats that can be translated to the specified target file format. |
Example 1
Successful retrieval of supported formats (200).
Request
curl -X 'GET' \
-H 'Authorization: Bearer ztcaB2R0f92bsV6iV0bSDgwmSVaW' \
-v 'https://developer.api.autodesk.com/modelderivative/v2/designdata/formats'
Response
HTTP/1.1 200 OK
Date: Fri, 16 Jun 2023 08:54:37 GMT
Last-Modified: Tue, Mon, 29 May 2023 07:26:57 GMT
x-ads-startup-time: Tue Jul 07 07:13:03 UTC 2020
x-ads-duration: 1 ms
x-ads-app-identifier: platform-viewing-2023.05.01.321.f6784ca64-production
{
"formats": {
"dwg": [
"f2d",
"f3d",
"rvt",
"slddrw"
],
"fbx": [
"f3d"
],
"ifc": [
"rvt"
],
"iges": [
"f3d",
"fbx",
"iam",
"ipt",
"wire"
],
"obj": [
"asm",
"f3d",
"fbx",
"iam",
"ipt",
"neu",
"prt",
"sldasm",
"sldprt",
"smb",
"smt",
"step",
"stp",
"stpz",
"wire",
"x_b",
"x_t",
"asm\\.\\d+$",
"neu\\.\\d+$",
"prt\\.\\d+$"
],
"step": [
"f3d",
"fbx",
"iam",
"ipt",
"smb",
"smt",
"wire"
],
"stl": [
"f3d",
"fbx",
"iam",
"ipt",
"wire"
],
"svf": [
"3dm",
"3ds",
"a",
"asm",
"axm",
"brd",
"catpart",
"catproduct",
"cgr",
"collaboration",
"dae",
"ddx",
"ddz",
"dgk",
"dgn",
"dlv3",
"dmt",
"dwf",
"dwfx",
"dwg",
"dwt",
"dxf",
"emodel",
"exp",
"f3d",
"fbrd",
"fbx",
"fsch",
"g",
"gbxml",
"glb",
"gltf",
"iam",
"idw",
"ifc",
"ige",
"iges",
"igs",
"ipt",
"iwm",
"jt",
"max",
"model",
"mpf",
"msr",
"neu",
"nwc",
"nwd",
"obj",
"osb",
"par",
"pdf",
"pmlprj",
"pmlprjz",
"prt",
"psm",
"psmodel",
"rcc",
"rcs",
"rvm",
"rvt",
"sab",
"sat",
"sch",
"session",
"skp",
"sldasm",
"sldprt",
"smb",
"smt",
"ste",
"step",
"stl",
"stla",
"stlb",
"stp",
"stpz",
"vpb",
"vue",
"wire",
"x_b",
"x_t",
"xas",
"xpr",
"zip",
"asm\\.\\d+$",
"neu\\.\\d+$",
"prt\\.\\d+$"
],
"svf2": [
"3dm",
"3ds",
"a",
"asm",
"axm",
"brd",
"catpart",
"catproduct",
"cgr",
"collaboration",
"dae",
"ddx",
"ddz",
"dgk",
"dgn",
"dlv3",
"dmt",
"dwf",
"dwfx",
"dwg",
"dwt",
"dxf",
"emodel",
"exp",
"f3d",
"fbrd",
"fbx",
"fsch",
"g",
"gbxml",
"glb",
"gltf",
"iam",
"idw",
"ifc",
"ige",
"iges",
"igs",
"ipt",
"iwm",
"jt",
"max",
"model",
"mpf",
"msr",
"neu",
"nwc",
"nwd",
"obj",
"osb",
"par",
"pdf",
"pmlprj",
"pmlprjz",
"prt",
"psm",
"psmodel",
"rcc",
"rcs",
"rvm",
"rvt",
"sab",
"sat",
"sch",
"session",
"skp",
"sldasm",
"sldprt",
"smb",
"smt",
"ste",
"step",
"stl",
"stla",
"stlb",
"stp",
"stpz",
"vpb",
"vue",
"wire",
"x_b",
"x_t",
"xas",
"xpr",
"zip",
"asm\\.\\d+$",
"neu\\.\\d+$",
"prt\\.\\d+$"
],
"thumbnail": [
"3dm",
"3ds",
"a",
"asm",
"axm",
"axmf",
"brd",
"catpart",
"catproduct",
"cgr",
"collaboration",
"dae",
"ddx",
"ddz",
"dgk",
"dgn",
"dlv3",
"dmt",
"dwf",
"dwfx",
"dwg",
"dwgx",
"dwt",
"dxf",
"emodel",
"exp",
"f2d",
"f3d",
"fbrd",
"fbx",
"flbr",
"fprj",
"fsch",
"g",
"gbxml",
"glb",
"gltf",
"iam",
"idw",
"ifc",
"ige",
"iges",
"igs",
"ipt",
"iwm",
"jt",
"max",
"model",
"mpf",
"msr",
"neu",
"nwc",
"nwd",
"obj",
"osb",
"par",
"pdf",
"pmlprj",
"pmlprjz",
"prt",
"psm",
"psmodel",
"rcc",
"rcs",
"rva",
"rvm",
"rvt",
"sab",
"sat",
"sch",
"session",
"skp",
"sldasm",
"sldprt",
"smb",
"smt",
"ste",
"step",
"stl",
"stla",
"stlb",
"stp",
"stpz",
"vpb",
"vue",
"wire",
"x_b",
"x_t",
"xas",
"xpr",
"zip",
"asm\\.\\d+$",
"neu\\.\\d+$",
"prt\\.\\d+$"
]
}
}
Show More
Example 2
No changes since requested date (304).
Request
curl -X 'GET' \
-H 'Authorization: Bearer ztcaB2R0f92bsV6iV0bSDgwmSVaW' \
-H 'If-Modified-Since: Mon, 29 May 2023 07:26:57 GMT' \
-v 'https://developer.api.autodesk.com/modelderivative/v2/designdata/formats'
Response
Status Code: 304 Not Modified
Date: Fri, 16 Jun 2023 09:39:54 GMT
Last-Modified: Mon, 29 May 2023 07:26:57 GMT
x-ads-startup-time: Mon Jun 05 04:03:40 UTC 2023
x-ads-duration: 13 ms
x-ads-app-identifier: platform-viewing-2023.05.01.321.f6784ca64-production