KittyCAD: API Reference

API Reference

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.

Base url

https://api.kittycad.io

Client libraries

curl

python

rust

typescript

Authentication

KittyCAD'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.

Authenticated request

$ curl --header "Authorization: Bearer $TOKEN" \
	"https://api.kittycad.io/_meta/debug/session"

Errors

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).

HTTP Status Code Summary

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

Endpoints

GET/async/operations/{id}

GET/user/api-calls

GET/user/api-calls/{id}

Get an async operation

Parameters

idstringrequired

Returns

200 OK

successful operation

GET/async/operations/{id}

$ curl "https://api.kittycad.io/async/operations/{id}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:52.974Z",
  "created_at": "2023-06-02T19:34:52.974Z",
  "error": "0qYGeZlaop",
  "id": "3ca76056-7604-43da-8ccb-f4653928b40e",
  "src_format": "step",
  "started_at": "2023-06-02T19:34:52.974Z",
  "status": "Failed",
  "surface_area": 24,
  "updated_at": "2023-06-02T19:34:52.974Z",
  "user_id": "HM0Ot1z2jfewsMLlkD"
}

List API calls for your user

Parameters

limitintegeroptional
page_tokenstringoptional
sort_bystringrequired
Possible values
- created-at-ascending: sort in increasing order of "created_at"
- created-at-descending: sort in decreasing order of "created_at"

Returns

200 OK

successful operation

itemsarrayoptional
Array of
- completed_atstringISO-8601optional
- created_atstringISO-8601optional
- durationintegerDurationoptional
- emailstringEmail Addressoptional
- endpointstringoptional
- idstringUUIDoptional
- ip_addressstringIP Addressoptional
- litterboxbooleanoptional
- methodstringoptional
  Possible values
  - OPTIONS: The `OPTIONS` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.2.1).
  - GET: The `GET` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
  - POST: The `POST` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
  - PUT: The `PUT` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
  - DELETE: The `DELETE` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.5).
  - HEAD: The `HEAD` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.2).
  - TRACE: The `TRACE` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3).
  - CONNECT: The `CONNECT` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.6).
  - PATCH: The `PATCH` method as defined in [RFC 5789](https://tools.ietf.org/html/rfc5789).
  - EXTENSION: A catch all.
- minutesintegeroptional
- originstringoptional
- pricenumberUSD Priceoptional
- request_bodystringoptional
- request_query_paramsstringoptional
- response_bodystringoptional
- started_atstringISO-8601optional
- status_codeintegeroptional
- stripe_invoice_item_idstringoptional
- tokenstringUUIDoptional
- updated_atstringISO-8601optional
- user_agentstringoptional
- user_idstringoptional
next_pagestringoptional

GET/user/api-calls

$ curl "https://api.kittycad.io/user/api-calls" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "items": [
    {
      "completed_at": "2023-06-02T19:34:52.986Z",
      "created_at": "2023-06-02T19:34:52.986Z",
      "duration": 6,
      "email": "SQWz@1.com",
      "endpoint": "mBaGxW1QHy",
      "id": "14406a9d-ac38-4a0d-8d3b-78f5b36dbe15",
      "ip_address": "192.0.2.56",
      "litterbox": true,
      "method": "EXTENSION",
      "minutes": 13,
      "origin": "rc7fIzQAr5xWHQx4L5NQrz4QeF",
      "price": "38.89",
      "request_body": "bGT6AgfLFX1U5U2QpadkTEkegc0j",
      "request_query_params": "1DfT0e2C5vzdDaCb",
      "response_body": "SR6teN1XPN",
      "started_at": "2023-06-02T19:34:52.986Z",
      "status_code": 9,
      "stripe_invoice_item_id": "KoRwTGU8Lb3hTd",
      "token": "3a172009-a025-4b3e-907c-6aaa92ec110b",
      "updated_at": "2023-06-02T19:34:52.986Z",
      "user_agent": "J",
      "user_id": "iEplFS1EjoESbEy0PZ4H"
    }
  ],
  "next_page": "cCEmeGikQT"
}

Get an API call for a user

Parameters

idstringrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
durationintegerDurationoptional
emailstringEmail Addressoptional
endpointstringoptional
idstringUUIDoptional
ip_addressstringIP Addressoptional
litterboxbooleanoptional
methodstringoptional
Possible values
- OPTIONS: The `OPTIONS` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.2.1).
- GET: The `GET` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
- POST: The `POST` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
- PUT: The `PUT` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.1).
- DELETE: The `DELETE` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.5).
- HEAD: The `HEAD` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.2).
- TRACE: The `TRACE` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3).
- CONNECT: The `CONNECT` method as defined in [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3.6).
- PATCH: The `PATCH` method as defined in [RFC 5789](https://tools.ietf.org/html/rfc5789).
- EXTENSION: A catch all.
minutesintegeroptional
originstringoptional
pricenumberUSD Priceoptional
request_bodystringoptional
request_query_paramsstringoptional
response_bodystringoptional
started_atstringISO-8601optional
status_codeintegeroptional
stripe_invoice_item_idstringoptional
tokenstringUUIDoptional
updated_atstringISO-8601optional
user_agentstringoptional
user_idstringoptional

GET/user/api-calls/{id}

$ curl "https://api.kittycad.io/user/api-calls/{id}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:52.998Z",
  "created_at": "2023-06-02T19:34:52.998Z",
  "duration": 14,
  "email": "FsBLrjA@cf1U.com",
  "endpoint": "Lz1clhy4DXIIXACqUe",
  "id": "e44de92b-920c-46ad-b96a-ab2fcb6656d6",
  "ip_address": "192.0.2.179",
  "litterbox": true,
  "method": "DELETE",
  "minutes": 27,
  "origin": "wUv6zj0JsD9J",
  "price": "95.35",
  "request_body": "zYlsIc0QJ",
  "request_query_params": "rabenGczUvLQxOYivxJMkzjk",
  "response_body": "jVXF",
  "started_at": "2023-06-02T19:34:52.998Z",
  "status_code": 32,
  "stripe_invoice_item_id": "orca84NGJIAA",
  "token": "cf270de1-ec6f-459f-b37a-e1018b080959",
  "updated_at": "2023-06-02T19:34:52.998Z",
  "user_agent": "JgNdPiWf5fIDD9L2L",
  "user_id": "zWlU7BMROdq"
}

API Tokens

Endpoints

GET/user/api-tokens

POST/user/api-tokens

DELETE/user/api-tokens/{token}

GET/user/api-tokens/{token}

List API tokens for your user

Parameters

limitintegeroptional
page_tokenstringoptional
sort_bystringrequired
Possible values
- created-at-ascending: sort in increasing order of "created_at"
- created-at-descending: sort in decreasing order of "created_at"

Returns

200 OK

successful operation

itemsarrayoptional
Array of
- created_atstringISO-8601optional
- idstringoptional
- is_validbooleanoptional
- tokenstringUUIDoptional
- updated_atstringISO-8601optional
- user_idstringoptional
next_pagestringoptional

GET/user/api-tokens

$ curl "https://api.kittycad.io/user/api-tokens" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "items": [
    {
      "created_at": "2023-06-02T19:34:53.009Z",
      "id": "IucJROjaVFZxRUId",
      "is_valid": true,
      "token": "bbc32201-076e-41b4-8a5e-3797ed2da6f9",
      "updated_at": "2023-06-02T19:34:53.009Z",
      "user_id": "jz14tJE"
    }
  ],
  "next_page": "pEkwAu5f"
}

Create a new API token for your user

Parameters

No parameters

Returns

201 Created

successful creation

created_atstringISO-8601optional
idstringoptional
is_validbooleanoptional
tokenstringUUIDoptional
updated_atstringISO-8601optional
user_idstringoptional

POST/user/api-tokens

$ curl -X POST "https://api.kittycad.io/user/api-tokens" \
	--header "Authorization: Bearer $TOKEN"

201 Created

Response

{
  "created_at": "2023-06-02T19:34:53.012Z",
  "id": "TDZqYYigXgY6nwz",
  "is_valid": false,
  "token": "c6c6890d-c279-4b67-b7bb-f63e37ef3b4d",
  "updated_at": "2023-06-02T19:34:53.012Z",
  "user_id": "0F7VyDVviOkj"
}

Delete an API token for your user

Parameters

tokenstringUUIDrequired

Returns

204 No Content

successful deletion

DELETE/user/api-tokens/{token}

$ curl -X DELETE "https://api.kittycad.io/user/api-tokens/{token}" \
	--header "Authorization: Bearer $TOKEN"

Get an API token for your user

Parameters

tokenstringUUIDrequired

Returns

200 OK

successful operation

created_atstringISO-8601optional
idstringoptional
is_validbooleanoptional
tokenstringUUIDoptional
updated_atstringISO-8601optional
user_idstringoptional

GET/user/api-tokens/{token}

$ curl "https://api.kittycad.io/user/api-tokens/{token}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "created_at": "2023-06-02T19:34:53.016Z",
  "id": "0fwML46GhiGyDBXm0zFkBfL",
  "is_valid": true,
  "token": "5fb7f51e-e54d-4701-8b89-01f3c93c1837",
  "updated_at": "2023-06-02T19:34:53.016Z",
  "user_id": "Zh1DUjKoAzRNHTN7eGel"
}

File

Endpoints

POST/file/conversion/{src_format}/{output_format}

POST/file/density

POST/file/mass

Convert CAD file

Parameters

output_formatstringrequired
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- fbxb: The FBX file format (in binary). <https://en.wikipedia.org/wiki/FBX>
- obj: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>> The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
src_formatstringrequired
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
bodyapplication/octet-streamstringBINARYoptional

Returns

201 Created

successful creation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
outputstringBASE64optional
output_formatstringoptional
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- fbxb: The FBX file format (in binary). <https://en.wikipedia.org/wiki/FBX>
- obj: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>> The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
src_formatstringoptional
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

POST/file/conversion/{src_format}/{output_format}

$ 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"

201 Created

Response

{
  "completed_at": "2023-06-02T19:34:53.021Z",
  "created_at": "2023-06-02T19:34:53.021Z",
  "error": "YOjhez",
  "id": "588da476-315d-43b4-9155-dce67f05389a",
  "output": "BASE64_ENCODED_BYTE_STRING",
  "output_format": "fbxb",
  "src_format": "ply",
  "started_at": "2023-06-02T19:34:53.022Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.022Z",
  "user_id": "Eh5it6XQCWehByyZv"
}

Get CAD file density
beta

Parameters

material_massnumberrequired
src_formatstringrequired
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
bodyapplication/octet-streamstringBINARYoptional

Returns

201 Created

successful creation

completed_atstringISO-8601optional
created_atstringISO-8601optional
densitynumberoptional
errorstringoptional
idstringUUIDoptional
material_massnumberoptional
src_formatstringoptional
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

POST/file/density

$ curl -X POST "https://api.kittycad.io/file/density" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/octet-stream" \
	--data-binary "@path/to/file"

201 Created

Response

{
  "completed_at": "2023-06-02T19:34:53.027Z",
  "created_at": "2023-06-02T19:34:53.027Z",
  "density": 31,
  "error": "GVsyocuHo41SwQsET2SueVeE",
  "id": "047d7816-ec31-4d45-8dcc-73b2662ef5f8",
  "material_mass": 12,
  "src_format": "obj_zip",
  "started_at": "2023-06-02T19:34:53.027Z",
  "status": "Failed",
  "updated_at": "2023-06-02T19:34:53.027Z",
  "user_id": "A5j7vs"
}

Get CAD file mass
beta

Parameters

material_densitynumberrequired
src_formatstringrequired
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
bodyapplication/octet-streamstringBINARYoptional

Returns

201 Created

successful creation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
massnumberoptional
material_densitynumberoptional
src_formatstringoptional
Possible values
- dae: The COLLADA/DAE file format. <https://en.wikipedia.org/wiki/COLLADA>
- dxf: The DXF file format. <https://en.wikipedia.org/wiki/AutoCAD_DXF>
- fbx: The FBX file format. <https://en.wikipedia.org/wiki/FBX>
- obj_zip: The OBJ file format. A zip file containing both the obj file itself and its associated mtl file for full processing. <https://en.wikipedia.org/wiki/Wavefront_.obj_file>>
- obj: The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
- ply: The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
- step: The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
- stl: The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

POST/file/mass

$ curl -X POST "https://api.kittycad.io/file/mass" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/octet-stream" \
	--data-binary "@path/to/file"

201 Created

Response

{
  "completed_at": "2023-06-02T19:34:53.033Z",
  "created_at": "2023-06-02T19:34:53.033Z",
  "error": "MPtf9GI4iNSNbvHKexeCpYsUqtR9",
  "id": "6729ca88-3be1-4af4-9ec6-82225aa54243",
  "mass": 4,
  "material_density": 21,
  "src_format": "step",
  "started_at": "2023-06-02T19:34:53.033Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.033Z",
  "user_id": "jlDoqnJX8TWan4iMjRRn3"
}

Get OpenAPI schema

Parameters

No parameters

Returns

200 OK

successful operation

GET/

$ curl "https://api.kittycad.io/" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

Return pong

Parameters

No parameters

Returns

200 OK

successful operation

messagestringoptional

GET/ping

$ curl "https://api.kittycad.io/ping" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "message": "Q"
}

Payments

Endpoints

GET/user/payment/balance

GET/user/payment/invoices

GET/user/payment/methods

Delete payment info for your user

Parameters

No parameters

Returns

204 No Content

successful deletion

DELETE/user/payment

$ curl -X DELETE "https://api.kittycad.io/user/payment" \
	--header "Authorization: Bearer $TOKEN"

Get payment info about your user

Parameters

No parameters

Returns

200 OK

successful operation

addressobjectoptional
Object
- citystringoptional
- countrystringoptional
  Possible values
  249 possible values
  - AF: Afghanistan
  - AX: Åland Islands
  - AL: Albania
  - DZ: Algeria
  - AS: American Samoa
  - AD: Andorra
  - AO: Angola
  - AI: Anguilla
  - AQ: Antarctica
  - AG: Antigua and Barbuda
  - AR: Argentina
  - AM: Armenia
  - AW: Aruba
  - AU: Australia
  - AT: Austria
  - AZ: Azerbaijan
  - BS: Bahamas
  - BH: Bahrain
  - BD: Bangladesh
  - BB: Barbados
  - BY: Belarus
  - BE: Belgium
  - BZ: Belize
  - BJ: Benin
  - BM: Bermuda
  - BT: Bhutan
  - BO: Bolivia (Plurinational State of)
  - BQ: Bonaire, Sint Eustatius and Saba
  - BA: Bosnia and Herzegovina
  - BW: Botswana
  - BV: Bouvet Island
  - BR: Brazil
  - IO: British Indian Ocean Territory
  - BN: Brunei Darussalam
  - BG: Bulgaria
  - BF: Burkina Faso
  - BI: Burundi
  - CV: Cabo Verde
  - KH: Cambodia
  - CM: Cameroon
  - CA: Canada
  - KY: Cayman Islands
  - CF: Central African Republic
  - TD: Chad
  - CL: Chile
  - CN: China
  - CX: Christmas Island
  - CC: Cocos (Keeling) Islands
  - CO: Colombia
  - KM: Comoros
  - CG: Congo
  - CD: Congo (Democratic Republic of the)
  - CK: Cook Islands
  - CR: Costa Rica
  - CI: Côte d'Ivoire
  - HR: Croatia
  - CU: Cuba
  - CW: Curaçao
  - CY: Cyprus
  - CZ: Czechia
  - DK: Denmark
  - DJ: Djibouti
  - DM: Dominica
  - DO: Dominican Republic
  - EC: Ecuador
  - EG: Egypt
  - SV: El Salvador
  - GQ: Equatorial Guinea
  - ER: Eritrea
  - EE: Estonia
  - ET: Ethiopia
  - FK: Falkland Islands (Malvinas)
  - FO: Faroe Islands
  - FJ: Fiji
  - FI: Finland
  - FR: France
  - GF: French Guiana
  - PF: French Polynesia
  - TF: French Southern Territories
  - GA: Gabon
  - GM: Gambia
  - GE: Georgia
  - DE: Germany
  - GH: Ghana
  - GI: Gibraltar
  - GR: Greece
  - GL: Greenland
  - GD: Grenada
  - GP: Guadeloupe
  - GU: Guam
  - GT: Guatemala
  - GG: Guernsey
  - GN: Guinea
  - GW: Guinea-Bissau
  - GY: Guyana
  - HT: Haiti
  - HM: Heard Island and McDonald Islands
  - VA: Holy See
  - HN: Honduras
  - HK: Hong Kong
  - HU: Hungary
  - IS: Iceland
  - IN: India
  - ID: Indonesia
  - IR: Iran (Islamic Republic of)
  - IQ: Iraq
  - IE: Ireland
  - IM: Isle of Man
  - IL: Israel
  - IT: Italy
  - JM: Jamaica
  - JP: Japan
  - JE: Jersey
  - JO: Jordan
  - KZ: Kazakhstan
  - KE: Kenya
  - KI: Kiribati
  - KP: Korea (Democratic People's Republic of)
  - KR: Korea (Republic of)
  - KW: Kuwait
  - KG: Kyrgyzstan
  - LA: Lao People's Democratic Republic
  - LV: Latvia
  - LB: Lebanon
  - LS: Lesotho
  - LR: Liberia
  - LY: Libya
  - LI: Liechtenstein
  - LT: Lithuania
  - LU: Luxembourg
  - MO: Macao
  - MK: Macedonia (the former Yugoslav Republic of)
  - MG: Madagascar
  - MW: Malawi
  - MY: Malaysia
  - MV: Maldives
  - ML: Mali
  - MT: Malta
  - MH: Marshall Islands
  - MQ: Martinique
  - MR: Mauritania
  - MU: Mauritius
  - YT: Mayotte
  - MX: Mexico
  - FM: Micronesia (Federated States of)
  - MD: Moldova (Republic of)
  - MC: Monaco
  - MN: Mongolia
  - ME: Montenegro
  - MS: Montserrat
  - MA: Morocco
  - MZ: Mozambique
  - MM: Myanmar
  - NA: Namibia
  - NR: Nauru
  - NP: Nepal
  - NL: Netherlands
  - NC: New Caledonia
  - NZ: New Zealand
  - NI: Nicaragua
  - NE: Niger
  - NG: Nigeria
  - NU: Niue
  - NF: Norfolk Island
  - MP: Northern Mariana Islands
  - NO: Norway
  - OM: Oman
  - PK: Pakistan
  - PW: Palau
  - PS: Palestine, State of
  - PA: Panama
  - PG: Papua New Guinea
  - PY: Paraguay
  - PE: Peru
  - PH: Philippines
  - PN: Pitcairn
  - PL: Poland
  - PT: Portugal
  - PR: Puerto Rico
  - QA: Qatar
  - RE: Réunion
  - RO: Romania
  - RU: Russian Federation
  - RW: Rwanda
  - BL: Saint Barthélemy
  - SH: Saint Helena, Ascension and Tristan da Cunha
  - KN: Saint Kitts and Nevis
  - LC: Saint Lucia
  - MF: Saint Martin (French part)
  - PM: Saint Pierre and Miquelon
  - VC: Saint Vincent and the Grenadines
  - WS: Samoa
  - SM: San Marino
  - ST: Sao Tome and Principe
  - SA: Saudi Arabia
  - SN: Senegal
  - RS: Serbia
  - SC: Seychelles
  - SL: Sierra Leone
  - SG: Singapore
  - SX: Sint Maarten (Dutch part)
  - SK: Slovakia
  - SI: Slovenia
  - SB: Solomon Islands
  - SO: Somalia
  - ZA: South Africa
  - GS: South Georgia and the South Sandwich Islands
  - SS: South Sudan
  - ES: Spain
  - LK: Sri Lanka
  - SD: Sudan
  - SR: Suriname
  - SJ: Svalbard and Jan Mayen
  - SZ: Swaziland
  - SE: Sweden
  - CH: Switzerland
  - SY: Syrian Arab Republic
  - TW: Taiwan, Province of China
  - TJ: Tajikistan
  - TZ: Tanzania, United Republic of
  - TH: Thailand
  - TL: Timor-Leste
  - TG: Togo
  - TK: Tokelau
  - TO: Tonga
  - TT: Trinidad and Tobago
  - TN: Tunisia
  - TR: Turkey
  - TM: Turkmenistan
  - TC: Turks and Caicos Islands
  - TV: Tuvalu
  - UG: Uganda
  - UA: Ukraine
  - AE: United Arab Emirates
  - GB: United Kingdom of Great Britain and Northern Ireland
  - US: United States of America
  - UM: United States Minor Outlying Islands
  - UY: Uruguay
  - UZ: Uzbekistan
  - VU: Vanuatu
  - VE: Venezuela (Bolivarian Republic of)
  - VN: Viet Nam
  - VG: Virgin Islands (British)
  - VI: Virgin Islands (U.S.)
  - WF: Wallis and Futuna
  - EH: Western Sahara
  - YE: Yemen
  - ZM: Zambia
  - ZW: Zimbabwe
- statestringoptional
- street1stringoptional
- street2stringoptional
- user_idstringoptional
- zipstringoptional
balancenumberUSD Priceoptional
created_atstringISO-8601optional
currencystringoptional
Possible values
139 possible values
- aed: United Arab Emirates Dirham
- afn: Afghan Afghani
- all: Albanian Lek
- amd: Armenian Dram
- ang: Netherlands Antillean Gulden
- aoa: Angolan Kwanza
- ars: Argentine Peso
- aud: Australian Dollar
- awg: Aruban Florin
- azn: Azerbaijani Manat
- bam: Bosnia & Herzegovina Convertible Mark
- bbd: Barbadian Dollar
- bdt: Bangladeshi Taka
- bgn: Bulgarian Lev
- bif: Burundian Franc
- bmd: Bermudian Dollar
- bnd: Brunei Dollar
- bob: Bolivian Boliviano
- brl: Brazilian Real
- bsd: Bahamian Dollar
- bwp: Botswana Pula
- bzd: Belize Dollar
- cad: Canadian Dollar
- cdf: Congolese Franc
- chf: Swiss Franc
- clp: Chilean Peso
- cny: Chinese Renminbi Yuan
- cop: Colombian Peso
- crc: Costa Rican Colón
- cve: Cape Verdean Escudo
- czk: Czech Koruna
- djf: Djiboutian Franc
- dkk: Danish Krone
- dop: Dominican Peso
- dzd: Algerian Dinar
- eek: Estonian Kroon
- egp: Egyptian Pound
- etb: Ethiopian Birr
- eur: Euro
- fjd: Fijian Dollar
- fkp: Falkland Islands Pound
- gbp: British Pound
- gel: Georgian Lari
- gip: Gibraltar Pound
- gmd: Gambian Dalasi
- gnf: Guinean Franc
- gtq: Guatemalan Quetzal
- gyd: Guyanese Dollar
- hkd: Hong Kong Dollar
- hnl: Honduran Lempira
- hrk: Croatian Kuna
- htg: Haitian Gourde
- huf: Hungarian Forint
- idr: Indonesian Rupiah
- ils: Israeli New Sheqel
- inr: Indian Rupee
- isk: Icelandic Króna
- jmd: Jamaican Dollar
- jpy: Japanese Yen
- kes: Kenyan Shilling
- kgs: Kyrgyzstani Som
- khr: Cambodian Riel
- kmf: Comorian Franc
- krw: South Korean Won
- kyd: Cayman Islands Dollar
- kzt: Kazakhstani Tenge
- lak: Lao Kip
- lbp: Lebanese Pound
- lkr: Sri Lankan Rupee
- lrd: Liberian Dollar
- lsl: Lesotho Loti
- ltl: Lithuanian Litas
- lvl: Latvian Lats
- mad: Moroccan Dirham
- mdl: Moldovan Leu
- mga: Malagasy Ariary
- mkd: Macedonian Denar
- mnt: Mongolian Tögrög
- mop: Macanese Pataca
- mro: Mauritanian Ouguiya
- mur: Mauritian Rupee
- mvr: Maldivian Rufiyaa
- mwk: Malawian Kwacha
- mxn: Mexican Peso
- myr: Malaysian Ringgit
- mzn: Mozambican Metical
- nad: Namibian Dollar
- ngn: Nigerian Naira
- nio: Nicaraguan Córdoba
- nok: Norwegian Krone
- npr: Nepalese Rupee
- nzd: New Zealand Dollar
- pab: Panamanian Balboa
- pen: Peruvian Nuevo Sol
- pgk: Papua New Guinean Kina
- php: Philippine Peso
- pkr: Pakistani Rupee
- pln: Polish Złoty
- pyg: Paraguayan Guaraní
- qar: Qatari Riyal
- ron: Romanian Leu
- rsd: Serbian Dinar
- rub: Russian Ruble
- rwf: Rwandan Franc
- sar: Saudi Riyal
- sbd: Solomon Islands Dollar
- scr: Seychellois Rupee
- sek: Swedish Krona
- sgd: Singapore Dollar
- shp: Saint Helenian Pound
- sll: Sierra Leonean Leone
- sos: Somali Shilling
- srd: Surinamese Dollar
- std: São Tomé and Príncipe Dobra
- svc: Salvadoran Colón
- szl: Swazi Lilangeni
- thb: Thai Baht
- tjs: Tajikistani Somoni
- top: Tongan Paʻanga
- try: Turkish Lira
- ttd: Trinidad and Tobago Dollar
- twd: New Taiwan Dollar
- tzs: Tanzanian Shilling
- uah: Ukrainian Hryvnia
- ugx: Ugandan Shilling
- usd: United States Dollar
- uyu: Uruguayan Peso
- uzs: Uzbekistani Som
- vef: Venezuelan Bolívar
- vnd: Vietnamese Đồng
- vuv: Vanuatu Vatu
- wst: Samoan Tala
- xaf: Central African Cfa Franc
- xcd: East Caribbean Dollar
- xof: West African Cfa Franc
- xpf: Cfp Franc
- yer: Yemeni Rial
- zar: South African Rand
- zmw: Zambian Kwacha
delinquentbooleanoptional
emailstringEmail Addressoptional
idstringoptional
metadataobjectoptional
namestringoptional
phonestringPhone Numberoptional

GET/user/payment

$ curl "https://api.kittycad.io/user/payment" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "address": {
    "city": "",
    "country": "GE",
    "state": "N8418eDKI0EPFhDQmmUv6",
    "street1": "M6qXWbFQ66Kzj9eqw",
    "street2": "08GxrJPlNGbjbsQoEAuzV",
    "user_id": "vVzGDwcdrmNfCpG4GY9C",
    "zip": "4EB0P"
  },
  "balance": "34.53",
  "created_at": "2023-06-02T19:34:53.048Z",
  "currency": "bob",
  "delinquent": false,
  "email": "@MY5DzbJsj.com",
  "id": "X31Tz60pGgjfRaU",
  "metadata": {},
  "name": "7WrizOH2AgGAG27VXrj7UlT83o",
  "phone": "+1-172-686-8961"
}

Create payment info for your user

Parameters

bodyapplication/jsonobjectoptional
Object
- addressobjectoptional
  Object
  - citystringoptional
  - countrystringoptional
    Possible values
    249 possible values
    - AF: Afghanistan
    - AX: Åland Islands
    - AL: Albania
    - DZ: Algeria
    - AS: American Samoa
    - AD: Andorra
    - AO: Angola
    - AI: Anguilla
    - AQ: Antarctica
    - AG: Antigua and Barbuda
    - AR: Argentina
    - AM: Armenia
    - AW: Aruba
    - AU: Australia
    - AT: Austria
    - AZ: Azerbaijan
    - BS: Bahamas
    - BH: Bahrain
    - BD: Bangladesh
    - BB: Barbados
    - BY: Belarus
    - BE: Belgium
    - BZ: Belize
    - BJ: Benin
    - BM: Bermuda
    - BT: Bhutan
    - BO: Bolivia (Plurinational State of)
    - BQ: Bonaire, Sint Eustatius and Saba
    - BA: Bosnia and Herzegovina
    - BW: Botswana
    - BV: Bouvet Island
    - BR: Brazil
    - IO: British Indian Ocean Territory
    - BN: Brunei Darussalam
    - BG: Bulgaria
    - BF: Burkina Faso
    - BI: Burundi
    - CV: Cabo Verde
    - KH: Cambodia
    - CM: Cameroon
    - CA: Canada
    - KY: Cayman Islands
    - CF: Central African Republic
    - TD: Chad
    - CL: Chile
    - CN: China
    - CX: Christmas Island
    - CC: Cocos (Keeling) Islands
    - CO: Colombia
    - KM: Comoros
    - CG: Congo
    - CD: Congo (Democratic Republic of the)
    - CK: Cook Islands
    - CR: Costa Rica
    - CI: Côte d'Ivoire
    - HR: Croatia
    - CU: Cuba
    - CW: Curaçao
    - CY: Cyprus
    - CZ: Czechia
    - DK: Denmark
    - DJ: Djibouti
    - DM: Dominica
    - DO: Dominican Republic
    - EC: Ecuador
    - EG: Egypt
    - SV: El Salvador
    - GQ: Equatorial Guinea
    - ER: Eritrea
    - EE: Estonia
    - ET: Ethiopia
    - FK: Falkland Islands (Malvinas)
    - FO: Faroe Islands
    - FJ: Fiji
    - FI: Finland
    - FR: France
    - GF: French Guiana
    - PF: French Polynesia
    - TF: French Southern Territories
    - GA: Gabon
    - GM: Gambia
    - GE: Georgia
    - DE: Germany
    - GH: Ghana
    - GI: Gibraltar
    - GR: Greece
    - GL: Greenland
    - GD: Grenada
    - GP: Guadeloupe
    - GU: Guam
    - GT: Guatemala
    - GG: Guernsey
    - GN: Guinea
    - GW: Guinea-Bissau
    - GY: Guyana
    - HT: Haiti
    - HM: Heard Island and McDonald Islands
    - VA: Holy See
    - HN: Honduras
    - HK: Hong Kong
    - HU: Hungary
    - IS: Iceland
    - IN: India
    - ID: Indonesia
    - IR: Iran (Islamic Republic of)
    - IQ: Iraq
    - IE: Ireland
    - IM: Isle of Man
    - IL: Israel
    - IT: Italy
    - JM: Jamaica
    - JP: Japan
    - JE: Jersey
    - JO: Jordan
    - KZ: Kazakhstan
    - KE: Kenya
    - KI: Kiribati
    - KP: Korea (Democratic People's Republic of)
    - KR: Korea (Republic of)
    - KW: Kuwait
    - KG: Kyrgyzstan
    - LA: Lao People's Democratic Republic
    - LV: Latvia
    - LB: Lebanon
    - LS: Lesotho
    - LR: Liberia
    - LY: Libya
    - LI: Liechtenstein
    - LT: Lithuania
    - LU: Luxembourg
    - MO: Macao
    - MK: Macedonia (the former Yugoslav Republic of)
    - MG: Madagascar
    - MW: Malawi
    - MY: Malaysia
    - MV: Maldives
    - ML: Mali
    - MT: Malta
    - MH: Marshall Islands
    - MQ: Martinique
    - MR: Mauritania
    - MU: Mauritius
    - YT: Mayotte
    - MX: Mexico
    - FM: Micronesia (Federated States of)
    - MD: Moldova (Republic of)
    - MC: Monaco
    - MN: Mongolia
    - ME: Montenegro
    - MS: Montserrat
    - MA: Morocco
    - MZ: Mozambique
    - MM: Myanmar
    - NA: Namibia
    - NR: Nauru
    - NP: Nepal
    - NL: Netherlands
    - NC: New Caledonia
    - NZ: New Zealand
    - NI: Nicaragua
    - NE: Niger
    - NG: Nigeria
    - NU: Niue
    - NF: Norfolk Island
    - MP: Northern Mariana Islands
    - NO: Norway
    - OM: Oman
    - PK: Pakistan
    - PW: Palau
    - PS: Palestine, State of
    - PA: Panama
    - PG: Papua New Guinea
    - PY: Paraguay
    - PE: Peru
    - PH: Philippines
    - PN: Pitcairn
    - PL: Poland
    - PT: Portugal
    - PR: Puerto Rico
    - QA: Qatar
    - RE: Réunion
    - RO: Romania
    - RU: Russian Federation
    - RW: Rwanda
    - BL: Saint Barthélemy
    - SH: Saint Helena, Ascension and Tristan da Cunha
    - KN: Saint Kitts and Nevis
    - LC: Saint Lucia
    - MF: Saint Martin (French part)
    - PM: Saint Pierre and Miquelon
    - VC: Saint Vincent and the Grenadines
    - WS: Samoa
    - SM: San Marino
    - ST: Sao Tome and Principe
    - SA: Saudi Arabia
    - SN: Senegal
    - RS: Serbia
    - SC: Seychelles
    - SL: Sierra Leone
    - SG: Singapore
    - SX: Sint Maarten (Dutch part)
    - SK: Slovakia
    - SI: Slovenia
    - SB: Solomon Islands
    - SO: Somalia
    - ZA: South Africa
    - GS: South Georgia and the South Sandwich Islands
    - SS: South Sudan
    - ES: Spain
    - LK: Sri Lanka
    - SD: Sudan
    - SR: Suriname
    - SJ: Svalbard and Jan Mayen
    - SZ: Swaziland
    - SE: Sweden
    - CH: Switzerland
    - SY: Syrian Arab Republic
    - TW: Taiwan, Province of China
    - TJ: Tajikistan
    - TZ: Tanzania, United Republic of
    - TH: Thailand
    - TL: Timor-Leste
    - TG: Togo
    - TK: Tokelau
    - TO: Tonga
    - TT: Trinidad and Tobago
    - TN: Tunisia
    - TR: Turkey
    - TM: Turkmenistan
    - TC: Turks and Caicos Islands
    - TV: Tuvalu
    - UG: Uganda
    - UA: Ukraine
    - AE: United Arab Emirates
    - GB: United Kingdom of Great Britain and Northern Ireland
    - US: United States of America
    - UM: United States Minor Outlying Islands
    - UY: Uruguay
    - UZ: Uzbekistan
    - VU: Vanuatu
    - VE: Venezuela (Bolivarian Republic of)
    - VN: Viet Nam
    - VG: Virgin Islands (British)
    - VI: Virgin Islands (U.S.)
    - WF: Wallis and Futuna
    - EH: Western Sahara
    - YE: Yemen
    - ZM: Zambia
    - ZW: Zimbabwe
  - statestringoptional
  - street1stringoptional
  - street2stringoptional
  - user_idstringoptional
  - zipstringoptional
- namestringoptional
- phonestringPhone Numberoptional

Returns

201 Created

successful creation

addressobjectoptional
Object
- citystringoptional
- countrystringoptional
  Possible values
  249 possible values
  - AF: Afghanistan
  - AX: Åland Islands
  - AL: Albania
  - DZ: Algeria
  - AS: American Samoa
  - AD: Andorra
  - AO: Angola
  - AI: Anguilla
  - AQ: Antarctica
  - AG: Antigua and Barbuda
  - AR: Argentina
  - AM: Armenia
  - AW: Aruba
  - AU: Australia
  - AT: Austria
  - AZ: Azerbaijan
  - BS: Bahamas
  - BH: Bahrain
  - BD: Bangladesh
  - BB: Barbados
  - BY: Belarus
  - BE: Belgium
  - BZ: Belize
  - BJ: Benin
  - BM: Bermuda
  - BT: Bhutan
  - BO: Bolivia (Plurinational State of)
  - BQ: Bonaire, Sint Eustatius and Saba
  - BA: Bosnia and Herzegovina
  - BW: Botswana
  - BV: Bouvet Island
  - BR: Brazil
  - IO: British Indian Ocean Territory
  - BN: Brunei Darussalam
  - BG: Bulgaria
  - BF: Burkina Faso
  - BI: Burundi
  - CV: Cabo Verde
  - KH: Cambodia
  - CM: Cameroon
  - CA: Canada
  - KY: Cayman Islands
  - CF: Central African Republic
  - TD: Chad
  - CL: Chile
  - CN: China
  - CX: Christmas Island
  - CC: Cocos (Keeling) Islands
  - CO: Colombia
  - KM: Comoros
  - CG: Congo
  - CD: Congo (Democratic Republic of the)
  - CK: Cook Islands
  - CR: Costa Rica
  - CI: Côte d'Ivoire
  - HR: Croatia
  - CU: Cuba
  - CW: Curaçao
  - CY: Cyprus
  - CZ: Czechia
  - DK: Denmark
  - DJ: Djibouti
  - DM: Dominica
  - DO: Dominican Republic
  - EC: Ecuador
  - EG: Egypt
  - SV: El Salvador
  - GQ: Equatorial Guinea
  - ER: Eritrea
  - EE: Estonia
  - ET: Ethiopia
  - FK: Falkland Islands (Malvinas)
  - FO: Faroe Islands
  - FJ: Fiji
  - FI: Finland
  - FR: France
  - GF: French Guiana
  - PF: French Polynesia
  - TF: French Southern Territories
  - GA: Gabon
  - GM: Gambia
  - GE: Georgia
  - DE: Germany
  - GH: Ghana
  - GI: Gibraltar
  - GR: Greece
  - GL: Greenland
  - GD: Grenada
  - GP: Guadeloupe
  - GU: Guam
  - GT: Guatemala
  - GG: Guernsey
  - GN: Guinea
  - GW: Guinea-Bissau
  - GY: Guyana
  - HT: Haiti
  - HM: Heard Island and McDonald Islands
  - VA: Holy See
  - HN: Honduras
  - HK: Hong Kong
  - HU: Hungary
  - IS: Iceland
  - IN: India
  - ID: Indonesia
  - IR: Iran (Islamic Republic of)
  - IQ: Iraq
  - IE: Ireland
  - IM: Isle of Man
  - IL: Israel
  - IT: Italy
  - JM: Jamaica
  - JP: Japan
  - JE: Jersey
  - JO: Jordan
  - KZ: Kazakhstan
  - KE: Kenya
  - KI: Kiribati
  - KP: Korea (Democratic People's Republic of)
  - KR: Korea (Republic of)
  - KW: Kuwait
  - KG: Kyrgyzstan
  - LA: Lao People's Democratic Republic
  - LV: Latvia
  - LB: Lebanon
  - LS: Lesotho
  - LR: Liberia
  - LY: Libya
  - LI: Liechtenstein
  - LT: Lithuania
  - LU: Luxembourg
  - MO: Macao
  - MK: Macedonia (the former Yugoslav Republic of)
  - MG: Madagascar
  - MW: Malawi
  - MY: Malaysia
  - MV: Maldives
  - ML: Mali
  - MT: Malta
  - MH: Marshall Islands
  - MQ: Martinique
  - MR: Mauritania
  - MU: Mauritius
  - YT: Mayotte
  - MX: Mexico
  - FM: Micronesia (Federated States of)
  - MD: Moldova (Republic of)
  - MC: Monaco
  - MN: Mongolia
  - ME: Montenegro
  - MS: Montserrat
  - MA: Morocco
  - MZ: Mozambique
  - MM: Myanmar
  - NA: Namibia
  - NR: Nauru
  - NP: Nepal
  - NL: Netherlands
  - NC: New Caledonia
  - NZ: New Zealand
  - NI: Nicaragua
  - NE: Niger
  - NG: Nigeria
  - NU: Niue
  - NF: Norfolk Island
  - MP: Northern Mariana Islands
  - NO: Norway
  - OM: Oman
  - PK: Pakistan
  - PW: Palau
  - PS: Palestine, State of
  - PA: Panama
  - PG: Papua New Guinea
  - PY: Paraguay
  - PE: Peru
  - PH: Philippines
  - PN: Pitcairn
  - PL: Poland
  - PT: Portugal
  - PR: Puerto Rico
  - QA: Qatar
  - RE: Réunion
  - RO: Romania
  - RU: Russian Federation
  - RW: Rwanda
  - BL: Saint Barthélemy
  - SH: Saint Helena, Ascension and Tristan da Cunha
  - KN: Saint Kitts and Nevis
  - LC: Saint Lucia
  - MF: Saint Martin (French part)
  - PM: Saint Pierre and Miquelon
  - VC: Saint Vincent and the Grenadines
  - WS: Samoa
  - SM: San Marino
  - ST: Sao Tome and Principe
  - SA: Saudi Arabia
  - SN: Senegal
  - RS: Serbia
  - SC: Seychelles
  - SL: Sierra Leone
  - SG: Singapore
  - SX: Sint Maarten (Dutch part)
  - SK: Slovakia
  - SI: Slovenia
  - SB: Solomon Islands
  - SO: Somalia
  - ZA: South Africa
  - GS: South Georgia and the South Sandwich Islands
  - SS: South Sudan
  - ES: Spain
  - LK: Sri Lanka
  - SD: Sudan
  - SR: Suriname
  - SJ: Svalbard and Jan Mayen
  - SZ: Swaziland
  - SE: Sweden
  - CH: Switzerland
  - SY: Syrian Arab Republic
  - TW: Taiwan, Province of China
  - TJ: Tajikistan
  - TZ: Tanzania, United Republic of
  - TH: Thailand
  - TL: Timor-Leste
  - TG: Togo
  - TK: Tokelau
  - TO: Tonga
  - TT: Trinidad and Tobago
  - TN: Tunisia
  - TR: Turkey
  - TM: Turkmenistan
  - TC: Turks and Caicos Islands
  - TV: Tuvalu
  - UG: Uganda
  - UA: Ukraine
  - AE: United Arab Emirates
  - GB: United Kingdom of Great Britain and Northern Ireland
  - US: United States of America
  - UM: United States Minor Outlying Islands
  - UY: Uruguay
  - UZ: Uzbekistan
  - VU: Vanuatu
  - VE: Venezuela (Bolivarian Republic of)
  - VN: Viet Nam
  - VG: Virgin Islands (British)
  - VI: Virgin Islands (U.S.)
  - WF: Wallis and Futuna
  - EH: Western Sahara
  - YE: Yemen
  - ZM: Zambia
  - ZW: Zimbabwe
- statestringoptional
- street1stringoptional
- street2stringoptional
- user_idstringoptional
- zipstringoptional
balancenumberUSD Priceoptional
created_atstringISO-8601optional
currencystringoptional
Possible values
139 possible values
- aed: United Arab Emirates Dirham
- afn: Afghan Afghani
- all: Albanian Lek
- amd: Armenian Dram
- ang: Netherlands Antillean Gulden
- aoa: Angolan Kwanza
- ars: Argentine Peso
- aud: Australian Dollar
- awg: Aruban Florin
- azn: Azerbaijani Manat
- bam: Bosnia & Herzegovina Convertible Mark
- bbd: Barbadian Dollar
- bdt: Bangladeshi Taka
- bgn: Bulgarian Lev
- bif: Burundian Franc
- bmd: Bermudian Dollar
- bnd: Brunei Dollar
- bob: Bolivian Boliviano
- brl: Brazilian Real
- bsd: Bahamian Dollar
- bwp: Botswana Pula
- bzd: Belize Dollar
- cad: Canadian Dollar
- cdf: Congolese Franc
- chf: Swiss Franc
- clp: Chilean Peso
- cny: Chinese Renminbi Yuan
- cop: Colombian Peso
- crc: Costa Rican Colón
- cve: Cape Verdean Escudo
- czk: Czech Koruna
- djf: Djiboutian Franc
- dkk: Danish Krone
- dop: Dominican Peso
- dzd: Algerian Dinar
- eek: Estonian Kroon
- egp: Egyptian Pound
- etb: Ethiopian Birr
- eur: Euro
- fjd: Fijian Dollar
- fkp: Falkland Islands Pound
- gbp: British Pound
- gel: Georgian Lari
- gip: Gibraltar Pound
- gmd: Gambian Dalasi
- gnf: Guinean Franc
- gtq: Guatemalan Quetzal
- gyd: Guyanese Dollar
- hkd: Hong Kong Dollar
- hnl: Honduran Lempira
- hrk: Croatian Kuna
- htg: Haitian Gourde
- huf: Hungarian Forint
- idr: Indonesian Rupiah
- ils: Israeli New Sheqel
- inr: Indian Rupee
- isk: Icelandic Króna
- jmd: Jamaican Dollar
- jpy: Japanese Yen
- kes: Kenyan Shilling
- kgs: Kyrgyzstani Som
- khr: Cambodian Riel
- kmf: Comorian Franc
- krw: South Korean Won
- kyd: Cayman Islands Dollar
- kzt: Kazakhstani Tenge
- lak: Lao Kip
- lbp: Lebanese Pound
- lkr: Sri Lankan Rupee
- lrd: Liberian Dollar
- lsl: Lesotho Loti
- ltl: Lithuanian Litas
- lvl: Latvian Lats
- mad: Moroccan Dirham
- mdl: Moldovan Leu
- mga: Malagasy Ariary
- mkd: Macedonian Denar
- mnt: Mongolian Tögrög
- mop: Macanese Pataca
- mro: Mauritanian Ouguiya
- mur: Mauritian Rupee
- mvr: Maldivian Rufiyaa
- mwk: Malawian Kwacha
- mxn: Mexican Peso
- myr: Malaysian Ringgit
- mzn: Mozambican Metical
- nad: Namibian Dollar
- ngn: Nigerian Naira
- nio: Nicaraguan Córdoba
- nok: Norwegian Krone
- npr: Nepalese Rupee
- nzd: New Zealand Dollar
- pab: Panamanian Balboa
- pen: Peruvian Nuevo Sol
- pgk: Papua New Guinean Kina
- php: Philippine Peso
- pkr: Pakistani Rupee
- pln: Polish Złoty
- pyg: Paraguayan Guaraní
- qar: Qatari Riyal
- ron: Romanian Leu
- rsd: Serbian Dinar
- rub: Russian Ruble
- rwf: Rwandan Franc
- sar: Saudi Riyal
- sbd: Solomon Islands Dollar
- scr: Seychellois Rupee
- sek: Swedish Krona
- sgd: Singapore Dollar
- shp: Saint Helenian Pound
- sll: Sierra Leonean Leone
- sos: Somali Shilling
- srd: Surinamese Dollar
- std: São Tomé and Príncipe Dobra
- svc: Salvadoran Colón
- szl: Swazi Lilangeni
- thb: Thai Baht
- tjs: Tajikistani Somoni
- top: Tongan Paʻanga
- try: Turkish Lira
- ttd: Trinidad and Tobago Dollar
- twd: New Taiwan Dollar
- tzs: Tanzanian Shilling
- uah: Ukrainian Hryvnia
- ugx: Ugandan Shilling
- usd: United States Dollar
- uyu: Uruguayan Peso
- uzs: Uzbekistani Som
- vef: Venezuelan Bolívar
- vnd: Vietnamese Đồng
- vuv: Vanuatu Vatu
- wst: Samoan Tala
- xaf: Central African Cfa Franc
- xcd: East Caribbean Dollar
- xof: West African Cfa Franc
- xpf: Cfp Franc
- yer: Yemeni Rial
- zar: South African Rand
- zmw: Zambian Kwacha
delinquentbooleanoptional
emailstringEmail Addressoptional
idstringoptional
metadataobjectoptional
namestringoptional
phonestringPhone Numberoptional

POST/user/payment

$ curl -X POST "https://api.kittycad.io/user/payment" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/json" \
	--data '{
  "address": {
    "city": "MJGm9SCspKzrw3ZfGfVMPyr",
    "country": "CA",
    "state": "2RQ1",
    "street1": "4gaJwqHfZ",
    "street2": "pqBJwS7EtjacpxR0KSvC906y",
    "user_id": "HIhTrEWRNwbOEgcfRUTXT1qE",
    "zip": "xq"
  },
  "name": "nXha10j2zuiDT9neR",
  "phone": "+1-541-984-9186"
}'

201 Created

Response

{
  "address": {
    "city": "Y1ad1jYRTCBo",
    "country": "MC",
    "state": "okuolieLm5M",
    "street1": "y3rWIQODxNYRLSSkA8aNTBIEYg",
    "street2": "33s6ME1",
    "user_id": "nSoVDIEzxRrRJplJnCDg4VOmZ",
    "zip": "Jyk"
  },
  "balance": "29.02",
  "created_at": "2023-06-02T19:34:53.060Z",
  "currency": "lrd",
  "delinquent": true,
  "email": "N@CvK9r4WrmU.com",
  "id": "YYnU6YmlQ17GL5",
  "metadata": {},
  "name": "00rOhfeqG0zQ",
  "phone": "+1-941-976-7052"
}

Update payment info for your user

Parameters

bodyapplication/jsonobjectoptional
Object
- addressobjectoptional
  Object
  - citystringoptional
  - countrystringoptional
    Possible values
    249 possible values
    - AF: Afghanistan
    - AX: Åland Islands
    - AL: Albania
    - DZ: Algeria
    - AS: American Samoa
    - AD: Andorra
    - AO: Angola
    - AI: Anguilla
    - AQ: Antarctica
    - AG: Antigua and Barbuda
    - AR: Argentina
    - AM: Armenia
    - AW: Aruba
    - AU: Australia
    - AT: Austria
    - AZ: Azerbaijan
    - BS: Bahamas
    - BH: Bahrain
    - BD: Bangladesh
    - BB: Barbados
    - BY: Belarus
    - BE: Belgium
    - BZ: Belize
    - BJ: Benin
    - BM: Bermuda
    - BT: Bhutan
    - BO: Bolivia (Plurinational State of)
    - BQ: Bonaire, Sint Eustatius and Saba
    - BA: Bosnia and Herzegovina
    - BW: Botswana
    - BV: Bouvet Island
    - BR: Brazil
    - IO: British Indian Ocean Territory
    - BN: Brunei Darussalam
    - BG: Bulgaria
    - BF: Burkina Faso
    - BI: Burundi
    - CV: Cabo Verde
    - KH: Cambodia
    - CM: Cameroon
    - CA: Canada
    - KY: Cayman Islands
    - CF: Central African Republic
    - TD: Chad
    - CL: Chile
    - CN: China
    - CX: Christmas Island
    - CC: Cocos (Keeling) Islands
    - CO: Colombia
    - KM: Comoros
    - CG: Congo
    - CD: Congo (Democratic Republic of the)
    - CK: Cook Islands
    - CR: Costa Rica
    - CI: Côte d'Ivoire
    - HR: Croatia
    - CU: Cuba
    - CW: Curaçao
    - CY: Cyprus
    - CZ: Czechia
    - DK: Denmark
    - DJ: Djibouti
    - DM: Dominica
    - DO: Dominican Republic
    - EC: Ecuador
    - EG: Egypt
    - SV: El Salvador
    - GQ: Equatorial Guinea
    - ER: Eritrea
    - EE: Estonia
    - ET: Ethiopia
    - FK: Falkland Islands (Malvinas)
    - FO: Faroe Islands
    - FJ: Fiji
    - FI: Finland
    - FR: France
    - GF: French Guiana
    - PF: French Polynesia
    - TF: French Southern Territories
    - GA: Gabon
    - GM: Gambia
    - GE: Georgia
    - DE: Germany
    - GH: Ghana
    - GI: Gibraltar
    - GR: Greece
    - GL: Greenland
    - GD: Grenada
    - GP: Guadeloupe
    - GU: Guam
    - GT: Guatemala
    - GG: Guernsey
    - GN: Guinea
    - GW: Guinea-Bissau
    - GY: Guyana
    - HT: Haiti
    - HM: Heard Island and McDonald Islands
    - VA: Holy See
    - HN: Honduras
    - HK: Hong Kong
    - HU: Hungary
    - IS: Iceland
    - IN: India
    - ID: Indonesia
    - IR: Iran (Islamic Republic of)
    - IQ: Iraq
    - IE: Ireland
    - IM: Isle of Man
    - IL: Israel
    - IT: Italy
    - JM: Jamaica
    - JP: Japan
    - JE: Jersey
    - JO: Jordan
    - KZ: Kazakhstan
    - KE: Kenya
    - KI: Kiribati
    - KP: Korea (Democratic People's Republic of)
    - KR: Korea (Republic of)
    - KW: Kuwait
    - KG: Kyrgyzstan
    - LA: Lao People's Democratic Republic
    - LV: Latvia
    - LB: Lebanon
    - LS: Lesotho
    - LR: Liberia
    - LY: Libya
    - LI: Liechtenstein
    - LT: Lithuania
    - LU: Luxembourg
    - MO: Macao
    - MK: Macedonia (the former Yugoslav Republic of)
    - MG: Madagascar
    - MW: Malawi
    - MY: Malaysia
    - MV: Maldives
    - ML: Mali
    - MT: Malta
    - MH: Marshall Islands
    - MQ: Martinique
    - MR: Mauritania
    - MU: Mauritius
    - YT: Mayotte
    - MX: Mexico
    - FM: Micronesia (Federated States of)
    - MD: Moldova (Republic of)
    - MC: Monaco
    - MN: Mongolia
    - ME: Montenegro
    - MS: Montserrat
    - MA: Morocco
    - MZ: Mozambique
    - MM: Myanmar
    - NA: Namibia
    - NR: Nauru
    - NP: Nepal
    - NL: Netherlands
    - NC: New Caledonia
    - NZ: New Zealand
    - NI: Nicaragua
    - NE: Niger
    - NG: Nigeria
    - NU: Niue
    - NF: Norfolk Island
    - MP: Northern Mariana Islands
    - NO: Norway
    - OM: Oman
    - PK: Pakistan
    - PW: Palau
    - PS: Palestine, State of
    - PA: Panama
    - PG: Papua New Guinea
    - PY: Paraguay
    - PE: Peru
    - PH: Philippines
    - PN: Pitcairn
    - PL: Poland
    - PT: Portugal
    - PR: Puerto Rico
    - QA: Qatar
    - RE: Réunion
    - RO: Romania
    - RU: Russian Federation
    - RW: Rwanda
    - BL: Saint Barthélemy
    - SH: Saint Helena, Ascension and Tristan da Cunha
    - KN: Saint Kitts and Nevis
    - LC: Saint Lucia
    - MF: Saint Martin (French part)
    - PM: Saint Pierre and Miquelon
    - VC: Saint Vincent and the Grenadines
    - WS: Samoa
    - SM: San Marino
    - ST: Sao Tome and Principe
    - SA: Saudi Arabia
    - SN: Senegal
    - RS: Serbia
    - SC: Seychelles
    - SL: Sierra Leone
    - SG: Singapore
    - SX: Sint Maarten (Dutch part)
    - SK: Slovakia
    - SI: Slovenia
    - SB: Solomon Islands
    - SO: Somalia
    - ZA: South Africa
    - GS: South Georgia and the South Sandwich Islands
    - SS: South Sudan
    - ES: Spain
    - LK: Sri Lanka
    - SD: Sudan
    - SR: Suriname
    - SJ: Svalbard and Jan Mayen
    - SZ: Swaziland
    - SE: Sweden
    - CH: Switzerland
    - SY: Syrian Arab Republic
    - TW: Taiwan, Province of China
    - TJ: Tajikistan
    - TZ: Tanzania, United Republic of
    - TH: Thailand
    - TL: Timor-Leste
    - TG: Togo
    - TK: Tokelau
    - TO: Tonga
    - TT: Trinidad and Tobago
    - TN: Tunisia
    - TR: Turkey
    - TM: Turkmenistan
    - TC: Turks and Caicos Islands
    - TV: Tuvalu
    - UG: Uganda
    - UA: Ukraine
    - AE: United Arab Emirates
    - GB: United Kingdom of Great Britain and Northern Ireland
    - US: United States of America
    - UM: United States Minor Outlying Islands
    - UY: Uruguay
    - UZ: Uzbekistan
    - VU: Vanuatu
    - VE: Venezuela (Bolivarian Republic of)
    - VN: Viet Nam
    - VG: Virgin Islands (British)
    - VI: Virgin Islands (U.S.)
    - WF: Wallis and Futuna
    - EH: Western Sahara
    - YE: Yemen
    - ZM: Zambia
    - ZW: Zimbabwe
  - statestringoptional
  - street1stringoptional
  - street2stringoptional
  - user_idstringoptional
  - zipstringoptional
- namestringoptional
- phonestringPhone Numberoptional

Returns

200 OK

successful operation

addressobjectoptional
Object
- citystringoptional
- countrystringoptional
  Possible values
  249 possible values
  - AF: Afghanistan
  - AX: Åland Islands
  - AL: Albania
  - DZ: Algeria
  - AS: American Samoa
  - AD: Andorra
  - AO: Angola
  - AI: Anguilla
  - AQ: Antarctica
  - AG: Antigua and Barbuda
  - AR: Argentina
  - AM: Armenia
  - AW: Aruba
  - AU: Australia
  - AT: Austria
  - AZ: Azerbaijan
  - BS: Bahamas
  - BH: Bahrain
  - BD: Bangladesh
  - BB: Barbados
  - BY: Belarus
  - BE: Belgium
  - BZ: Belize
  - BJ: Benin
  - BM: Bermuda
  - BT: Bhutan
  - BO: Bolivia (Plurinational State of)
  - BQ: Bonaire, Sint Eustatius and Saba
  - BA: Bosnia and Herzegovina
  - BW: Botswana
  - BV: Bouvet Island
  - BR: Brazil
  - IO: British Indian Ocean Territory
  - BN: Brunei Darussalam
  - BG: Bulgaria
  - BF: Burkina Faso
  - BI: Burundi
  - CV: Cabo Verde
  - KH: Cambodia
  - CM: Cameroon
  - CA: Canada
  - KY: Cayman Islands
  - CF: Central African Republic
  - TD: Chad
  - CL: Chile
  - CN: China
  - CX: Christmas Island
  - CC: Cocos (Keeling) Islands
  - CO: Colombia
  - KM: Comoros
  - CG: Congo
  - CD: Congo (Democratic Republic of the)
  - CK: Cook Islands
  - CR: Costa Rica
  - CI: Côte d'Ivoire
  - HR: Croatia
  - CU: Cuba
  - CW: Curaçao
  - CY: Cyprus
  - CZ: Czechia
  - DK: Denmark
  - DJ: Djibouti
  - DM: Dominica
  - DO: Dominican Republic
  - EC: Ecuador
  - EG: Egypt
  - SV: El Salvador
  - GQ: Equatorial Guinea
  - ER: Eritrea
  - EE: Estonia
  - ET: Ethiopia
  - FK: Falkland Islands (Malvinas)
  - FO: Faroe Islands
  - FJ: Fiji
  - FI: Finland
  - FR: France
  - GF: French Guiana
  - PF: French Polynesia
  - TF: French Southern Territories
  - GA: Gabon
  - GM: Gambia
  - GE: Georgia
  - DE: Germany
  - GH: Ghana
  - GI: Gibraltar
  - GR: Greece
  - GL: Greenland
  - GD: Grenada
  - GP: Guadeloupe
  - GU: Guam
  - GT: Guatemala
  - GG: Guernsey
  - GN: Guinea
  - GW: Guinea-Bissau
  - GY: Guyana
  - HT: Haiti
  - HM: Heard Island and McDonald Islands
  - VA: Holy See
  - HN: Honduras
  - HK: Hong Kong
  - HU: Hungary
  - IS: Iceland
  - IN: India
  - ID: Indonesia
  - IR: Iran (Islamic Republic of)
  - IQ: Iraq
  - IE: Ireland
  - IM: Isle of Man
  - IL: Israel
  - IT: Italy
  - JM: Jamaica
  - JP: Japan
  - JE: Jersey
  - JO: Jordan
  - KZ: Kazakhstan
  - KE: Kenya
  - KI: Kiribati
  - KP: Korea (Democratic People's Republic of)
  - KR: Korea (Republic of)
  - KW: Kuwait
  - KG: Kyrgyzstan
  - LA: Lao People's Democratic Republic
  - LV: Latvia
  - LB: Lebanon
  - LS: Lesotho
  - LR: Liberia
  - LY: Libya
  - LI: Liechtenstein
  - LT: Lithuania
  - LU: Luxembourg
  - MO: Macao
  - MK: Macedonia (the former Yugoslav Republic of)
  - MG: Madagascar
  - MW: Malawi
  - MY: Malaysia
  - MV: Maldives
  - ML: Mali
  - MT: Malta
  - MH: Marshall Islands
  - MQ: Martinique
  - MR: Mauritania
  - MU: Mauritius
  - YT: Mayotte
  - MX: Mexico
  - FM: Micronesia (Federated States of)
  - MD: Moldova (Republic of)
  - MC: Monaco
  - MN: Mongolia
  - ME: Montenegro
  - MS: Montserrat
  - MA: Morocco
  - MZ: Mozambique
  - MM: Myanmar
  - NA: Namibia
  - NR: Nauru
  - NP: Nepal
  - NL: Netherlands
  - NC: New Caledonia
  - NZ: New Zealand
  - NI: Nicaragua
  - NE: Niger
  - NG: Nigeria
  - NU: Niue
  - NF: Norfolk Island
  - MP: Northern Mariana Islands
  - NO: Norway
  - OM: Oman
  - PK: Pakistan
  - PW: Palau
  - PS: Palestine, State of
  - PA: Panama
  - PG: Papua New Guinea
  - PY: Paraguay
  - PE: Peru
  - PH: Philippines
  - PN: Pitcairn
  - PL: Poland
  - PT: Portugal
  - PR: Puerto Rico
  - QA: Qatar
  - RE: Réunion
  - RO: Romania
  - RU: Russian Federation
  - RW: Rwanda
  - BL: Saint Barthélemy
  - SH: Saint Helena, Ascension and Tristan da Cunha
  - KN: Saint Kitts and Nevis
  - LC: Saint Lucia
  - MF: Saint Martin (French part)
  - PM: Saint Pierre and Miquelon
  - VC: Saint Vincent and the Grenadines
  - WS: Samoa
  - SM: San Marino
  - ST: Sao Tome and Principe
  - SA: Saudi Arabia
  - SN: Senegal
  - RS: Serbia
  - SC: Seychelles
  - SL: Sierra Leone
  - SG: Singapore
  - SX: Sint Maarten (Dutch part)
  - SK: Slovakia
  - SI: Slovenia
  - SB: Solomon Islands
  - SO: Somalia
  - ZA: South Africa
  - GS: South Georgia and the South Sandwich Islands
  - SS: South Sudan
  - ES: Spain
  - LK: Sri Lanka
  - SD: Sudan
  - SR: Suriname
  - SJ: Svalbard and Jan Mayen
  - SZ: Swaziland
  - SE: Sweden
  - CH: Switzerland
  - SY: Syrian Arab Republic
  - TW: Taiwan, Province of China
  - TJ: Tajikistan
  - TZ: Tanzania, United Republic of
  - TH: Thailand
  - TL: Timor-Leste
  - TG: Togo
  - TK: Tokelau
  - TO: Tonga
  - TT: Trinidad and Tobago
  - TN: Tunisia
  - TR: Turkey
  - TM: Turkmenistan
  - TC: Turks and Caicos Islands
  - TV: Tuvalu
  - UG: Uganda
  - UA: Ukraine
  - AE: United Arab Emirates
  - GB: United Kingdom of Great Britain and Northern Ireland
  - US: United States of America
  - UM: United States Minor Outlying Islands
  - UY: Uruguay
  - UZ: Uzbekistan
  - VU: Vanuatu
  - VE: Venezuela (Bolivarian Republic of)
  - VN: Viet Nam
  - VG: Virgin Islands (British)
  - VI: Virgin Islands (U.S.)
  - WF: Wallis and Futuna
  - EH: Western Sahara
  - YE: Yemen
  - ZM: Zambia
  - ZW: Zimbabwe
- statestringoptional
- street1stringoptional
- street2stringoptional
- user_idstringoptional
- zipstringoptional
balancenumberUSD Priceoptional
created_atstringISO-8601optional
currencystringoptional
Possible values
139 possible values
- aed: United Arab Emirates Dirham
- afn: Afghan Afghani
- all: Albanian Lek
- amd: Armenian Dram
- ang: Netherlands Antillean Gulden
- aoa: Angolan Kwanza
- ars: Argentine Peso
- aud: Australian Dollar
- awg: Aruban Florin
- azn: Azerbaijani Manat
- bam: Bosnia & Herzegovina Convertible Mark
- bbd: Barbadian Dollar
- bdt: Bangladeshi Taka
- bgn: Bulgarian Lev
- bif: Burundian Franc
- bmd: Bermudian Dollar
- bnd: Brunei Dollar
- bob: Bolivian Boliviano
- brl: Brazilian Real
- bsd: Bahamian Dollar
- bwp: Botswana Pula
- bzd: Belize Dollar
- cad: Canadian Dollar
- cdf: Congolese Franc
- chf: Swiss Franc
- clp: Chilean Peso
- cny: Chinese Renminbi Yuan
- cop: Colombian Peso
- crc: Costa Rican Colón
- cve: Cape Verdean Escudo
- czk: Czech Koruna
- djf: Djiboutian Franc
- dkk: Danish Krone
- dop: Dominican Peso
- dzd: Algerian Dinar
- eek: Estonian Kroon
- egp: Egyptian Pound
- etb: Ethiopian Birr
- eur: Euro
- fjd: Fijian Dollar
- fkp: Falkland Islands Pound
- gbp: British Pound
- gel: Georgian Lari
- gip: Gibraltar Pound
- gmd: Gambian Dalasi
- gnf: Guinean Franc
- gtq: Guatemalan Quetzal
- gyd: Guyanese Dollar
- hkd: Hong Kong Dollar
- hnl: Honduran Lempira
- hrk: Croatian Kuna
- htg: Haitian Gourde
- huf: Hungarian Forint
- idr: Indonesian Rupiah
- ils: Israeli New Sheqel
- inr: Indian Rupee
- isk: Icelandic Króna
- jmd: Jamaican Dollar
- jpy: Japanese Yen
- kes: Kenyan Shilling
- kgs: Kyrgyzstani Som
- khr: Cambodian Riel
- kmf: Comorian Franc
- krw: South Korean Won
- kyd: Cayman Islands Dollar
- kzt: Kazakhstani Tenge
- lak: Lao Kip
- lbp: Lebanese Pound
- lkr: Sri Lankan Rupee
- lrd: Liberian Dollar
- lsl: Lesotho Loti
- ltl: Lithuanian Litas
- lvl: Latvian Lats
- mad: Moroccan Dirham
- mdl: Moldovan Leu
- mga: Malagasy Ariary
- mkd: Macedonian Denar
- mnt: Mongolian Tögrög
- mop: Macanese Pataca
- mro: Mauritanian Ouguiya
- mur: Mauritian Rupee
- mvr: Maldivian Rufiyaa
- mwk: Malawian Kwacha
- mxn: Mexican Peso
- myr: Malaysian Ringgit
- mzn: Mozambican Metical
- nad: Namibian Dollar
- ngn: Nigerian Naira
- nio: Nicaraguan Córdoba
- nok: Norwegian Krone
- npr: Nepalese Rupee
- nzd: New Zealand Dollar
- pab: Panamanian Balboa
- pen: Peruvian Nuevo Sol
- pgk: Papua New Guinean Kina
- php: Philippine Peso
- pkr: Pakistani Rupee
- pln: Polish Złoty
- pyg: Paraguayan Guaraní
- qar: Qatari Riyal
- ron: Romanian Leu
- rsd: Serbian Dinar
- rub: Russian Ruble
- rwf: Rwandan Franc
- sar: Saudi Riyal
- sbd: Solomon Islands Dollar
- scr: Seychellois Rupee
- sek: Swedish Krona
- sgd: Singapore Dollar
- shp: Saint Helenian Pound
- sll: Sierra Leonean Leone
- sos: Somali Shilling
- srd: Surinamese Dollar
- std: São Tomé and Príncipe Dobra
- svc: Salvadoran Colón
- szl: Swazi Lilangeni
- thb: Thai Baht
- tjs: Tajikistani Somoni
- top: Tongan Paʻanga
- try: Turkish Lira
- ttd: Trinidad and Tobago Dollar
- twd: New Taiwan Dollar
- tzs: Tanzanian Shilling
- uah: Ukrainian Hryvnia
- ugx: Ugandan Shilling
- usd: United States Dollar
- uyu: Uruguayan Peso
- uzs: Uzbekistani Som
- vef: Venezuelan Bolívar
- vnd: Vietnamese Đồng
- vuv: Vanuatu Vatu
- wst: Samoan Tala
- xaf: Central African Cfa Franc
- xcd: East Caribbean Dollar
- xof: West African Cfa Franc
- xpf: Cfp Franc
- yer: Yemeni Rial
- zar: South African Rand
- zmw: Zambian Kwacha
delinquentbooleanoptional
emailstringEmail Addressoptional
idstringoptional
metadataobjectoptional
namestringoptional
phonestringPhone Numberoptional

PUT/user/payment

$ curl -X PUT "https://api.kittycad.io/user/payment" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/json" \
	--data '{
  "address": {
    "city": "mVk4GLilcXGJGJV4xgfz",
    "country": "NP",
    "state": "QCzJBv",
    "street1": "txsqR6y",
    "street2": "iID9dAn",
    "user_id": "qGHj6iuc",
    "zip": "8Bx8bvhanj0q3"
  },
  "name": "yPCnhavRoy",
  "phone": "+1-996-317-8025"
}'

200 OK

Response

{
  "address": {
    "city": "5w82UiaTUlKw8cyy0uMYXWCjkNW",
    "country": "DJ",
    "state": "AlqHDHUp7FdqE0",
    "street1": "gg4RZuBj64",
    "street2": "gyeFWqBmT76UaSWosYqj58C3F03rNl",
    "user_id": "j9WVONamFKz",
    "zip": "VIXPaYMy4ZY8b7HR6Z4y9ISMUEjQ"
  },
  "balance": "56.43",
  "created_at": "2023-06-02T19:34:53.072Z",
  "currency": "nok",
  "delinquent": true,
  "email": "n@S8GtEhV.com",
  "id": "Bql6JYYvUlHYAPjkqnG7tyxgmdf12D",
  "metadata": {},
  "name": "ofi4b",
  "phone": "+1-483-805-1207"
}

Get balance for your user

Parameters

No parameters

Returns

200 OK

successful operation

created_atstringISO-8601optional
idstringUUIDoptional
monthly_credits_remainingnumberUSD Priceoptional
pre_pay_cash_remainingnumberUSD Priceoptional
pre_pay_credits_remainingnumberUSD Priceoptional
total_duenumberUSD Priceoptional
updated_atstringISO-8601optional
user_idstringoptional

GET/user/payment/balance

$ curl "https://api.kittycad.io/user/payment/balance" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "created_at": "2023-06-02T19:34:53.081Z",
  "id": "af1aad26-47c0-4d55-89d5-cfb8af341a9d",
  "monthly_credits_remaining": "11.00",
  "pre_pay_cash_remaining": "56.97",
  "pre_pay_credits_remaining": "47.06",
  "total_due": "72.70",
  "updated_at": "2023-06-02T19:34:53.081Z",
  "user_id": "wwZVJVKbyyvL9fTG6"
}

List invoices for your user

Parameters

No parameters

Returns

200 OK

successful operation

GET/user/payment/invoices

$ curl "https://api.kittycad.io/user/payment/invoices" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

[
  {
    "amount_due": "10.05",
    "amount_paid": "90.26",
    "amount_remaining": "77.04",
    "attempt_count": 16,
    "attempted": true,
    "created_at": "2023-06-02T19:34:53.084Z",
    "currency": "lvl",
    "customer_email": "WAUNnhw6K8@.com",
    "customer_id": "REV8qiROAxYHVO4Hvjw1E9ksDo1",
    "default_payment_method": "w6fvEezj1QUDJD2rta",
    "description": "WwR",
    "id": "ZHuqYiHjGLSn1m82nd4Hqx",
    "lines": [
      {
        "amount": "34.71",
        "currency": "inr",
        "description": "YAwKA7IazsZVa0mTqqrILNpNoCx5y",
        "id": "CXF8b0Ab",
        "invoice_item": "kVs0z0aUKym5gp",
        "metadata": {}
      }
    ],
    "metadata": {},
    "number": "9YNsbufpT8x2c1VRXpGXzwx",
    "paid": true,
    "pdf": "https://Voc253rgbp.DY8C6aDc6.com/5FF7zOaAI4Hu/1SbAi4EAk",
    "receipt_number": "pD88",
    "statement_descriptor": "L1wrLBE57",
    "status": "paid",
    "subtotal": "69.54",
    "tax": "66.07",
    "total": "35.84",
    "url": "https://.YHNw86eIL.com//IRREdmvqg"
  }
]

List payment methods for your user

Parameters

No parameters

Returns

200 OK

successful operation

GET/user/payment/methods

$ curl "https://api.kittycad.io/user/payment/methods" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

[
  {
    "billing_info": {
      "address": {
        "city": "dwUUvwyoSg9GlHoKgKQq9o7PUg9",
        "country": "IM",
        "state": "o9sqgW1FqBGhzQt0",
        "street1": "4pa7OM8",
        "street2": "ybXZMuDjVCQ7yvXBL4T5zGZcxhQh7",
        "user_id": "N1Bl9tBeXLSnVQCdQeczqRfQ22rN7",
        "zip": "dRrDYpbc"
      },
      "name": "Y6aG77vIzd",
      "phone": "+1-424-287-4232"
    },
    "card": {
      "brand": "YGkinbS4W1",
      "checks": {
        "address_line1_check": "eGCmfwLUiZJ1NCHQrjfCvmA",
        "address_postal_code_check": "HfrWWws7qVI3W7NRBfVLlQ",
        "cvc_check": "dQctv5FH1SvrzY2yvln"
      },
      "country": "dqPbrbsAgvbbMpgkCtvbiH",
      "exp_month": 26,
      "exp_year": 8,
      "fingerprint": "deskT7DN7EjXL84K",
      "funding": "j5qVGVbSwxqxCH1gKqj",
      "last4": "dHj30H4sRdf7IO2wsj3Hj57ms"
    },
    "created_at": "2023-06-02T19:34:53.089Z",
    "id": "T0gXIwJhK9OJS0Frauf1v",
    "metadata": {},
    "type": "card"
  }
]

Unit

Endpoints

GET/unit/conversion/angle/{input_unit}/{output_unit}

GET/unit/conversion/area/{input_unit}/{output_unit}

GET/unit/conversion/current/{input_unit}/{output_unit}

GET/unit/conversion/energy/{input_unit}/{output_unit}

GET/unit/conversion/force/{input_unit}/{output_unit}

GET/unit/conversion/frequency/{input_unit}/{output_unit}

GET/unit/conversion/length/{input_unit}/{output_unit}

GET/unit/conversion/mass/{input_unit}/{output_unit}

GET/unit/conversion/power/{input_unit}/{output_unit}

GET/unit/conversion/pressure/{input_unit}/{output_unit}

GET/unit/conversion/temperature/{input_unit}/{output_unit}

GET/unit/conversion/torque/{input_unit}/{output_unit}

GET/unit/conversion/volume/{input_unit}/{output_unit}

Convert angle units

Parameters

input_unitstringrequired
Possible values
- degrees: Degrees <https://en.wikipedia.org/wiki/Degree_(angle)>
- radians: Radians <https://en.wikipedia.org/wiki/Radian>
output_unitstringrequired
Possible values
- degrees: Degrees <https://en.wikipedia.org/wiki/Degree_(angle)>
- radians: Radians <https://en.wikipedia.org/wiki/Radian>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- degrees: Degrees <https://en.wikipedia.org/wiki/Degree_(angle)>
- radians: Radians <https://en.wikipedia.org/wiki/Radian>
outputnumberoptional
output_unitstringoptional
Possible values
- degrees: Degrees <https://en.wikipedia.org/wiki/Degree_(angle)>
- radians: Radians <https://en.wikipedia.org/wiki/Radian>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/angle/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/angle/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.098Z",
  "created_at": "2023-06-02T19:34:53.098Z",
  "error": "sdoI",
  "id": "b5f6988c-cd19-437d-9f4d-39eaed98a468",
  "input": 15,
  "input_unit": "radians",
  "output": 25,
  "output_unit": "radians",
  "started_at": "2023-06-02T19:34:53.098Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.098Z",
  "user_id": "roUhWvT1jLMzgZ"
}

Convert area units

Parameters

input_unitstringrequired
Possible values
- acres: Acres <https://en.wikipedia.org/wiki/Acre>
- hectares: Hectares <https://en.wikipedia.org/wiki/Hectare>
- square_centimetres: Square centimetres <https://en.wikipedia.org/wiki/Square_centimetre>
- square_decimetres: Square decimetres <https://en.wikipedia.org/wiki/Square_decimetre>
- square_feet: Square feet <https://en.wikipedia.org/wiki/Square_foot>
- square_hectometres: Square hectometres <https://en.wikipedia.org/wiki/Square_hectometre>
- square_inches: Square inches <https://en.wikipedia.org/wiki/Square_inch>
- square_kilometres: Square kilometres <https://en.wikipedia.org/wiki/Square_kilometre>
- square_metres: Square metres <https://en.wikipedia.org/wiki/Square_metre>
- square_micrometres: Square micrometres <https://en.wikipedia.org/wiki/Square_micrometre>
- square_miles: Square miles <https://en.wikipedia.org/wiki/Square_mile>
- square_millimetres: Square millimetres <https://en.wikipedia.org/wiki/Square_millimetre>
- square_nanometres: Square nanometres <https://en.wikipedia.org/wiki/Square_nanometre>
- square_yards: Square yards <https://en.wikipedia.org/wiki/Square_mile>
output_unitstringrequired
Possible values
- acres: Acres <https://en.wikipedia.org/wiki/Acre>
- hectares: Hectares <https://en.wikipedia.org/wiki/Hectare>
- square_centimetres: Square centimetres <https://en.wikipedia.org/wiki/Square_centimetre>
- square_decimetres: Square decimetres <https://en.wikipedia.org/wiki/Square_decimetre>
- square_feet: Square feet <https://en.wikipedia.org/wiki/Square_foot>
- square_hectometres: Square hectometres <https://en.wikipedia.org/wiki/Square_hectometre>
- square_inches: Square inches <https://en.wikipedia.org/wiki/Square_inch>
- square_kilometres: Square kilometres <https://en.wikipedia.org/wiki/Square_kilometre>
- square_metres: Square metres <https://en.wikipedia.org/wiki/Square_metre>
- square_micrometres: Square micrometres <https://en.wikipedia.org/wiki/Square_micrometre>
- square_miles: Square miles <https://en.wikipedia.org/wiki/Square_mile>
- square_millimetres: Square millimetres <https://en.wikipedia.org/wiki/Square_millimetre>
- square_nanometres: Square nanometres <https://en.wikipedia.org/wiki/Square_nanometre>
- square_yards: Square yards <https://en.wikipedia.org/wiki/Square_mile>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- acres: Acres <https://en.wikipedia.org/wiki/Acre>
- hectares: Hectares <https://en.wikipedia.org/wiki/Hectare>
- square_centimetres: Square centimetres <https://en.wikipedia.org/wiki/Square_centimetre>
- square_decimetres: Square decimetres <https://en.wikipedia.org/wiki/Square_decimetre>
- square_feet: Square feet <https://en.wikipedia.org/wiki/Square_foot>
- square_hectometres: Square hectometres <https://en.wikipedia.org/wiki/Square_hectometre>
- square_inches: Square inches <https://en.wikipedia.org/wiki/Square_inch>
- square_kilometres: Square kilometres <https://en.wikipedia.org/wiki/Square_kilometre>
- square_metres: Square metres <https://en.wikipedia.org/wiki/Square_metre>
- square_micrometres: Square micrometres <https://en.wikipedia.org/wiki/Square_micrometre>
- square_miles: Square miles <https://en.wikipedia.org/wiki/Square_mile>
- square_millimetres: Square millimetres <https://en.wikipedia.org/wiki/Square_millimetre>
- square_nanometres: Square nanometres <https://en.wikipedia.org/wiki/Square_nanometre>
- square_yards: Square yards <https://en.wikipedia.org/wiki/Square_mile>
outputnumberoptional
output_unitstringoptional
Possible values
- acres: Acres <https://en.wikipedia.org/wiki/Acre>
- hectares: Hectares <https://en.wikipedia.org/wiki/Hectare>
- square_centimetres: Square centimetres <https://en.wikipedia.org/wiki/Square_centimetre>
- square_decimetres: Square decimetres <https://en.wikipedia.org/wiki/Square_decimetre>
- square_feet: Square feet <https://en.wikipedia.org/wiki/Square_foot>
- square_hectometres: Square hectometres <https://en.wikipedia.org/wiki/Square_hectometre>
- square_inches: Square inches <https://en.wikipedia.org/wiki/Square_inch>
- square_kilometres: Square kilometres <https://en.wikipedia.org/wiki/Square_kilometre>
- square_metres: Square metres <https://en.wikipedia.org/wiki/Square_metre>
- square_micrometres: Square micrometres <https://en.wikipedia.org/wiki/Square_micrometre>
- square_miles: Square miles <https://en.wikipedia.org/wiki/Square_mile>
- square_millimetres: Square millimetres <https://en.wikipedia.org/wiki/Square_millimetre>
- square_nanometres: Square nanometres <https://en.wikipedia.org/wiki/Square_nanometre>
- square_yards: Square yards <https://en.wikipedia.org/wiki/Square_mile>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/area/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/area/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.103Z",
  "created_at": "2023-06-02T19:34:53.103Z",
  "error": "5F8FIQmfMTZ5hpncRgeIR5ZB",
  "id": "7f447565-b604-4ed8-a066-3ea4c6e4fd46",
  "input": 29,
  "input_unit": "square_miles",
  "output": 20,
  "output_unit": "square_millimetres",
  "started_at": "2023-06-02T19:34:53.103Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.103Z",
  "user_id": "lDqY1x8"
}

Convert current units

Parameters

input_unitstringrequired
Possible values
- amperes: Amperes <https://en.wikipedia.org/wiki/Ampere>
- microamperes: Microamperes <https://en.wikipedia.org/wiki/Microampere>
- milliamperes: Milliamperes <https://en.wikipedia.org/wiki/Milliampere>
- nanoamperes: Nanoamperes <https://en.wikipedia.org/wiki/Nanoampere>
output_unitstringrequired
Possible values
- amperes: Amperes <https://en.wikipedia.org/wiki/Ampere>
- microamperes: Microamperes <https://en.wikipedia.org/wiki/Microampere>
- milliamperes: Milliamperes <https://en.wikipedia.org/wiki/Milliampere>
- nanoamperes: Nanoamperes <https://en.wikipedia.org/wiki/Nanoampere>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- amperes: Amperes <https://en.wikipedia.org/wiki/Ampere>
- microamperes: Microamperes <https://en.wikipedia.org/wiki/Microampere>
- milliamperes: Milliamperes <https://en.wikipedia.org/wiki/Milliampere>
- nanoamperes: Nanoamperes <https://en.wikipedia.org/wiki/Nanoampere>
outputnumberoptional
output_unitstringoptional
Possible values
- amperes: Amperes <https://en.wikipedia.org/wiki/Ampere>
- microamperes: Microamperes <https://en.wikipedia.org/wiki/Microampere>
- milliamperes: Milliamperes <https://en.wikipedia.org/wiki/Milliampere>
- nanoamperes: Nanoamperes <https://en.wikipedia.org/wiki/Nanoampere>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/current/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/current/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.113Z",
  "created_at": "2023-06-02T19:34:53.113Z",
  "error": "nyhSPQwsHtctC",
  "id": "f87b9b6c-b1a8-4e66-b7ce-8ab5ff31fd64",
  "input": 8,
  "input_unit": "microamperes",
  "output": 25,
  "output_unit": "microamperes",
  "started_at": "2023-06-02T19:34:53.113Z",
  "status": "In Progress",
  "updated_at": "2023-06-02T19:34:53.113Z",
  "user_id": "rNTv0IPwZPRlqY5"
}

Convert energy units

Parameters

input_unitstringrequired
Possible values
- btu: British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
- electronvolts: Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
- joules: Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
- kilocalories: Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
- kilowatt_hours: Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
- watt_hours: Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
output_unitstringrequired
Possible values
- btu: British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
- electronvolts: Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
- joules: Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
- kilocalories: Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
- kilowatt_hours: Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
- watt_hours: Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- btu: British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
- electronvolts: Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
- joules: Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
- kilocalories: Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
- kilowatt_hours: Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
- watt_hours: Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
outputnumberoptional
output_unitstringoptional
Possible values
- btu: British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
- electronvolts: Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
- joules: Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
- kilocalories: Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
- kilowatt_hours: Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
- watt_hours: Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/energy/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/energy/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.118Z",
  "created_at": "2023-06-02T19:34:53.118Z",
  "error": "DazHookhAxf2ePmC3X5p",
  "id": "6e1835f9-d5f8-4322-bda2-7e95983c545d",
  "input": 21,
  "input_unit": "btu",
  "output": 10,
  "output_unit": "kilowatt_hours",
  "started_at": "2023-06-02T19:34:53.118Z",
  "status": "Failed",
  "updated_at": "2023-06-02T19:34:53.118Z",
  "user_id": "i4ahnGXQw"
}

Convert force units

Parameters

input_unitstringrequired
Possible values
- dynes: Dynes <https://en.wikipedia.org/wiki/Dyne>
- kiloponds: Kiloponds <https://en.wikipedia.org/wiki/Kilopond>
- micronewtons: Micronewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- millinewtons: Millinewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- newtons: Newtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- poundals: Poundals <https://en.wikipedia.org/wiki/Poundal>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(force)>
output_unitstringrequired
Possible values
- dynes: Dynes <https://en.wikipedia.org/wiki/Dyne>
- kiloponds: Kiloponds <https://en.wikipedia.org/wiki/Kilopond>
- micronewtons: Micronewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- millinewtons: Millinewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- newtons: Newtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- poundals: Poundals <https://en.wikipedia.org/wiki/Poundal>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(force)>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- dynes: Dynes <https://en.wikipedia.org/wiki/Dyne>
- kiloponds: Kiloponds <https://en.wikipedia.org/wiki/Kilopond>
- micronewtons: Micronewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- millinewtons: Millinewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- newtons: Newtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- poundals: Poundals <https://en.wikipedia.org/wiki/Poundal>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(force)>
outputnumberoptional
output_unitstringoptional
Possible values
- dynes: Dynes <https://en.wikipedia.org/wiki/Dyne>
- kiloponds: Kiloponds <https://en.wikipedia.org/wiki/Kilopond>
- micronewtons: Micronewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- millinewtons: Millinewtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- newtons: Newtons <https://en.wikipedia.org/wiki/Newton_(unit)>
- poundals: Poundals <https://en.wikipedia.org/wiki/Poundal>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(force)>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/force/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/force/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.125Z",
  "created_at": "2023-06-02T19:34:53.125Z",
  "error": "XXXpOeoXFk0r8ISw6k",
  "id": "a31b6436-0d54-492e-a335-789cc9f32dab",
  "input": 15,
  "input_unit": "dynes",
  "output": 7,
  "output_unit": "newtons",
  "started_at": "2023-06-02T19:34:53.125Z",
  "status": "In Progress",
  "updated_at": "2023-06-02T19:34:53.125Z",
  "user_id": "DN8rElHo62qSXRluPHE5uffKU"
}

Convert frequency units

Parameters

input_unitstringrequired
Possible values
- gigahertz: Gigahertz <https://en.wikipedia.org/wiki/Hertz>
- hertz: Hertz <https://en.wikipedia.org/wiki/Hertz>
- kilohertz: Kilohertz <https://en.wikipedia.org/wiki/Hertz>
- megahertz: Megahertz <https://en.wikipedia.org/wiki/Hertz>
- microhertz: Microhertz <https://en.wikipedia.org/wiki/Hertz>
- millihertz: Millihertz <https://en.wikipedia.org/wiki/Hertz>
- nanohertz: Nanohertz <https://en.wikipedia.org/wiki/Hertz>
- terahertz: Terahertz <https://en.wikipedia.org/wiki/Hertz>
output_unitstringrequired
Possible values
- gigahertz: Gigahertz <https://en.wikipedia.org/wiki/Hertz>
- hertz: Hertz <https://en.wikipedia.org/wiki/Hertz>
- kilohertz: Kilohertz <https://en.wikipedia.org/wiki/Hertz>
- megahertz: Megahertz <https://en.wikipedia.org/wiki/Hertz>
- microhertz: Microhertz <https://en.wikipedia.org/wiki/Hertz>
- millihertz: Millihertz <https://en.wikipedia.org/wiki/Hertz>
- nanohertz: Nanohertz <https://en.wikipedia.org/wiki/Hertz>
- terahertz: Terahertz <https://en.wikipedia.org/wiki/Hertz>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- gigahertz: Gigahertz <https://en.wikipedia.org/wiki/Hertz>
- hertz: Hertz <https://en.wikipedia.org/wiki/Hertz>
- kilohertz: Kilohertz <https://en.wikipedia.org/wiki/Hertz>
- megahertz: Megahertz <https://en.wikipedia.org/wiki/Hertz>
- microhertz: Microhertz <https://en.wikipedia.org/wiki/Hertz>
- millihertz: Millihertz <https://en.wikipedia.org/wiki/Hertz>
- nanohertz: Nanohertz <https://en.wikipedia.org/wiki/Hertz>
- terahertz: Terahertz <https://en.wikipedia.org/wiki/Hertz>
outputnumberoptional
output_unitstringoptional
Possible values
- gigahertz: Gigahertz <https://en.wikipedia.org/wiki/Hertz>
- hertz: Hertz <https://en.wikipedia.org/wiki/Hertz>
- kilohertz: Kilohertz <https://en.wikipedia.org/wiki/Hertz>
- megahertz: Megahertz <https://en.wikipedia.org/wiki/Hertz>
- microhertz: Microhertz <https://en.wikipedia.org/wiki/Hertz>
- millihertz: Millihertz <https://en.wikipedia.org/wiki/Hertz>
- nanohertz: Nanohertz <https://en.wikipedia.org/wiki/Hertz>
- terahertz: Terahertz <https://en.wikipedia.org/wiki/Hertz>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/frequency/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/frequency/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.131Z",
  "created_at": "2023-06-02T19:34:53.131Z",
  "error": "dCnkRm9AduNjD3y9ci0O",
  "id": "bcadbf99-e413-4eaa-b16c-f58f545c35b3",
  "input": 29,
  "input_unit": "nanohertz",
  "output": 22,
  "output_unit": "millihertz",
  "started_at": "2023-06-02T19:34:53.131Z",
  "status": "Queued",
  "updated_at": "2023-06-02T19:34:53.131Z",
  "user_id": "7"
}

Convert length units

Parameters

input_unitstringrequired
Possible values
- centimetres: Centimetres <https://en.wikipedia.org/wiki/Centimetre>
- decimetres: Decimetres <https://en.wikipedia.org/wiki/Decimetre>
- feet: Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
- furlongs: Furlongs <https://en.wikipedia.org/wiki/Furlong>
- hectometres: Hectometres <https://en.wikipedia.org/wiki/Hectometre>
- inches: Inches <https://en.wikipedia.org/wiki/Inch>
- kilometres: Kilometres <https://en.wikipedia.org/wiki/Kilometre>
- metres: Metres <https://en.wikipedia.org/wiki/Metre>
- micrometres: Micrometres <https://en.wikipedia.org/wiki/Micrometre>
- miles: Miles <https://en.wikipedia.org/wiki/Mile>
- millimetres: Millimetres <https://en.wikipedia.org/wiki/Millimetre>
- nanometres: Nanometres <https://en.wikipedia.org/wiki/Nanometre>
- yards: Yards <https://en.wikipedia.org/wiki/Yard>
output_unitstringrequired
Possible values
- centimetres: Centimetres <https://en.wikipedia.org/wiki/Centimetre>
- decimetres: Decimetres <https://en.wikipedia.org/wiki/Decimetre>
- feet: Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
- furlongs: Furlongs <https://en.wikipedia.org/wiki/Furlong>
- hectometres: Hectometres <https://en.wikipedia.org/wiki/Hectometre>
- inches: Inches <https://en.wikipedia.org/wiki/Inch>
- kilometres: Kilometres <https://en.wikipedia.org/wiki/Kilometre>
- metres: Metres <https://en.wikipedia.org/wiki/Metre>
- micrometres: Micrometres <https://en.wikipedia.org/wiki/Micrometre>
- miles: Miles <https://en.wikipedia.org/wiki/Mile>
- millimetres: Millimetres <https://en.wikipedia.org/wiki/Millimetre>
- nanometres: Nanometres <https://en.wikipedia.org/wiki/Nanometre>
- yards: Yards <https://en.wikipedia.org/wiki/Yard>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- centimetres: Centimetres <https://en.wikipedia.org/wiki/Centimetre>
- decimetres: Decimetres <https://en.wikipedia.org/wiki/Decimetre>
- feet: Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
- furlongs: Furlongs <https://en.wikipedia.org/wiki/Furlong>
- hectometres: Hectometres <https://en.wikipedia.org/wiki/Hectometre>
- inches: Inches <https://en.wikipedia.org/wiki/Inch>
- kilometres: Kilometres <https://en.wikipedia.org/wiki/Kilometre>
- metres: Metres <https://en.wikipedia.org/wiki/Metre>
- micrometres: Micrometres <https://en.wikipedia.org/wiki/Micrometre>
- miles: Miles <https://en.wikipedia.org/wiki/Mile>
- millimetres: Millimetres <https://en.wikipedia.org/wiki/Millimetre>
- nanometres: Nanometres <https://en.wikipedia.org/wiki/Nanometre>
- yards: Yards <https://en.wikipedia.org/wiki/Yard>
outputnumberoptional
output_unitstringoptional
Possible values
- centimetres: Centimetres <https://en.wikipedia.org/wiki/Centimetre>
- decimetres: Decimetres <https://en.wikipedia.org/wiki/Decimetre>
- feet: Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
- furlongs: Furlongs <https://en.wikipedia.org/wiki/Furlong>
- hectometres: Hectometres <https://en.wikipedia.org/wiki/Hectometre>
- inches: Inches <https://en.wikipedia.org/wiki/Inch>
- kilometres: Kilometres <https://en.wikipedia.org/wiki/Kilometre>
- metres: Metres <https://en.wikipedia.org/wiki/Metre>
- micrometres: Micrometres <https://en.wikipedia.org/wiki/Micrometre>
- miles: Miles <https://en.wikipedia.org/wiki/Mile>
- millimetres: Millimetres <https://en.wikipedia.org/wiki/Millimetre>
- nanometres: Nanometres <https://en.wikipedia.org/wiki/Nanometre>
- yards: Yards <https://en.wikipedia.org/wiki/Yard>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/length/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/length/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.136Z",
  "created_at": "2023-06-02T19:34:53.136Z",
  "error": "pmg2Y6c0waYiVIXCzYJE",
  "id": "cc158b9a-0033-40a8-aa1e-66245a3b0f51",
  "input": 23,
  "input_unit": "nanometres",
  "output": 26,
  "output_unit": "micrometres",
  "started_at": "2023-06-02T19:34:53.136Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.136Z",
  "user_id": "hMANh8CzqFyWYHCyU6"
}

Convert mass units

Parameters

input_unitstringrequired
Possible values
15 possible values
- carats: Carats <https://en.wikipedia.org/wiki/Carat_(mass)>
- grains: Grains <https://en.wikipedia.org/wiki/Grain_(unit)>
- grams: Grams <https://en.wikipedia.org/wiki/Gram>
- kilograms: Kilograms <https://en.wikipedia.org/wiki/Kilogram>
- long_tons: Long tons <https://en.wikipedia.org/wiki/Long_ton>
- metric_tons: Metric tons <https://en.wikipedia.org/wiki/Tonne>
- micrograms: Micrograms <https://en.wikipedia.org/wiki/Microgram>
- milligrams: Milligrams <https://en.wikipedia.org/wiki/Milligram>
- ounces: Ounces <https://en.wikipedia.org/wiki/Ounce>
- pennyweights: Pennyweights <https://en.wikipedia.org/wiki/Pennyweight>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
- short_tons: Short tons <https://en.wikipedia.org/wiki/Short_ton>
- stones: Stones <https://en.wikipedia.org/wiki/Stone_(unit)>
- troy_ounces: Troy ounces <https://en.wikipedia.org/wiki/Troy_ounce>
- troy_pounds: Troy pounds <https://en.wikipedia.org/wiki/Troy_pound>
output_unitstringrequired
Possible values
15 possible values
- carats: Carats <https://en.wikipedia.org/wiki/Carat_(mass)>
- grains: Grains <https://en.wikipedia.org/wiki/Grain_(unit)>
- grams: Grams <https://en.wikipedia.org/wiki/Gram>
- kilograms: Kilograms <https://en.wikipedia.org/wiki/Kilogram>
- long_tons: Long tons <https://en.wikipedia.org/wiki/Long_ton>
- metric_tons: Metric tons <https://en.wikipedia.org/wiki/Tonne>
- micrograms: Micrograms <https://en.wikipedia.org/wiki/Microgram>
- milligrams: Milligrams <https://en.wikipedia.org/wiki/Milligram>
- ounces: Ounces <https://en.wikipedia.org/wiki/Ounce>
- pennyweights: Pennyweights <https://en.wikipedia.org/wiki/Pennyweight>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
- short_tons: Short tons <https://en.wikipedia.org/wiki/Short_ton>
- stones: Stones <https://en.wikipedia.org/wiki/Stone_(unit)>
- troy_ounces: Troy ounces <https://en.wikipedia.org/wiki/Troy_ounce>
- troy_pounds: Troy pounds <https://en.wikipedia.org/wiki/Troy_pound>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
15 possible values
- carats: Carats <https://en.wikipedia.org/wiki/Carat_(mass)>
- grains: Grains <https://en.wikipedia.org/wiki/Grain_(unit)>
- grams: Grams <https://en.wikipedia.org/wiki/Gram>
- kilograms: Kilograms <https://en.wikipedia.org/wiki/Kilogram>
- long_tons: Long tons <https://en.wikipedia.org/wiki/Long_ton>
- metric_tons: Metric tons <https://en.wikipedia.org/wiki/Tonne>
- micrograms: Micrograms <https://en.wikipedia.org/wiki/Microgram>
- milligrams: Milligrams <https://en.wikipedia.org/wiki/Milligram>
- ounces: Ounces <https://en.wikipedia.org/wiki/Ounce>
- pennyweights: Pennyweights <https://en.wikipedia.org/wiki/Pennyweight>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
- short_tons: Short tons <https://en.wikipedia.org/wiki/Short_ton>
- stones: Stones <https://en.wikipedia.org/wiki/Stone_(unit)>
- troy_ounces: Troy ounces <https://en.wikipedia.org/wiki/Troy_ounce>
- troy_pounds: Troy pounds <https://en.wikipedia.org/wiki/Troy_pound>
outputnumberoptional
output_unitstringoptional
Possible values
15 possible values
- carats: Carats <https://en.wikipedia.org/wiki/Carat_(mass)>
- grains: Grains <https://en.wikipedia.org/wiki/Grain_(unit)>
- grams: Grams <https://en.wikipedia.org/wiki/Gram>
- kilograms: Kilograms <https://en.wikipedia.org/wiki/Kilogram>
- long_tons: Long tons <https://en.wikipedia.org/wiki/Long_ton>
- metric_tons: Metric tons <https://en.wikipedia.org/wiki/Tonne>
- micrograms: Micrograms <https://en.wikipedia.org/wiki/Microgram>
- milligrams: Milligrams <https://en.wikipedia.org/wiki/Milligram>
- ounces: Ounces <https://en.wikipedia.org/wiki/Ounce>
- pennyweights: Pennyweights <https://en.wikipedia.org/wiki/Pennyweight>
- pounds: Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
- short_tons: Short tons <https://en.wikipedia.org/wiki/Short_ton>
- stones: Stones <https://en.wikipedia.org/wiki/Stone_(unit)>
- troy_ounces: Troy ounces <https://en.wikipedia.org/wiki/Troy_ounce>
- troy_pounds: Troy pounds <https://en.wikipedia.org/wiki/Troy_pound>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/mass/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/mass/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.142Z",
  "created_at": "2023-06-02T19:34:53.142Z",
  "error": "znPKDK",
  "id": "be636a34-750d-4119-8673-7351d7846a35",
  "input": 25,
  "input_unit": "milligrams",
  "output": 16,
  "output_unit": "grains",
  "started_at": "2023-06-02T19:34:53.142Z",
  "status": "Completed",
  "updated_at": "2023-06-02T19:34:53.142Z",
  "user_id": "kXZ8yAWafwrHnT"
}

Convert power units

Parameters

input_unitstringrequired
Possible values
- btu_per_minute: British thermal units (BTU) per minute <https://en.wikipedia.org/wiki/British_thermal_unit>
- horsepower: Horsepower (hp) <https://en.wikipedia.org/wiki/Horsepower>
- kilowatts: Kilowatts <https://en.wikipedia.org/wiki/Kilowatt>
- metric_horsepower: Metric horsepower (PS) <https://en.wikipedia.org/wiki/Horsepower#Metric_horsepower>
- microwatts: Microwatts <https://en.wikipedia.org/wiki/Microwatt>
- milliwatts: Millwatts <https://en.wikipedia.org/wiki/Milliwatt>
- watts: Watts <https://en.wikipedia.org/wiki/Watt>
output_unitstringrequired
Possible values
- btu_per_minute: British thermal units (BTU) per minute <https://en.wikipedia.org/wiki/British_thermal_unit>
- horsepower: Horsepower (hp) <https://en.wikipedia.org/wiki/Horsepower>
- kilowatts: Kilowatts <https://en.wikipedia.org/wiki/Kilowatt>
- metric_horsepower: Metric horsepower (PS) <https://en.wikipedia.org/wiki/Horsepower#Metric_horsepower>
- microwatts: Microwatts <https://en.wikipedia.org/wiki/Microwatt>
- milliwatts: Millwatts <https://en.wikipedia.org/wiki/Milliwatt>
- watts: Watts <https://en.wikipedia.org/wiki/Watt>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- btu_per_minute: British thermal units (BTU) per minute <https://en.wikipedia.org/wiki/British_thermal_unit>
- horsepower: Horsepower (hp) <https://en.wikipedia.org/wiki/Horsepower>
- kilowatts: Kilowatts <https://en.wikipedia.org/wiki/Kilowatt>
- metric_horsepower: Metric horsepower (PS) <https://en.wikipedia.org/wiki/Horsepower#Metric_horsepower>
- microwatts: Microwatts <https://en.wikipedia.org/wiki/Microwatt>
- milliwatts: Millwatts <https://en.wikipedia.org/wiki/Milliwatt>
- watts: Watts <https://en.wikipedia.org/wiki/Watt>
outputnumberoptional
output_unitstringoptional
Possible values
- btu_per_minute: British thermal units (BTU) per minute <https://en.wikipedia.org/wiki/British_thermal_unit>
- horsepower: Horsepower (hp) <https://en.wikipedia.org/wiki/Horsepower>
- kilowatts: Kilowatts <https://en.wikipedia.org/wiki/Kilowatt>
- metric_horsepower: Metric horsepower (PS) <https://en.wikipedia.org/wiki/Horsepower#Metric_horsepower>
- microwatts: Microwatts <https://en.wikipedia.org/wiki/Microwatt>
- milliwatts: Millwatts <https://en.wikipedia.org/wiki/Milliwatt>
- watts: Watts <https://en.wikipedia.org/wiki/Watt>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/power/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/power/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.148Z",
  "created_at": "2023-06-02T19:34:53.148Z",
  "error": "e6RiqNLqMr4AP0DjQTH",
  "id": "70017cbe-60ce-40ec-aef9-7da862285e5f",
  "input": 28,
  "input_unit": "milliwatts",
  "output": 9,
  "output_unit": "metric_horsepower",
  "started_at": "2023-06-02T19:34:53.148Z",
  "status": "Queued",
  "updated_at": "2023-06-02T19:34:53.148Z",
  "user_id": "ArqJh70LeWHsU"
}

Convert pressure units

Parameters

input_unitstringrequired
Possible values
- atmospheres: Atmospheres <https://en.wikipedia.org/wiki/Standard_atmosphere_(unit)>
- bars: Bars <https://en.wikipedia.org/wiki/Bar_(unit)>
- hectopascals: Hectopascals <https://en.wikipedia.org/wiki/Hectopascal>
- kilopascals: Kilopascals <https://en.wikipedia.org/wiki/Kilopascal>
- millibars: Millibars <https://en.wikipedia.org/wiki/Bar_(unit)>
- pascals: Pascals <https://en.wikipedia.org/wiki/Pascal_(unit)>
- psi: Pounds per square inch (PSI) - <https://en.wikipedia.org/wiki/Pound_per_square_inch>
output_unitstringrequired
Possible values
- atmospheres: Atmospheres <https://en.wikipedia.org/wiki/Standard_atmosphere_(unit)>
- bars: Bars <https://en.wikipedia.org/wiki/Bar_(unit)>
- hectopascals: Hectopascals <https://en.wikipedia.org/wiki/Hectopascal>
- kilopascals: Kilopascals <https://en.wikipedia.org/wiki/Kilopascal>
- millibars: Millibars <https://en.wikipedia.org/wiki/Bar_(unit)>
- pascals: Pascals <https://en.wikipedia.org/wiki/Pascal_(unit)>
- psi: Pounds per square inch (PSI) - <https://en.wikipedia.org/wiki/Pound_per_square_inch>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- atmospheres: Atmospheres <https://en.wikipedia.org/wiki/Standard_atmosphere_(unit)>
- bars: Bars <https://en.wikipedia.org/wiki/Bar_(unit)>
- hectopascals: Hectopascals <https://en.wikipedia.org/wiki/Hectopascal>
- kilopascals: Kilopascals <https://en.wikipedia.org/wiki/Kilopascal>
- millibars: Millibars <https://en.wikipedia.org/wiki/Bar_(unit)>
- pascals: Pascals <https://en.wikipedia.org/wiki/Pascal_(unit)>
- psi: Pounds per square inch (PSI) - <https://en.wikipedia.org/wiki/Pound_per_square_inch>
outputnumberoptional
output_unitstringoptional
Possible values
- atmospheres: Atmospheres <https://en.wikipedia.org/wiki/Standard_atmosphere_(unit)>
- bars: Bars <https://en.wikipedia.org/wiki/Bar_(unit)>
- hectopascals: Hectopascals <https://en.wikipedia.org/wiki/Hectopascal>
- kilopascals: Kilopascals <https://en.wikipedia.org/wiki/Kilopascal>
- millibars: Millibars <https://en.wikipedia.org/wiki/Bar_(unit)>
- pascals: Pascals <https://en.wikipedia.org/wiki/Pascal_(unit)>
- psi: Pounds per square inch (PSI) - <https://en.wikipedia.org/wiki/Pound_per_square_inch>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/pressure/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/pressure/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.157Z",
  "created_at": "2023-06-02T19:34:53.157Z",
  "error": "R0TkigOD4aZCjiIY",
  "id": "da177081-57ed-4d5b-a694-ba6f50bd8f21",
  "input": 10,
  "input_unit": "kilopascals",
  "output": 4,
  "output_unit": "hectopascals",
  "started_at": "2023-06-02T19:34:53.157Z",
  "status": "Failed",
  "updated_at": "2023-06-02T19:34:53.157Z",
  "user_id": "Sygq0at1hp5bJ"
}

Convert temperature units

Parameters

input_unitstringrequired
Possible values
- celsius: Celsius <https://en.wikipedia.org/wiki/Celsius>
- fahrenheit: Fahrenheit <https://en.wikipedia.org/wiki/Fahrenheit>
- kelvin: Kelvin <https://en.wikipedia.org/wiki/Kelvin>
- rankine: Rankine <https://en.wikipedia.org/wiki/Rankine_scale>
output_unitstringrequired
Possible values
- celsius: Celsius <https://en.wikipedia.org/wiki/Celsius>
- fahrenheit: Fahrenheit <https://en.wikipedia.org/wiki/Fahrenheit>
- kelvin: Kelvin <https://en.wikipedia.org/wiki/Kelvin>
- rankine: Rankine <https://en.wikipedia.org/wiki/Rankine_scale>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- celsius: Celsius <https://en.wikipedia.org/wiki/Celsius>
- fahrenheit: Fahrenheit <https://en.wikipedia.org/wiki/Fahrenheit>
- kelvin: Kelvin <https://en.wikipedia.org/wiki/Kelvin>
- rankine: Rankine <https://en.wikipedia.org/wiki/Rankine_scale>
outputnumberoptional
output_unitstringoptional
Possible values
- celsius: Celsius <https://en.wikipedia.org/wiki/Celsius>
- fahrenheit: Fahrenheit <https://en.wikipedia.org/wiki/Fahrenheit>
- kelvin: Kelvin <https://en.wikipedia.org/wiki/Kelvin>
- rankine: Rankine <https://en.wikipedia.org/wiki/Rankine_scale>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional
user_idstringoptional

GET/unit/conversion/temperature/{input_unit}/{output_unit}

$ curl "https://api.kittycad.io/unit/conversion/temperature/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"

200 OK

Response

{
  "completed_at": "2023-06-02T19:34:53.162Z",
  "created_at": "2023-06-02T19:34:53.162Z",
  "error": "d6mf53t",
  "id": "158165cb-22a4-46f2-8412-fcea71ad2d5a",
  "input": 30,
  "input_unit": "rankine",
  "output": 17,
  "output_unit": "kelvin",
  "started_at": "2023-06-02T19:34:53.162Z",
  "status": "Queued",
  "updated_at": "2023-06-02T19:34:53.162Z",
  "user_id": "Rct5r2roc4"
}

Convert torque units

Parameters

input_unitstringrequired
Possible values
- newton_metres: Newton metres <https://en.wikipedia.org/wiki/Newton_metre>
- pound_foot: Pound foot <https://en.wikipedia.org/wiki/Pound-foot_(torque)>
output_unitstringrequired
Possible values
- newton_metres: Newton metres <https://en.wikipedia.org/wiki/Newton_metre>
- pound_foot: Pound foot <https://en.wikipedia.org/wiki/Pound-foot_(torque)>
valuenumberrequired

Returns

200 OK

successful operation

completed_atstringISO-8601optional
created_atstringISO-8601optional
errorstringoptional
idstringUUIDoptional
inputnumberoptional
input_unitstringoptional
Possible values
- newton_metres: Newton metres <https://en.wikipedia.org/wiki/Newton_metre>
- pound_foot: Pound foot <https://en.wikipedia.org/wiki/Pound-foot_(torque)>
outputnumberoptional
output_unitstringoptional
Possible values
- newton_metres: Newton metres <https://en.wikipedia.org/wiki/Newton_metre>
- pound_foot: Pound foot <https://en.wikipedia.org/wiki/Pound-foot_(torque)>
started_atstringISO-8601optional
statusstringoptional
Possible values
- Queued: The async API call is queued.
- Uploaded: The async API call was uploaded to be converted.
- In Progress: The async API call is in progress.
- Completed: The async API call has completed.
- Failed: The async API call has failed.
updated_atstringISO-8601optional

API Reference

Client libraries

Authentication

Errors

API Calls

Get an async operation

Parameters

Returns

200 OK

List API calls for your user

Parameters

Possible values

Returns

200 OK

Array of

Possible values

Get an API call for a user

Parameters

Returns

200 OK

Possible values

API Tokens

List API tokens for your user

Parameters

Possible values

Returns

200 OK

Array of

Create a new API token for your user

Parameters

Returns

201 Created

Delete an API token for your user

Parameters

Returns

204 No Content

Get an API token for your user

Parameters

Returns

200 OK

File

Convert CAD file

Parameters

Possible values

Possible values

Returns

201 Created

Possible values

Possible values

Possible values

Get CAD file density beta

Parameters

Possible values

Returns

201 Created

Possible values

Possible values

Get CAD file mass beta

Parameters

Possible values

Returns

201 Created

Possible values

Possible values

Meta

Get OpenAPI schema

Parameters

Returns

200 OK

Return pong

Parameters

Returns

200 OK

Payments

Delete payment info for your user

Parameters

Returns

204 No Content

Get payment info about your user

Parameters

Get CAD file density
beta

Get CAD file mass
beta