KittyCAD's API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
The root endpoint / returns the OpenAPI specification for the API. It's handy if you want to use it to generate things.
https://api.kittycad.ioKittyCAD's API uses API keys, also referred to as API tokens, to authenticate requests. You can view and manage your API keys in your account on the KittyCAD website.
Authentication to the API is performed via Bearer Token Auth. Provide your API key as the token value. We will automatically add your token to the examples here if you are logged in.
All API requests must be made over HTTPS. API requests without authentication will fail.
$ curl --header "Authorization: Bearer $TOKEN" \
"https://api.kittycad.io/_meta/debug/session"KittyCAD uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with KittyCAD's servers (these are rare).
| 400 - Bad Request | The request failed could not authenticate, but the token existed. |
| 401 - Unauthorized | No valid API key provided. |
| 403 - Forbidden | The API key doesn't have permissions to perform the request. |
| 404 - Not Found | The requested resource doesn't exist. |
| 406 - Not Acceptable | The request was unacceptable, often due to missing a required parameter. |
| 500 - Internal Server Error | The server encountered an unexpected condition that prevented it from fulfilling the request. |
API calls that have been performed by users can be queried by the API. This is helpful for debugging as well as billing.
Get the status and output of an async operation.
This endpoint requires authentication by any KittyCAD user. It returns details of the requested async operation for the user.
If the user is not authenticated to view the specified async operation, then it is not returned.
Only KittyCAD employees with the proper access can view async operations for other users.
successful operation
$ curl "https://api.kittycad.io/async/operations/{id}" \
--header "Authorization: Bearer $TOKEN"{
"center_of_mass": [
24
],
"completed_at": "2023-03-19T18:23:34.799Z",
"created_at": "2023-03-19T18:23:34.799Z",
"error": "YN1jUv3kXpG5TdrE6dyo6xq7PAC6",
"id": "1c10df09-3edd-4a2b-9f2a-75da313820f7",
"src_format": "stl",
"started_at": "2023-03-19T18:23:34.799Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:34.799Z",
"user_id": "WuC3ux8jePRxyLvJIs1P08n"
}This endpoint requires authentication by any KittyCAD user. It returns the API calls for the authenticated user.
The API calls are returned in order of creation, with the most recently created API calls first.
Maximum number of items returned by a single call
Token returned by previous call to retrieve the subsequent page
Supported set of sort modes for scanning by created_at only.
Currently, we only support scanning in ascending order.
created-at-ascendingcreated-at-descendingsuccessful operation
list of items on this page of results
completed_atstringISO-8601optional
The date and time the API call completed billing.
created_atstringISO-8601optional
The date and time the API call was created.
durationintegerDurationoptional
The duration of the API call.
emailstringEmail Addressoptional
The user's email address.
The endpoint requested by the API call.
The unique identifier for the API call. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
ip_addressstringIP Addressoptional
The ip address of the origin.
If the API call was spawned from the litterbox or not.
The HTTP method requsted by the API call. The Request Method (VERB)
This type also contains constants for a number of common HTTP methods such as GET, POST, etc.
Currently includes 8 variants representing the 8 methods defined in RFC 7230, plus PATCH, and an Extension variant for all extensions.
OPTIONSGETPOSTPUTDELETEHEADTRACECONNECTPATCHEXTENSIONThe number of minutes the API call was billed for.
The origin of the API call.
The price of the API call.
The request body sent by the API call.
request_query_paramsstringoptional
The request query params sent by the API call.
The response body returned by the API call. We do not store this information if it is above a certain size.
started_atstringISO-8601optional
The date and time the API call started billing.
The status code returned by the API call.
stripe_invoice_item_idstringoptional
The Stripe invoice item ID of the API call if it is billable.
The API token that made the API call. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the API call was last updated.
The user agent of the request.
The ID of the user that made the API call.
token used to fetch the next page of results (if any)
$ curl "https://api.kittycad.io/user/api-calls" \
--header "Authorization: Bearer $TOKEN"{
"items": [
{
"completed_at": "2023-03-19T18:23:34.834Z",
"created_at": "2023-03-19T18:23:34.834Z",
"duration": 10,
"email": "0TTdhro9s@rjbZWbi.com",
"endpoint": "e1PPTrFYh1OTUD8Cy",
"id": "49e9c71f-9193-4433-b4bb-eed0a67d2cbc",
"ip_address": "192.0.2.211",
"litterbox": true,
"method": "PUT",
"minutes": 17,
"origin": "HwR3X8C249Jf",
"price": "90.27",
"request_body": "PxLQCQQ7FYNjcxfb",
"request_query_params": "DgrTIM4H",
"response_body": "sD1xlp2wHmAdbZHB1GeztJCQr",
"started_at": "2023-03-19T18:23:34.834Z",
"status_code": 23,
"stripe_invoice_item_id": "S8kPP7uG5Oj",
"token": "edb2f34a-35ff-4cc5-86b9-65c77d19f4b5",
"updated_at": "2023-03-19T18:23:34.834Z",
"user_agent": "J4Q5EhJVb3kBVd7D",
"user_id": "IxfTL6Rof14"
}
],
"next_page": "4HMIviqSGWB4mFzwx"
}This endpoint requires authentication by any KittyCAD user. It returns details of the requested API call for the user.
successful operation
completed_atstringISO-8601optional
The date and time the API call completed billing.
created_atstringISO-8601optional
The date and time the API call was created.
durationintegerDurationoptional
The duration of the API call.
emailstringEmail Addressoptional
The user's email address.
The endpoint requested by the API call.
The unique identifier for the API call. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
ip_addressstringIP Addressoptional
The ip address of the origin.
If the API call was spawned from the litterbox or not.
The HTTP method requsted by the API call. The Request Method (VERB)
This type also contains constants for a number of common HTTP methods such as GET, POST, etc.
Currently includes 8 variants representing the 8 methods defined in RFC 7230, plus PATCH, and an Extension variant for all extensions.
OPTIONSGETPOSTPUTDELETEHEADTRACECONNECTPATCHEXTENSIONThe number of minutes the API call was billed for.
The origin of the API call.
The price of the API call.
The request body sent by the API call.
request_query_paramsstringoptional
The request query params sent by the API call.
The response body returned by the API call. We do not store this information if it is above a certain size.
started_atstringISO-8601optional
The date and time the API call started billing.
The status code returned by the API call.
stripe_invoice_item_idstringoptional
The Stripe invoice item ID of the API call if it is billable.
The API token that made the API call. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the API call was last updated.
The user agent of the request.
The ID of the user that made the API call.
$ curl "https://api.kittycad.io/user/api-calls/{id}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:34.872Z",
"created_at": "2023-03-19T18:23:34.872Z",
"duration": 19,
"email": "ho1iun@ZAxTTuEF.com",
"endpoint": "GIs5jBR4gdXcWEkOk",
"id": "8b6ee586-1fba-45c9-a48d-80cdcf9254fb",
"ip_address": "192.0.2.66",
"litterbox": true,
"method": "OPTIONS",
"minutes": 14,
"origin": "I89QdJ5j",
"price": "58.79",
"request_body": "7jKM",
"request_query_params": "QSnFXPqKUjjOXRL1",
"response_body": "7sN8p63IAxUeyHH0q33QwOd8v",
"started_at": "2023-03-19T18:23:34.872Z",
"status_code": 13,
"stripe_invoice_item_id": "TsqJIyGPkF9nFBZNEaUPqLLe1m0mKn",
"token": "de2f7989-168f-4367-b6ae-e588859f69e6",
"updated_at": "2023-03-19T18:23:34.872Z",
"user_agent": "uLGoAv8m1AyWFGawyKYs9TzpBD338l",
"user_id": "9pj7BYHB"
}API tokens allow users to call the API outside of their session token that is used as a cookie in the user interface. Users can create, delete, and list their API tokens. But, of course, you need an API token to do this, so first be sure to generate one in the account UI.
This endpoint requires authentication by any KittyCAD user. It returns the API tokens for the authenticated user.
The API tokens are returned in order of creation, with the most recently created API tokens first.
Maximum number of items returned by a single call
Token returned by previous call to retrieve the subsequent page
Supported set of sort modes for scanning by created_at only.
Currently, we only support scanning in ascending order.
created-at-ascendingcreated-at-descendingsuccessful operation
list of items on this page of results
created_atstringISO-8601optional
The date and time the API token was created.
The unique identifier for the API token.
If the token is valid. We never delete API tokens, but we can mark them as invalid. We save them for ever to preserve the history of the API token.
The API token itself. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the API token was last updated.
The ID of the user that owns the API token.
token used to fetch the next page of results (if any)
$ curl "https://api.kittycad.io/user/api-tokens" \
--header "Authorization: Bearer $TOKEN"{
"items": [
{
"created_at": "2023-03-19T18:23:34.894Z",
"id": "4u81OFYhB1dUaAIOVsvzOM1lgIv",
"is_valid": false,
"token": "217f5bb2-4bca-4d0a-9ce8-3f8ef7de0948",
"updated_at": "2023-03-19T18:23:34.894Z",
"user_id": "zJPnedBvyMgg4sSwiQce6qwkFfEsSQ"
}
],
"next_page": "uVd1tp7"
}This endpoint requires authentication by any KittyCAD user. It creates a new API token for the authenticated user.
No parameters
successful creation
created_atstringISO-8601optional
The date and time the API token was created.
The unique identifier for the API token.
If the token is valid. We never delete API tokens, but we can mark them as invalid. We save them for ever to preserve the history of the API token.
The API token itself. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the API token was last updated.
The ID of the user that owns the API token.
$ curl -X POST "https://api.kittycad.io/user/api-tokens" \
--header "Authorization: Bearer $TOKEN"{
"created_at": "2023-03-19T18:23:34.905Z",
"id": "Jhi77yhE53eSh1azQhZEv",
"is_valid": false,
"token": "58b998ad-a004-4fb8-8cf7-0dec22dc3f21",
"updated_at": "2023-03-19T18:23:34.905Z",
"user_id": "3iinp87TNLLUWTPwo3TfN"
}This endpoint requires authentication by any KittyCAD user. It deletes the requested API token for the user.
This endpoint does not actually delete the API token from the database. It merely marks the token as invalid. We still want to keep the token in the database for historical purposes.
successful deletion
$ curl -X DELETE "https://api.kittycad.io/user/api-tokens/{token}" \
--header "Authorization: Bearer $TOKEN"This endpoint requires authentication by any KittyCAD user. It returns details of the requested API token for the user.
successful operation
created_atstringISO-8601optional
The date and time the API token was created.
The unique identifier for the API token.
If the token is valid. We never delete API tokens, but we can mark them as invalid. We save them for ever to preserve the history of the API token.
The API token itself. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the API token was last updated.
The ID of the user that owns the API token.
$ curl "https://api.kittycad.io/user/api-tokens/{token}" \
--header "Authorization: Bearer $TOKEN"{
"created_at": "2023-03-19T18:23:34.923Z",
"id": "wkryBkC37IAVd9",
"is_valid": false,
"token": "0e2e7db0-eec9-4848-92b8-1b3fae9695dd",
"updated_at": "2023-03-19T18:23:34.923Z",
"user_id": "Lnk6tcddqgtZlYgqDYyL"
}Constants. These are helpful as helpers.
The constant to get.
picspeed_of_lightGnewtonian_gravitationhplanck_constmu_0vacuum_permeabilityE_0vacuum_permitivityZ_0vacuum_impedancek_ecoulomb_consteelementary_chargem_eelectron_massm_pproton_massmu_Bbohr_magnetonNAavogadro_numRmolar_gas_constK_Bboltzmann_constFfaraday_constsigmastefan_boltzmann_constsuccessful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
The constant we are returning. The valid types of phys constant names.
picspeed_of_lightGnewtonian_gravitationhplanck_constmu_0vacuum_permeabilityE_0vacuum_permitivityZ_0vacuum_impedancek_ecoulomb_consteelementary_chargem_eelectron_massm_pproton_massmu_Bbohr_magnetonNAavogadro_numRmolar_gas_constK_Bboltzmann_constFfaraday_constsigmastefan_boltzmann_constcreated_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
started_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
The resulting value of the constant.
$ curl "https://api.kittycad.io/constant/physics/{constant}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:34.938Z",
"constant": "planck_const",
"created_at": "2023-03-19T18:23:34.939Z",
"error": "161GMtAdZm5lPnd",
"id": "0af7f08c-3b57-430f-a99f-e68999129989",
"started_at": "2023-03-19T18:23:34.939Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:34.939Z",
"user_id": "cF",
"value": 32
}CAD file operations. Create, get, and list CAD file conversions. More endpoints will be added here in the future as we build out transforms, etc on CAD models.
Convert a 2D Vector file from one format to another. If the file being converted is larger than 25MB, it will be performed asynchronously.
If the conversion is performed synchronously, the contents of the converted file (output) will be returned as a base64 encoded string.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The format the file should be converted to.
dxfjsonpngpssvgThe format of the file to convert.
dxfsvgsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The converted file, if completed, base64 encoded.
The output format of the file conversion. The valid types of Vector output file formats.
dxfjsonpngpssvgThe source format of the file conversion. The valid types of Vector source file formats.
dxfsvgstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/2d/vector/conversion/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:34.962Z",
"created_at": "2023-03-19T18:23:34.962Z",
"error": "BmA9e5QGrQPSASAR",
"id": "be4d6b3f-454d-49dd-b35a-5feb189e6e2f",
"output": "BASE64_ENCODED_BYTE_STRING",
"output_format": "png",
"src_format": "svg",
"started_at": "2023-03-19T18:23:34.962Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:34.962Z",
"user_id": "TaA"
}Convert a 3D file from one format to another. If the file being converted is larger than 25MB, it will be performed asynchronously.
If the conversion is performed synchronously, the contents of the converted file (output) will be returned as a base64 encoded string.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The format the file should be converted to.
daefbxfbxbobjobj_nomtlplystepstlThe format of the file to convert.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The converted file, if completed, base64 encoded.
The output format of the file conversion. The valid types of 3d output file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daefbxfbxbobjobj_nomtlplystepstlThe source format of the file conversion. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/3d/conversion/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:34.984Z",
"created_at": "2023-03-19T18:23:34.984Z",
"error": "rygRGBSXl2OBpODqxNcWUUR",
"id": "a09c3042-7e94-4e11-bc25-921e5f5e829e",
"output": "BASE64_ENCODED_BYTE_STRING",
"output_format": "stl",
"src_format": "obj_nomtl",
"started_at": "2023-03-19T18:23:34.984Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:34.984Z",
"user_id": ""
}Get the center of mass of an object in a CAD file. If the file is larger than 25MB, it will be performed asynchronously.
Does the same as the center_of_mass_with_uniform_density endpoint; except, this has a redundant material_density value. Kept for legacy in this version.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
material_densitynumberrequired
The material density.
The format of the file.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
The resulting center of mass.
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
material_densitynumberoptional
The material density as denoted by the user.
The source format of the file. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/center-of-mass" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"center_of_mass": [
29
],
"completed_at": "2023-03-19T18:23:35.004Z",
"created_at": "2023-03-19T18:23:35.004Z",
"error": "OW27AaqmlD",
"id": "a9b4788b-ec40-4a9d-9501-f6a6ad3eb56c",
"material_density": 22,
"src_format": "obj_zip",
"started_at": "2023-03-19T18:23:35.004Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.004Z",
"user_id": "No"
}Convert a CAD file from one format to another. If the file being converted is larger than 25MB, it will be performed asynchronously.
If the conversion is performed synchronously, the contents of the converted file (output) will be returned as a base64 encoded string.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The format the file should be converted to.
daedxffbxfbxbjsonobjobj_nomtlplystepstlsvgThe format of the file to convert.
daedxffbxobj_zipobjobj_nomtlplystepstlsvgsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The converted file, if completed, base64 encoded.
The output format of the file conversion. The valid types of output file formats.
daedxffbxfbxbjsonobjobj_nomtlplystepstlsvgThe source format of the file conversion. The valid types of source file formats.
daedxffbxobj_zipobjobj_nomtlplystepstlsvgstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/conversion/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:35.027Z",
"created_at": "2023-03-19T18:23:35.027Z",
"error": "anozqOQ8KfWDbjODMOkhsPA3qUa",
"id": "1492db19-097e-452d-9e37-0af006331aa2",
"output": "BASE64_ENCODED_BYTE_STRING",
"output_format": "obj_nomtl",
"src_format": "obj",
"started_at": "2023-03-19T18:23:35.027Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.027Z",
"user_id": "Jsc6sCEa1SD"
}Get the status and output of an async file conversion.
This endpoint requires authentication by any KittyCAD user. It returns details of the requested file conversion for the user.
If the user is not authenticated to view the specified file conversion, then it is not returned.
Only KittyCAD employees with the proper access can view file conversions for other users.
successful operation
$ curl "https://api.kittycad.io/file/conversions/{id}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.035Z",
"created_at": "2023-03-19T18:23:35.035Z",
"error": "p2cCv",
"id": "7e140524-00df-40d1-95e4-c002c51a5c78",
"output": "BASE64_ENCODED_BYTE_STRING",
"output_format": "json",
"src_format": "svg",
"started_at": "2023-03-19T18:23:35.036Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.036Z",
"user_id": "SX3"
}Get the density of an object in a CAD file. If the file is larger than 25MB, it will be performed asynchronously.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The material mass.
The format of the file.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The resulting density.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The material mass as denoted by the user.
The source format of the file. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/density" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:35.056Z",
"created_at": "2023-03-19T18:23:35.056Z",
"density": 16,
"error": "yNAjWGwvkTPFIb0sgknAueht1S8k9l",
"id": "686c6701-8a21-4d07-bb25-e47547330bbd",
"material_mass": 28,
"src_format": "stl",
"started_at": "2023-03-19T18:23:35.056Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.056Z",
"user_id": "mgPH6g5Xg0NDQJ7"
}Get the mass of an object in a CAD file. If the file is larger than 25MB, it will be performed asynchronously.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
material_densitynumberrequired
The material density.
The format of the file.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The resulting mass.
material_densitynumberoptional
The material density as denoted by the user.
The source format of the file. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/mass" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:35.075Z",
"created_at": "2023-03-19T18:23:35.075Z",
"error": "6",
"id": "0e1f24db-8f5f-465a-9ee6-91e9ef502f30",
"mass": 10,
"material_density": 9,
"src_format": "ply",
"started_at": "2023-03-19T18:23:35.075Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.075Z",
"user_id": "icWI8BDfZXI6syCp1WmUFXY8WE"
}Get the surface area of an object in a CAD file. If the file is larger than 25MB, it will be performed asynchronously.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The format of the file.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The source format of the file. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedThe resulting surface area.
updated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl -X POST "https://api.kittycad.io/file/surface-area" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:35.092Z",
"created_at": "2023-03-19T18:23:35.092Z",
"error": "A",
"id": "af68f401-960b-458e-a923-068286119710",
"src_format": "dxf",
"started_at": "2023-03-19T18:23:35.092Z",
"status": "In Progress",
"surface_area": 7,
"updated_at": "2023-03-19T18:23:35.092Z",
"user_id": "qqMnK32Scy0bt6Wjb8Q8fznZw"
}Get the volume of an object in a CAD file. If the file is larger than 25MB, it will be performed asynchronously.
If the operation is performed asynchronously, the id of the operation will be returned. You can use the id returned from the request to get status information about the async operation from the /async/operations/{id} endpoint.
The format of the file.
daedxffbxobj_zipobjobj_nomtlplystepstlsuccessful creation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The source format of the file. The valid types of 3d source file formats, can include formats that use suplimentary files. For example, the OBJ format can use a MTL file.
daedxffbxobj_zipobjobj_nomtlplystepstlstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
The resulting volume.
$ curl -X POST "https://api.kittycad.io/file/volume" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/octet-stream" \
--data-binary "@path/to/file"{
"completed_at": "2023-03-19T18:23:35.104Z",
"created_at": "2023-03-19T18:23:35.104Z",
"error": "D8H5QGy0A0X53BcoNA",
"id": "84ad1fd9-bf93-493c-b2ca-bc49f0b09222",
"src_format": "stl",
"started_at": "2023-03-19T18:23:35.104Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.104Z",
"user_id": "214mXAuGKqr2Z7Wem7Qh0I",
"volume": 22
}Get the status and output of an async file conversion. If completed, the contents of the converted file (output) will be returned as a base64 encoded string.
This endpoint requires authentication by any KittyCAD user. It returns details of the requested file conversion for the user.
successful operation
$ curl "https://api.kittycad.io/user/file/conversions/{id}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.108Z",
"created_at": "2023-03-19T18:23:35.108Z",
"error": "A4",
"id": "69c64b43-7586-41bc-8e79-24093154faec",
"output": "BASE64_ENCODED_BYTE_STRING",
"output_format": "svg",
"src_format": "obj_nomtl",
"started_at": "2023-03-19T18:23:35.108Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.108Z",
"user_id": "IXukjgnE4gnGn9v2MGio6HMIf"
}Meta information about the API.
No parameters
successful operation
$ curl "https://api.kittycad.io/" \
--header "Authorization: Bearer $TOKEN"$ curl "https://api.kittycad.io/ping" \
--header "Authorization: Bearer $TOKEN"{
"message": "sGuM9dT"
}Operations around payments and billing.
This includes billing address, phone, and name.
This endpoint requires authentication by any KittyCAD user. It deletes the payment information for the authenticated user.
No parameters
successful deletion
$ curl -X DELETE "https://api.kittycad.io/user/payment" \
--header "Authorization: Bearer $TOKEN"This includes billing address, phone, and name.
This endpoint requires authentication by any KittyCAD user. It gets the payment information for the authenticated user.
No parameters
successful operation
The customer's address. The struct that is used to create a new record. This is automatically generated and has all the same fields as the main struct only it is missing the id.
The city component.
The country component.
The state component.
The first street component.
The second street component.
The user ID that this address belongs to.
The zip component.
balancenumberUSD Priceoptional
Current balance, if any, being stored on the customer in the payments service.
If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that will be added to their next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account as invoices are finalized.
created_atstringISO-8601optional
Time at which the object was created.
Three-letter ISO code for the currency the customer can be charged in for recurring billing purposes. Currency is the list of supported currencies.
For more details see https://support.stripe.com/questions/which-currencies-does-stripe-support.
aedafnallamdangaoaarsaudawgaznbambbdbdtbgnbifbmdbndbobbrlbsdbwpbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpetbeurfjdfkpgbpgelgipgmdgnfgtqgydhkdhnlhrkhtghufidrilsinriskjmdjpykeskgskhrkmfkrwkydkztlaklbplkrlrdlslltllvlmadmdlmgamkdmntmopmromurmvrmwkmxnmyrmznnadngnnionoknprnzdpabpenpgkphppkrplnpygqarronrsdrubrwfsarsbdscrseksgdshpsllsossrdstdsvcszlthbtjstoptryttdtwdtzsuahugxusduyuuzsvefvndvuvwstxafxcdxofxpfyerzarzmwWhen the customer's latest invoice is billed by charging automatically, delinquent is true if the invoice's latest charge failed.
When the customer's latest invoice is billed by sending an invoice, delinquent is true if the invoice isn't paid by its due date. If an invoice is marked uncollectible by dunning, delinquent doesn't get reset to false.
emailstringEmail Addressoptional
The customer's email address.
Unique identifier for the object.
Set of key-value pairs.
The customer's full name or business name.
phonestringPhone Numberoptional
The customer's phone number.
$ curl "https://api.kittycad.io/user/payment" \
--header "Authorization: Bearer $TOKEN"{
"address": {
"city": "TOL",
"country": "hFO80bQpAI7naQbfXeZ8avRsxi",
"state": "zUt1330tUFKtVg26eLH",
"street1": "Zjf",
"street2": "WdfXHLSdWIQRbpqX1IbaWfDP7",
"user_id": "7M4FL6kVaRkvtZqMSLr7wEU8zMkRC",
"zip": "mfSont3K2FuO6MdBRYVlVkew3a0Fj"
},
"balance": "53.02",
"created_at": "2023-03-19T18:23:35.136Z",
"currency": "ltl",
"delinquent": false,
"email": "uxA2mA3@.com",
"id": "zbBvoyCgPULAPpKKD",
"metadata": {},
"name": "iG9vmqABSaty7yERI",
"phone": "+1-935-139-9199"
}This includes billing address, phone, and name.
This endpoint requires authentication by any KittyCAD user. It creates the payment information for the authenticated user.
bodyapplication/jsonobjectoptional
The billing information for payments.
The address of the customer. The struct that is used to create a new record. This is automatically generated and has all the same fields as the main struct only it is missing the id.
The city component.
The country component.
The state component.
The first street component.
The second street component.
The user ID that this address belongs to.
The zip component.
The name of the customer.
phonestringPhone Numberoptional
The phone for the customer.
successful creation
The customer's address. The struct that is used to create a new record. This is automatically generated and has all the same fields as the main struct only it is missing the id.
The city component.
The country component.
The state component.
The first street component.
The second street component.
The user ID that this address belongs to.
The zip component.
balancenumberUSD Priceoptional
Current balance, if any, being stored on the customer in the payments service.
If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that will be added to their next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account as invoices are finalized.
created_atstringISO-8601optional
Time at which the object was created.
Three-letter ISO code for the currency the customer can be charged in for recurring billing purposes. Currency is the list of supported currencies.
For more details see https://support.stripe.com/questions/which-currencies-does-stripe-support.
aedafnallamdangaoaarsaudawgaznbambbdbdtbgnbifbmdbndbobbrlbsdbwpbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpetbeurfjdfkpgbpgelgipgmdgnfgtqgydhkdhnlhrkhtghufidrilsinriskjmdjpykeskgskhrkmfkrwkydkztlaklbplkrlrdlslltllvlmadmdlmgamkdmntmopmromurmvrmwkmxnmyrmznnadngnnionoknprnzdpabpenpgkphppkrplnpygqarronrsdrubrwfsarsbdscrseksgdshpsllsossrdstdsvcszlthbtjstoptryttdtwdtzsuahugxusduyuuzsvefvndvuvwstxafxcdxofxpfyerzarzmwWhen the customer's latest invoice is billed by charging automatically, delinquent is true if the invoice's latest charge failed.
When the customer's latest invoice is billed by sending an invoice, delinquent is true if the invoice isn't paid by its due date. If an invoice is marked uncollectible by dunning, delinquent doesn't get reset to false.
emailstringEmail Addressoptional
The customer's email address.
Unique identifier for the object.
Set of key-value pairs.
The customer's full name or business name.
phonestringPhone Numberoptional
The customer's phone number.
$ curl -X POST "https://api.kittycad.io/user/payment" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json" \
--data '{
"address": {
"city": "uAU2STNth",
"country": "8zD6cMWjPdmZp9Gx35xANes",
"state": "9E44PKAher3Cf9x4I6aiDjUV",
"street1": "PZ9URQuxzYdg4R",
"street2": "I3n521lLZt",
"user_id": "kOW3PoL648nISQ",
"zip": "wKSKGx7IDNyYUD5uyydkDn"
},
"name": "kC6AsYHqZCgMRD45CN",
"phone": "+1-294-660-2062"
}'{
"address": {
"city": "UOvJGb",
"country": "TadBS54Zf",
"state": "IdGUiqPFOMS09ZwIrsBAp9y",
"street1": "Wzw6ZHa2x2CQmtnh8v1cXaxlxVrh",
"street2": "3FmGx8KedXpL9szk",
"user_id": "BEFdIWLICUm9ZvHVPoYRvhIJ",
"zip": "91x55Xc6JLVdfm5A2YZK5"
},
"balance": "41.74",
"created_at": "2023-03-19T18:23:35.162Z",
"currency": "mop",
"delinquent": false,
"email": "DYxq@ByVatlTne.com",
"id": "fbLOpeHf5FUOVzj9msSALFTquRBX",
"metadata": {},
"name": "18Q9o6ErDGV1nTC14gluC4X",
"phone": "+1-667-919-6597"
}This includes billing address, phone, and name.
This endpoint requires authentication by any KittyCAD user. It updates the payment information for the authenticated user.
bodyapplication/jsonobjectoptional
The billing information for payments.
The address of the customer. The struct that is used to create a new record. This is automatically generated and has all the same fields as the main struct only it is missing the id.
The city component.
The country component.
The state component.
The first street component.
The second street component.
The user ID that this address belongs to.
The zip component.
The name of the customer.
phonestringPhone Numberoptional
The phone for the customer.
successful operation
The customer's address. The struct that is used to create a new record. This is automatically generated and has all the same fields as the main struct only it is missing the id.
The city component.
The country component.
The state component.
The first street component.
The second street component.
The user ID that this address belongs to.
The zip component.
balancenumberUSD Priceoptional
Current balance, if any, being stored on the customer in the payments service.
If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that will be added to their next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account as invoices are finalized.
created_atstringISO-8601optional
Time at which the object was created.
Three-letter ISO code for the currency the customer can be charged in for recurring billing purposes. Currency is the list of supported currencies.
For more details see https://support.stripe.com/questions/which-currencies-does-stripe-support.
aedafnallamdangaoaarsaudawgaznbambbdbdtbgnbifbmdbndbobbrlbsdbwpbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpetbeurfjdfkpgbpgelgipgmdgnfgtqgydhkdhnlhrkhtghufidrilsinriskjmdjpykeskgskhrkmfkrwkydkztlaklbplkrlrdlslltllvlmadmdlmgamkdmntmopmromurmvrmwkmxnmyrmznnadngnnionoknprnzdpabpenpgkphppkrplnpygqarronrsdrubrwfsarsbdscrseksgdshpsllsossrdstdsvcszlthbtjstoptryttdtwdtzsuahugxusduyuuzsvefvndvuvwstxafxcdxofxpfyerzarzmwWhen the customer's latest invoice is billed by charging automatically, delinquent is true if the invoice's latest charge failed.
When the customer's latest invoice is billed by sending an invoice, delinquent is true if the invoice isn't paid by its due date. If an invoice is marked uncollectible by dunning, delinquent doesn't get reset to false.
emailstringEmail Addressoptional
The customer's email address.
Unique identifier for the object.
Set of key-value pairs.
The customer's full name or business name.
phonestringPhone Numberoptional
The customer's phone number.
$ curl -X PUT "https://api.kittycad.io/user/payment" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json" \
--data '{
"address": {
"city": "dMnQY0sTfGK8le",
"country": "HE5BpGYF",
"state": "icay1ZiZ1cFRY2smPYw6",
"street1": "DSXj1xJsUSspcnfOBAwkgc340U",
"street2": "eHNqZRf8IseM14ypNpIF9CATPA2K",
"user_id": "XfJgkOTo4aiY2fCcnO91oHaB",
"zip": "F3N1Gb674rhjsGcfGIGF"
},
"name": "LWjc0S",
"phone": "+1-963-265-9378"
}'{
"address": {
"city": "6xkwKUh820",
"country": "k44w56W9bJbCc0dkScpOzh8AIyMoId",
"state": "LTNcpiTQFoQ03wHR2I7FYifCL3HEc",
"street1": "eZx6BJ5x2u4WBU1CXnOGfU",
"street2": "4Bn2BzYorM",
"user_id": "b6TEHr",
"zip": "rb7KilsGvSExr5Vksgaj"
},
"balance": "30.95",
"created_at": "2023-03-19T18:23:35.195Z",
"currency": "vnd",
"delinquent": false,
"email": "ZnQbEZQVT@WdZGcOvXJL.com",
"id": "gIWGN",
"metadata": {},
"name": "aBWoieM5ax",
"phone": "+1-191-104-6792"
}This endpoint requires authentication by any KittyCAD user. It gets the balance information for the authenticated user.
No parameters
successful operation
created_atstringISO-8601optional
The date and time the balance was created.
The unique identifier for the balance. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
monthly_credits_remainingnumberUSD Priceoptional
The monthy credits remaining in the balance. This gets re-upped every month, but if the credits are not used for a month they do not carry over to the next month. It is a stable amount granted to the user per month.
pre_pay_cash_remainingnumberUSD Priceoptional
The amount of pre-pay cash remaining in the balance. This number goes down as the user uses their pre-paid credits. The reason we track this amount is if a user ever wants to withdraw their pre-pay cash, we can use this amount to determine how much to give them. Say a user has $100 in pre-paid cash, their bill is worth, $50 after subtracting any other credits (like monthly etc.) Their bill is $50, their pre-pay cash remaining will be subtracted by 50 to pay the bill and their pre_pay_credits_remaining will be subtracted by 50 to pay the bill. This way if they want to withdraw money after, they can only withdraw $50 since that is the amount of cash they have remaining.
pre_pay_credits_remainingnumberUSD Priceoptional
The amount of credits remaining in the balance. This is typically the amount of cash * some multiplier they get for pre-paying their account. This number lowers every time a bill is paid with the balance. This number increases every time a user adds funds to their balance. This may be through a subscription or a one off payment.
total_duenumberUSD Priceoptional
This includes any outstanding, draft, or open invoices and any pending invoice items. This does not include any credits the user has on their account.
updated_atstringISO-8601optional
The date and time the balance was last updated.
The user ID the balance belongs to.
$ curl "https://api.kittycad.io/user/payment/balance" \
--header "Authorization: Bearer $TOKEN"{
"created_at": "2023-03-19T18:23:35.212Z",
"id": "9a408ab0-ce08-4d2e-9932-12b43dd79e1d",
"monthly_credits_remaining": "53.14",
"pre_pay_cash_remaining": "5.71",
"pre_pay_credits_remaining": "5.55",
"total_due": "100.44",
"updated_at": "2023-03-19T18:23:35.212Z",
"user_id": "wPldRtU3r9nVZWfj69Shonxlepf"
}This endpoint requires authentication by any KittyCAD user. It lists invoices for the authenticated user.
No parameters
successful operation
$ curl "https://api.kittycad.io/user/payment/invoices" \
--header "Authorization: Bearer $TOKEN"[
{
"amount_due": "77.68",
"amount_paid": "67.57",
"amount_remaining": "54.07",
"attempt_count": 12,
"attempted": false,
"created_at": "2023-03-19T18:23:35.214Z",
"currency": "isk",
"customer_email": "944@FiK26ctZ.com",
"customer_id": "7YRq",
"default_payment_method": "kcFiAnZN3AByxQGQgOyF",
"description": "1Y6P3nMxoQ",
"id": "3a7quCuIIYbzny0kuWB5SjaORQJive",
"lines": [
{
"amount": "68.08",
"currency": "mro",
"description": "agcbhKp4Pk5lJbs",
"id": "VFP",
"invoice_item": "eaBuRLfgg58XwvJ9usxaV1kNEA0",
"metadata": {}
}
],
"metadata": {},
"number": "8B3OCrCMUIbS0IZwNq9GsIb",
"paid": true,
"pdf": "https://41CGL.7PdVaZ.com//fjPjVEQm",
"receipt_number": "Dgyee9nYKdWMoLa1FwxaGLZ7eA93",
"statement_descriptor": "fKPVUQrrMCkd",
"status": "draft",
"subtotal": "31.95",
"tax": "21.65",
"total": "81.20",
"url": "https://0Bi.WObfsv6pP0.com/LlizefyW/mXD"
}
]This endpoint requires authentication by any KittyCAD user. It lists payment methods for the authenticated user.
No parameters
successful operation
$ curl "https://api.kittycad.io/user/payment/methods" \
--header "Authorization: Bearer $TOKEN"[
{
"billing_info": {
"address": {
"city": "lr7ymxGW2JQZSeSnY",
"country": "wdXcDJCUYcS",
"state": "2e9bFf",
"street1": "nLzPz3jdEtmcesn67bJn0I0oW",
"street2": "zZB",
"user_id": "DWJvK8",
"zip": ""
},
"name": "R3CFgqixSJ",
"phone": "+1-832-120-8760"
},
"card": {
"brand": "vz6fs60RG1jilZIrsq79Q",
"checks": {
"address_line1_check": "EXapScTH",
"address_postal_code_check": "00coUeIcKB6",
"cvc_check": "DCzhEBx92u9kZj2RZN"
},
"country": "gQeGoTbVxcxehMafhsG4rb",
"exp_month": 13,
"exp_year": 26,
"fingerprint": "F7DPGatwJD",
"funding": "brJSuERAP8QQCHOphwOOLnqa",
"last4": "aVTPGhibYLF54atBizTiprBeBeB"
},
"created_at": "2023-03-19T18:23:35.220Z",
"id": "G1L0ESO0trMq5q",
"metadata": {},
"type": "card"
}
]Sessions allow users to call the API from their session cookie in the browser.
This endpoint requires authentication by any KittyCAD user. It returns details of the requested API token for the user.
successful operation
created_atstringISO-8601optional
The date and time the session was created.
The date and time the session expires.
The unique identifier for the session.
session_tokenstringUUIDoptional
The session token. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
updated_atstringISO-8601optional
The date and time the session was last updated.
The user ID of the user that the session belongs to.
$ curl "https://api.kittycad.io/user/session/{token}" \
--header "Authorization: Bearer $TOKEN"{
"created_at": "2023-03-19T18:23:35.233Z",
"expires": "2023-03-19T18:23:35.233Z",
"id": "Tp",
"session_token": "f6fbbdc2-37ff-407e-a5d2-dc9fd12f7926",
"updated_at": "2023-03-19T18:23:35.233Z",
"user_id": "y2iLPTz0YtQx6sFWZetAF5erx7"
}Unit conversion operations.
GET/unit/conversion/acceleration/{src_format}/{output_format}
GET/unit/conversion/angle/{src_format}/{output_format}
GET/unit/conversion/angular-velocity/{src_format}/{output_format}
GET/unit/conversion/area/{src_format}/{output_format}
GET/unit/conversion/charge/{src_format}/{output_format}
GET/unit/conversion/concentration/{src_format}/{output_format}
GET/unit/conversion/data-transfer-rate/{src_format}/{output_format}
GET/unit/conversion/data/{src_format}/{output_format}
GET/unit/conversion/density/{src_format}/{output_format}
GET/unit/conversion/energy/{src_format}/{output_format}
GET/unit/conversion/force/{src_format}/{output_format}
GET/unit/conversion/illuminance/{src_format}/{output_format}
GET/unit/conversion/length/{src_format}/{output_format}
GET/unit/conversion/magnetic-field-strength/{src_format}/{output_format}
GET/unit/conversion/magnetic-flux/{src_format}/{output_format}
GET/unit/conversion/mass/{src_format}/{output_format}
GET/unit/conversion/metric/cubed/{src_format}/{output_format}
GET/unit/conversion/metric/power/{src_format}/{output_format}
GET/unit/conversion/metric/squared/{src_format}/{output_format}
GET/unit/conversion/power/{src_format}/{output_format}
GET/unit/conversion/pressure/{src_format}/{output_format}
GET/unit/conversion/radiation/{src_format}/{output_format}
GET/unit/conversion/radioactivity/{src_format}/{output_format}
GET/unit/conversion/solid-angle/{src_format}/{output_format}
GET/unit/conversion/temperature/{src_format}/{output_format}
GET/unit/conversion/time/{src_format}/{output_format}
GET/unit/conversion/velocity/{src_format}/{output_format}
Convert an acceleration unit value to another acceleration unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
meters_per_second_squaredfeet_per_second_squaredstandard_gravityThe source format of the unit.
meters_per_second_squaredfeet_per_second_squaredstandard_gravityThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of acceleration unit formats.
meters_per_second_squaredfeet_per_second_squaredstandard_gravityThe source format of the unit conversion. The valid types of acceleration unit formats.
meters_per_second_squaredfeet_per_second_squaredstandard_gravitystarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/acceleration/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.249Z",
"created_at": "2023-03-19T18:23:35.249Z",
"error": "N63",
"id": "1e47b0a8-7bea-410a-bd0b-c9f9983c3a92",
"input": 26,
"output": 19,
"output_format": "meters_per_second_squared",
"src_format": "standard_gravity",
"started_at": "2023-03-19T18:23:35.249Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.249Z",
"user_id": "nvs"
}Convert an angle unit value to another angle unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
radiandegreearcminutearcsecondmilliarcsecondturngradianThe source format of the unit.
radiandegreearcminutearcsecondmilliarcsecondturngradianThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of angle formats.
radiandegreearcminutearcsecondmilliarcsecondturngradianThe source format of the unit conversion. The valid types of angle formats.
radiandegreearcminutearcsecondmilliarcsecondturngradianstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/angle/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.264Z",
"created_at": "2023-03-19T18:23:35.264Z",
"error": "jdUTWs8D",
"id": "c374e16f-d340-4cfe-b4bd-3cab500cc298",
"input": 7,
"output": 5,
"output_format": "arcsecond",
"src_format": "turn",
"started_at": "2023-03-19T18:23:35.264Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.264Z",
"user_id": "cnQGG9yMkXl"
}Convert an angular velocity unit value to another angular velocity unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
radians_per_seconddegrees_per_secondrevolutions_per_minutemilliarcseconds_per_yearThe source format of the unit.
radians_per_seconddegrees_per_secondrevolutions_per_minutemilliarcseconds_per_yearThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of angular velocity unit formats.
radians_per_seconddegrees_per_secondrevolutions_per_minutemilliarcseconds_per_yearThe source format of the unit conversion. The valid types of angular velocity unit formats.
radians_per_seconddegrees_per_secondrevolutions_per_minutemilliarcseconds_per_yearstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/angular-velocity/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.280Z",
"created_at": "2023-03-19T18:23:35.280Z",
"error": "emlVB",
"id": "28924030-597f-43b4-b0c1-b6fc49e4f25b",
"input": 9,
"output": 22,
"output_format": "degrees_per_second",
"src_format": "milliarcseconds_per_year",
"started_at": "2023-03-19T18:23:35.280Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.280Z",
"user_id": "Ua6gT8v6pD8nhCX2UGdth4JJI"
}Convert an area unit value to another area unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
square_metersquare_footsquare_inchsquare_milesquare_kilometerhectareacreThe source format of the unit.
square_metersquare_footsquare_inchsquare_milesquare_kilometerhectareacreThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of area unit formats.
square_metersquare_footsquare_inchsquare_milesquare_kilometerhectareacreThe source format of the unit conversion. The valid types of area unit formats.
square_metersquare_footsquare_inchsquare_milesquare_kilometerhectareacrestarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/area/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.293Z",
"created_at": "2023-03-19T18:23:35.293Z",
"error": "7gXTyn9z2GDln",
"id": "19214c3e-6961-4800-8da8-bb2903df8b3d",
"input": 32,
"output": 15,
"output_format": "hectare",
"src_format": "acre",
"started_at": "2023-03-19T18:23:35.293Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.293Z",
"user_id": "4QvMCOtIDMiZitFR"
}Convert a charge unit value to another charge unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
coulombampere_hourThe source format of the unit.
coulombampere_hourThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of charge unit formats.
coulombampere_hourThe source format of the unit conversion. The valid types of charge unit formats.
coulombampere_hourstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/charge/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.307Z",
"created_at": "2023-03-19T18:23:35.307Z",
"error": "tcQG0ZT6rGoop1Ne9sbL8GS1",
"id": "ae410649-2902-4c04-9a57-55e424d021a4",
"input": 21,
"output": 19,
"output_format": "coulomb",
"src_format": "ampere_hour",
"started_at": "2023-03-19T18:23:35.307Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.307Z",
"user_id": "AtTefaJj6GQ"
}Convert a concentration unit value to another concentration unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
parts_per_millionparts_per_billionparts_per_trillionpercentThe source format of the unit.
parts_per_millionparts_per_billionparts_per_trillionpercentThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of concentration unit formats.
parts_per_millionparts_per_billionparts_per_trillionpercentThe source format of the unit conversion. The valid types of concentration unit formats.
parts_per_millionparts_per_billionparts_per_trillionpercentstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/concentration/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.322Z",
"created_at": "2023-03-19T18:23:35.322Z",
"error": "xXjr5A",
"id": "c5eb352c-e11a-459c-bfa7-8622a732422f",
"input": 12,
"output": 8,
"output_format": "percent",
"src_format": "percent",
"started_at": "2023-03-19T18:23:35.322Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.322Z",
"user_id": "ZhBxGy"
}Convert a data transfer rate unit value to another data transfer rate unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
bytes_per_secondexabytes_per_secondbits_per_secondexabits_per_secondThe source format of the unit.
bytes_per_secondexabytes_per_secondbits_per_secondexabits_per_secondThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of data transfer unit formats.
bytes_per_secondexabytes_per_secondbits_per_secondexabits_per_secondThe source format of the unit conversion. The valid types of data transfer unit formats.
bytes_per_secondexabytes_per_secondbits_per_secondexabits_per_secondstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/data-transfer-rate/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.336Z",
"created_at": "2023-03-19T18:23:35.336Z",
"error": "F",
"id": "a7ae91e6-f1f7-434a-a77c-2378dda98dcc",
"input": 22,
"output": 14,
"output_format": "exabits_per_second",
"src_format": "bytes_per_second",
"started_at": "2023-03-19T18:23:35.336Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.336Z",
"user_id": "todQ2pDbk42"
}Convert a data unit value to another data unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
byteexabytebitexabitThe source format of the unit.
byteexabytebitexabitThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of data unit formats.
byteexabytebitexabitThe source format of the unit conversion. The valid types of data unit formats.
byteexabytebitexabitstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/data/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.350Z",
"created_at": "2023-03-19T18:23:35.350Z",
"error": "j4ym",
"id": "31150112-801d-45be-9736-c69aebe3f5bb",
"input": 29,
"output": 14,
"output_format": "byte",
"src_format": "bit",
"started_at": "2023-03-19T18:23:35.350Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:35.350Z",
"user_id": "AxVJkMAnu758tw1Ze"
}Convert a density unit value to another density unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
kilograms_per_cubic_metergrams_per_milliliterkilograms_per_literounces_per_cubic_footounces_per_cubic_inchounces_per_gallonpounds_per_cubic_footpounds_per_cubic_inchpounds_per_gallonslugs_per_cubic_footThe source format of the unit.
kilograms_per_cubic_metergrams_per_milliliterkilograms_per_literounces_per_cubic_footounces_per_cubic_inchounces_per_gallonpounds_per_cubic_footpounds_per_cubic_inchpounds_per_gallonslugs_per_cubic_footThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of density unit formats.
kilograms_per_cubic_metergrams_per_milliliterkilograms_per_literounces_per_cubic_footounces_per_cubic_inchounces_per_gallonpounds_per_cubic_footpounds_per_cubic_inchpounds_per_gallonslugs_per_cubic_footThe source format of the unit conversion. The valid types of density unit formats.
kilograms_per_cubic_metergrams_per_milliliterkilograms_per_literounces_per_cubic_footounces_per_cubic_inchounces_per_gallonpounds_per_cubic_footpounds_per_cubic_inchpounds_per_gallonslugs_per_cubic_footstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/density/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.365Z",
"created_at": "2023-03-19T18:23:35.365Z",
"error": "Km6aE2eBFNlQqSZtan7u7YHYqv",
"id": "e3ac15ed-e5d2-440e-8cef-6bcc5b3e84a1",
"input": 27,
"output": 31,
"output_format": "ounces_per_cubic_foot",
"src_format": "kilograms_per_liter",
"started_at": "2023-03-19T18:23:35.365Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:35.365Z",
"user_id": "OtXcYfeoncOYOhkwkv"
}Convert a energy unit value to another energy unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
joulecaloriekilowatt_hourwatt_hourbritish_thermal_unitbritish_thermal_unit_isobritish_thermal_unit59thermfoot_poundThe source format of the unit.
joulecaloriekilowatt_hourwatt_hourbritish_thermal_unitbritish_thermal_unit_isobritish_thermal_unit59thermfoot_poundThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of energy unit formats.
joulecaloriekilowatt_hourwatt_hourbritish_thermal_unitbritish_thermal_unit_isobritish_thermal_unit59thermfoot_poundThe source format of the unit conversion. The valid types of energy unit formats.
joulecaloriekilowatt_hourwatt_hourbritish_thermal_unitbritish_thermal_unit_isobritish_thermal_unit59thermfoot_poundstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/energy/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.380Z",
"created_at": "2023-03-19T18:23:35.380Z",
"error": "u0779hIIw3JmzZEWbdaaGT5As1",
"id": "74fc6fd5-1bee-4170-925d-a78bb3189dee",
"input": 1,
"output": 12,
"output_format": "calorie",
"src_format": "watt_hour",
"started_at": "2023-03-19T18:23:35.380Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:35.380Z",
"user_id": "GgVIoUzPEZwWzkMN0giIQ1DU"
}Convert a force unit value to another force unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
newtonpounddynekilopondpoundalThe source format of the unit.
newtonpounddynekilopondpoundalThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of force unit formats.
newtonpounddynekilopondpoundalThe source format of the unit conversion. The valid types of force unit formats.
newtonpounddynekilopondpoundalstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/force/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.402Z",
"created_at": "2023-03-19T18:23:35.402Z",
"error": "M",
"id": "c96bff32-38b4-4f16-8ad4-0e7314d6e5ce",
"input": 14,
"output": 19,
"output_format": "dyne",
"src_format": "pound",
"started_at": "2023-03-19T18:23:35.402Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.402Z",
"user_id": "bbewhO0kMWwhaPnoxIr0b2rZgFO7"
}Convert a illuminance unit value to another illuminance unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
luxfootcandlelumens_per_square_inchphotThe source format of the unit.
luxfootcandlelumens_per_square_inchphotThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of illuminance unit formats.
luxfootcandlelumens_per_square_inchphotThe source format of the unit conversion. The valid types of illuminance unit formats.
luxfootcandlelumens_per_square_inchphotstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/illuminance/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.422Z",
"created_at": "2023-03-19T18:23:35.422Z",
"error": "I3AC6g3XJzjFhKKx",
"id": "2d95dfcd-2c77-42e8-a394-96a057d52650",
"input": 2,
"output": 8,
"output_format": "footcandle",
"src_format": "footcandle",
"started_at": "2023-03-19T18:23:35.422Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.422Z",
"user_id": "c5KM6EMHwPX0P"
}Convert a length unit value to another length unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
metermillimetercentimeterkilometerfootmilinchmilenautical_mileastronomical_unitlightyearparsecangstromcubitfathomchainfurlonghandleaguenautical_leagueyardThe source format of the unit.
metermillimetercentimeterkilometerfootmilinchmilenautical_mileastronomical_unitlightyearparsecangstromcubitfathomchainfurlonghandleaguenautical_leagueyardThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of length unit formats.
metermillimetercentimeterkilometerfootmilinchmilenautical_mileastronomical_unitlightyearparsecangstromcubitfathomchainfurlonghandleaguenautical_leagueyardThe source format of the unit conversion. The valid types of length unit formats.
metermillimetercentimeterkilometerfootmilinchmilenautical_mileastronomical_unitlightyearparsecangstromcubitfathomchainfurlonghandleaguenautical_leagueyardstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/length/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.444Z",
"created_at": "2023-03-19T18:23:35.444Z",
"error": "lLelb1i96ZfHa8MV2x3gWIz4",
"id": "a2ff408c-6c02-47ff-97bf-d821438b1dac",
"input": 6,
"output": 19,
"output_format": "mile",
"src_format": "mile",
"started_at": "2023-03-19T18:23:35.444Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.444Z",
"user_id": "YF"
}Convert a magnetic field strength unit value to another magnetic field strength unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
teslagaussThe source format of the unit.
teslagaussThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of magnetic field strength unit formats.
teslagaussThe source format of the unit conversion. The valid types of magnetic field strength unit formats.
teslagaussstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/magnetic-field-strength/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.459Z",
"created_at": "2023-03-19T18:23:35.459Z",
"error": "YRzwzGpOTTbzMW4E6vKl4",
"id": "81cf7632-f6f0-417f-95a9-a07e4adc33e5",
"input": 16,
"output": 20,
"output_format": "tesla",
"src_format": "tesla",
"started_at": "2023-03-19T18:23:35.459Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.459Z",
"user_id": ""
}Convert a magnetic flux unit value to another magnetic flux unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
webermaxwellThe source format of the unit.
webermaxwellThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of magnetic flux unit formats.
webermaxwellThe source format of the unit conversion. The valid types of magnetic flux unit formats.
webermaxwellstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/magnetic-flux/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.472Z",
"created_at": "2023-03-19T18:23:35.472Z",
"error": "h7p5",
"id": "4006e37b-634e-4747-aeba-a96458158ebc",
"input": 12,
"output": 7,
"output_format": "weber",
"src_format": "weber",
"started_at": "2023-03-19T18:23:35.472Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.472Z",
"user_id": "RW5FoTlpfjjhSwsKFR3oHjCal1SWR"
}Convert a mass unit value to another mass unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
gramkilogrammetric_tonpoundlong_tonshort_tonstoneouncecaratslugThe source format of the unit.
gramkilogrammetric_tonpoundlong_tonshort_tonstoneouncecaratslugThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of mass unit formats.
gramkilogrammetric_tonpoundlong_tonshort_tonstoneouncecaratslugThe source format of the unit conversion. The valid types of mass unit formats.
gramkilogrammetric_tonpoundlong_tonshort_tonstoneouncecaratslugstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/mass/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.494Z",
"created_at": "2023-03-19T18:23:35.494Z",
"error": "JwMaYixLdUfVQNhJ94JRpwd",
"id": "eef8b4d6-90dd-4c02-a434-436939ad7ba5",
"input": 16,
"output": 1,
"output_format": "slug",
"src_format": "carat",
"started_at": "2023-03-19T18:23:35.494Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.494Z",
"user_id": "GEXaRZ3Hvrjw5cUM"
}Convert a metric cubed unit value to another metric cubed unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexastarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/metric/cubed/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.515Z",
"created_at": "2023-03-19T18:23:35.515Z",
"error": "r0Z507tX3Lh4q6vGjKOw",
"id": "63f44baf-4fe8-4dc4-a065-9e2f3f7cb22d",
"input": 18,
"output": 12,
"output_format": "atto",
"src_format": "exa",
"started_at": "2023-03-19T18:23:35.515Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.515Z",
"user_id": "Y"
}Convert a metric unit value to another metric unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexastarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/metric/power/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.538Z",
"created_at": "2023-03-19T18:23:35.538Z",
"error": "OxlAimlBj9Xee",
"id": "77d31ffc-2b99-44b5-a152-666183ee5131",
"input": 7,
"output": 19,
"output_format": "atto",
"src_format": "deci",
"started_at": "2023-03-19T18:23:35.538Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.538Z",
"user_id": "MxF"
}Convert a metric squared unit value to another metric squared unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexaThe source format of the unit conversion. The valid types of metric unit formats.
attofemtopiconanomicromillicentideciunitdecahectokilomegagigaterapetaexastarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/metric/squared/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.559Z",
"created_at": "2023-03-19T18:23:35.559Z",
"error": "4527odubVQf4no5sCr8dGPDCDK8yh",
"id": "3dbbcb48-70bf-485e-aaa6-acd8371284f6",
"input": 6,
"output": 11,
"output_format": "femto",
"src_format": "nano",
"started_at": "2023-03-19T18:23:35.559Z",
"status": "Completed",
"updated_at": "2023-03-19T18:23:35.559Z",
"user_id": "M8MYPn4pj8cclzM9HNLPQ2UMQ8"
}Convert a power unit value to another power unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
watthorsepowermilliwattThe source format of the unit.
watthorsepowermilliwattThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of power unit formats.
watthorsepowermilliwattThe source format of the unit conversion. The valid types of power unit formats.
watthorsepowermilliwattstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/power/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.579Z",
"created_at": "2023-03-19T18:23:35.579Z",
"error": "t1QI80vKemISHlE",
"id": "1bfa0691-94df-4816-a822-140b57c5a91d",
"input": 21,
"output": 6,
"output_format": "milliwatt",
"src_format": "milliwatt",
"started_at": "2023-03-19T18:23:35.579Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.579Z",
"user_id": "RIkv8obcMO1L2CEyfACg"
}Convert a pressure unit value to another pressure unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
pascalbarmbaratmospherepounds_per_square_inchThe source format of the unit.
pascalbarmbaratmospherepounds_per_square_inchThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of pressure unit formats.
pascalbarmbaratmospherepounds_per_square_inchThe source format of the unit conversion. The valid types of pressure unit formats.
pascalbarmbaratmospherepounds_per_square_inchstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/pressure/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.598Z",
"created_at": "2023-03-19T18:23:35.598Z",
"error": "aT0ru6iqiHlHNizCYVl",
"id": "673cce28-2fdb-4765-9588-1ed790acc2c1",
"input": 1,
"output": 12,
"output_format": "mbar",
"src_format": "mbar",
"started_at": "2023-03-19T18:23:35.598Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.598Z",
"user_id": "nhvOebJ36HUN7sah"
}Convert a radiation unit value to another radiation unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
graysievertradThe source format of the unit.
graysievertradThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of radiation unit formats. These describe the radiation energy absorbed by a mass or material and/or how it affects the relative damage to the human body.
graysievertradThe source format of the unit conversion. The valid types of radiation unit formats. These describe the radiation energy absorbed by a mass or material and/or how it affects the relative damage to the human body.
graysievertradstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/radiation/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.617Z",
"created_at": "2023-03-19T18:23:35.617Z",
"error": "QQhlGjAlWPZlfMmWFeMQk",
"id": "aac5c61d-08d4-4841-8423-d72e0b6d8288",
"input": 24,
"output": 29,
"output_format": "gray",
"src_format": "gray",
"started_at": "2023-03-19T18:23:35.617Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:35.617Z",
"user_id": "qLCWrTEqwqE6FoDp4G6oj2fw"
}Convert a radioactivity unit value to another radioactivity unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
becquerelcurierutherfordThe source format of the unit.
becquerelcurierutherfordThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of radioactivity unit formats. These describe the amount of radiation emitted by a radioactive material.
becquerelcurierutherfordThe source format of the unit conversion. The valid types of radioactivity unit formats. These describe the amount of radiation emitted by a radioactive material.
becquerelcurierutherfordstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/radioactivity/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.640Z",
"created_at": "2023-03-19T18:23:35.640Z",
"error": "HrMuwMacFezn02yAVICtXud",
"id": "e81600bf-c28c-4db1-be18-ddfdec9ebda5",
"input": 29,
"output": 30,
"output_format": "becquerel",
"src_format": "becquerel",
"started_at": "2023-03-19T18:23:35.640Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.640Z",
"user_id": "CiKraZKI0RuafoLsWgDn8Cd"
}Convert a solid angle unit value to another solid angle unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
steradiandegree_squaredspatThe source format of the unit.
steradiandegree_squaredspatThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of solid angle unit formats.
steradiandegree_squaredspatThe source format of the unit conversion. The valid types of solid angle unit formats.
steradiandegree_squaredspatstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/solid-angle/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.660Z",
"created_at": "2023-03-19T18:23:35.660Z",
"error": "RVMAg5I3Agsg1j6epfg4sF",
"id": "d85bb3b1-ea8c-4f03-a7ae-be90242eee0c",
"input": 20,
"output": 32,
"output_format": "steradian",
"src_format": "degree_squared",
"started_at": "2023-03-19T18:23:35.660Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.660Z",
"user_id": "6eSMchz"
}Convert a temperature unit value to another temperature unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
kelvincelsiusfahrenheitreaumurrankineThe source format of the unit.
kelvincelsiusfahrenheitreaumurrankineThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of temperature unit formats.
kelvincelsiusfahrenheitreaumurrankineThe source format of the unit conversion. The valid types of temperature unit formats.
kelvincelsiusfahrenheitreaumurrankinestarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/temperature/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.681Z",
"created_at": "2023-03-19T18:23:35.682Z",
"error": "VrvHeDgPluklwyz0376RbvM4j",
"id": "a80ea3c5-327b-4a26-ae2a-4d8a3ba96297",
"input": 10,
"output": 23,
"output_format": "fahrenheit",
"src_format": "fahrenheit",
"started_at": "2023-03-19T18:23:35.682Z",
"status": "Queued",
"updated_at": "2023-03-19T18:23:35.682Z",
"user_id": "MM"
}Convert a time unit value to another time unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
secondminutehourdayweekyearjulian_yeargregorian_yearThe source format of the unit.
secondminutehourdayweekyearjulian_yeargregorian_yearThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of time unit formats.
secondminutehourdayweekyearjulian_yeargregorian_yearThe source format of the unit conversion. The valid types of time unit formats.
secondminutehourdayweekyearjulian_yeargregorian_yearstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/time/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.702Z",
"created_at": "2023-03-19T18:23:35.702Z",
"error": "RENmBzKLTpViT2ON82P45",
"id": "3bd140c7-e06d-41dc-9d68-e07c6480776d",
"input": 14,
"output": 19,
"output_format": "second",
"src_format": "second",
"started_at": "2023-03-19T18:23:35.702Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.702Z",
"user_id": "UUz7"
}Convert a velocity unit value to another velocity unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
meters_per_secondfeet_per_secondmiles_per_hourkilometers_per_hourknotThe source format of the unit.
meters_per_secondfeet_per_secondmiles_per_hourkilometers_per_hourknotThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of velocity unit formats.
meters_per_secondfeet_per_secondmiles_per_hourkilometers_per_hourknotThe source format of the unit conversion. The valid types of velocity unit formats.
meters_per_secondfeet_per_secondmiles_per_hourkilometers_per_hourknotstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/velocity/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.721Z",
"created_at": "2023-03-19T18:23:35.721Z",
"error": "qGQdUNfwSRXdufRTQPgHENWzh9",
"id": "7f18a5dc-7560-4a44-b31b-82e3dacc89a8",
"input": 28,
"output": 14,
"output_format": "kilometers_per_hour",
"src_format": "meters_per_second",
"started_at": "2023-03-19T18:23:35.721Z",
"status": "Uploaded",
"updated_at": "2023-03-19T18:23:35.721Z",
"user_id": "dgViGs0"
}Convert a voltage unit value to another voltage unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
voltstatvoltabvoltThe source format of the unit.
voltstatvoltabvoltThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of voltage unit formats.
voltstatvoltabvoltThe source format of the unit conversion. The valid types of voltage unit formats.
voltstatvoltabvoltstarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/voltage/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.740Z",
"created_at": "2023-03-19T18:23:35.740Z",
"error": "D2uKX3xTLIODFby8iK8AEW",
"id": "1717c85a-2a47-4fac-8524-f4d84f65fb80",
"input": 21,
"output": 1,
"output_format": "abvolt",
"src_format": "statvolt",
"started_at": "2023-03-19T18:23:35.740Z",
"status": "Failed",
"updated_at": "2023-03-19T18:23:35.740Z",
"user_id": "NSSrArKg6tg0"
}Convert a volume unit value to another volume unit value. This is a nice endpoint to use for helper functions.
The output format of the unit.
cubic_metercubic_centimetercubic_millimetercubic_kilometerlitercubic_inchcubic_footcubic_yardcubic_milegallonquartpintcupfluid_ouncebarrelbushelcordcubic_fathomtablespoonteaspoonpinchdashdropfifthdramgillpecksackshotstrikeThe source format of the unit.
cubic_metercubic_centimetercubic_millimetercubic_kilometerlitercubic_inchcubic_footcubic_yardcubic_milegallonquartpintcupfluid_ouncebarrelbushelcordcubic_fathomtablespoonteaspoonpinchdashdropfifthdramgillpecksackshotstrikeThe initial value.
successful operation
completed_atstringISO-8601optional
The time and date the API call was completed.
created_atstringISO-8601optional
The time and date the API call was created.
The error the function returned, if any.
The unique identifier of the API call.
This is the same as the API call ID. A uuid.
A Version 4 UUID is a universally unique identifier that is generated using random numbers.
The input value.
The resulting value.
The output format of the unit conversion. The valid types of volume unit formats.
cubic_metercubic_centimetercubic_millimetercubic_kilometerlitercubic_inchcubic_footcubic_yardcubic_milegallonquartpintcupfluid_ouncebarrelbushelcordcubic_fathomtablespoonteaspoonpinchdashdropfifthdramgillpecksackshotstrikeThe source format of the unit conversion. The valid types of volume unit formats.
cubic_metercubic_centimetercubic_millimetercubic_kilometerlitercubic_inchcubic_footcubic_yardcubic_milegallonquartpintcupfluid_ouncebarrelbushelcordcubic_fathomtablespoonteaspoonpinchdashdropfifthdramgillpecksackshotstrikestarted_atstringISO-8601optional
The time and date the API call was started.
The status of the API call. The status of an async API call.
QueuedUploadedIn ProgressCompletedFailedupdated_atstringISO-8601optional
The time and date the API call was last updated.
The user ID of the user who created the API call.
$ curl "https://api.kittycad.io/unit/conversion/volume/{src_format}/{output_format}" \
--header "Authorization: Bearer $TOKEN"{
"completed_at": "2023-03-19T18:23:35.760Z",
"created_at": "2023-03-19T18:23:35.760Z",
"error": "ENGU1qUkKrcSo4PAKJGWM8FA1hy",
"id": "828a68cb-115b-4777-9c86-93dfdf444c31",
"input": 8,
"output": 7,
"output_format": "bushel",
"src_format": "cubic_mile",
"started_at": "2023-03-19T18:23:35.760Z",
"status": "In Progress",
"updated_at": "2023-03-19T18:23:35.760Z",
"user_id": "ez2ii"
}A user is someone who uses the KittyCAD API. Here, we can create, delete, and list users. We can also get information about a user. Operations will only be authorized if the user is requesting information about themselves.
This endpoint requires authentication by any KittyCAD user. It deletes the authenticated user from KittyCAD's database.
This call will only succeed if all invoices associated with the user have been paid in full and there is no outstanding balance.
No parameters
successful deletion
$ curl -X DELETE "https://api.kittycad.io/user" \
--header "Authorization: Bearer $TOKEN"Get the user information for the authenticated user.
Alternatively, you can also use the /users/me endpoint.
No parameters
successful operation
The user's company.
created_atstringISO-8601optional
The date and time the user was created.
The user's Discord handle.
emailstringEmail Addressoptional
The email address of the user.
email_verifiedstringISO-8601optional
The date and time the email address was verified.
The user's first name.
The user's GitHub handle.
The unique identifier for the user.
The image avatar for the user. This is a URL.
The user's last name.
The name of the user. This is auto populated at first from the authentication provider (if there was a name). It can be updated by the user by updating their first_name and last_name fields.
phonestringPhone Numberoptional
The user's phone number.
updated_atstringISO-8601optional
The date and time the user was last updated.
$ curl "https://api.kittycad.io/user" \
--header "Authorization: Bearer $TOKEN"{
"company": "lMtlEt3vpKozSiGzwPYQHsgaZT",
"created_at": "2023-03-19T18:23:35.781Z",
"discord": "pH3wGT9eDd9wj4U",
"email": "@0.com",
"email_verified": "2023-03-19T18:23:35.781Z",
"first_name": "i6PkIP9iIVpFuVxancBNc",
"github": "LheRx7pqTBP",
"id": "5IlxB6jHAU0",
"image": "https://3xs3.gX8.com/8gbuP3mq/HsI",
"last_name": "",
"name": "jfVO2GCm8U0hBK",
"phone": "+1-679-160-9546",
"updated_at": "2023-03-19T18:23:35.781Z"
}This endpoint requires authentication by any KittyCAD user. It updates information about the authenticated user.
successful operation
The user's company.
created_atstringISO-8601optional
The date and time the user was created.
The user's Discord handle.
emailstringEmail Addressoptional
The email address of the user.
email_verifiedstringISO-8601optional
The date and time the email address was verified.
The user's first name.
The user's GitHub handle.
The unique identifier for the user.
The image avatar for the user. This is a URL.
The user's last name.
The name of the user. This is auto populated at first from the authentication provider (if there was a name). It can be updated by the user by updating their first_name and last_name fields.
phonestringPhone Numberoptional
The user's phone number.
updated_atstringISO-8601optional
The date and time the user was last updated.
$ curl -X PUT "https://api.kittycad.io/user" \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/json" \
--data '{
"company": "sLpRTztQ",
"discord": "knjhqz",
"first_name": "z0Tr7torwnrAbSYvb0",
"github": "kHJQTUhk8kGhW5kkkKDEr2f",
"last_name": "2IuJmhKbRtW",
"phone": "+1-294-945-1749"
}'{
"company": "j3jjzjaRnbcKJ3Qd",
"created_at": "2023-03-19T18:23:35.797Z",
"discord": "3WNGSvAjnCZmpBQ",
"email": "YO@8E.com",
"email_verified": "2023-03-19T18:23:35.798Z",
"first_name": "M",
"github": "McQHSFnCnur1qnXblg",
"id": "Pn",
"image": "https://t.Z.com/MzT1e0a/QIzH34PAj",
"last_name": "JEVqrpQ673a4WRhbfDDTnChKqCytF",
"name": "Nzz9j3QcQu3hVm",
"phone": "+1-170-869-7150",
"updated_at": "2023-03-19T18:23:35.798Z"
}Get the user information for the authenticated user.
Alternatively, you can also use the /users-extended/me endpoint.
No parameters
successful operation
The user's company.
created_atstringISO-8601optional
The date and time the user was created.
The user's Discord handle.
emailstringEmail Addressoptional
The email address of the user.
email_verifiedstringISO-8601optional
The date and time the email address was verified.
The user's first name.
The user's Front ID. This is mostly used for internal mapping.
The user's GitHub handle.
The unique identifier for the user.
The image avatar for the user. This is a URL.
The user's last name.
The user's MailChimp ID. This is mostly used for internal mapping.
The name of the user. This is auto populated at first from the authentication provider (if there was a name). It can be updated by the user by updating their first_name and last_name fields.
phonestringPhone Numberoptional
The user's phone number.
The user's Stripe ID. This is mostly used for internal mapping.
updated_atstringISO-8601optional
The date and time the user was last updated.
$ curl "https://api.kittycad.io/user/extended" \
--header "Authorization: Bearer $TOKEN"{
"company": "OpTb3A5ymkAhLPDwyAt2JAAkIsofJ",
"created_at": "2023-03-19T18:23:35.813Z",
"discord": "fsVZKbWIaFhplORBMKHpobnYIxDb",
"email": "Fo8VtVK5yR@XF6.com",
"email_verified": "2023-03-19T18:23:35.813Z",
"first_name": "AFfiIzrYTYoVZbkJ6UILX9r2",
"front_id": "MetmeRIPlIufuwqb4DOxKE0oVg",
"github": "5UT7F",
"id": "dJTklIvAf7J8CI23b1WoT",
"image": "https://bqINU.CT1TUa0.com/wlER9jf37/ObCWTOl",
"last_name": "",
"mailchimp_id": "f6sfII5JbCKNEAD",
"name": "QFyQ1Rrv9EpW5RC",
"phone": "+1-311-202-3250",
"stripe_id": "1c1aMYnJU5fFBhZoIUW",
"updated_at": "2023-03-19T18:23:35.813Z"
}