Skip to content
Public API
Esc
↑↓navigate↵open⌘Jpreview

Find similar parts

Finds previously ordered parts geometrically similar to the part, using the same embeddings-based search as the console Similarity widget. The part needs a similarity embedding (generated automatically when the part is created or quoted). minSimilarity is a percentage (0-100); similarity values in the response are fractions (0-1). Only the first 5 parts carry a thumbnailUrl.

POST/ticket-model/{id}/similarity
Authorization
AuthorizationAPI key · headerrequired

The Incoming Secret value (<secretId>.<random>), with or without a Bearer prefix.

Path parameters
idstringrequired
Request body
application/json
minSimilaritynumber

Minimum similarity to include, in percent (0-100). Default 80.

materialIdinteger

Only return parts with this material. Must be an existing material id.

limitinteger

Maximum number of matches to return, 1-100. Default 20.

Responses
200

Created.

countinteger

Total number of matches.

avgPricenumber

Average unit price across the matches.

avgProcessingTimenumber

Average processing time across the matches.

avgSimilaritynumber

Average similarity across the matches, as a fraction (0-1).

partsobject[]
Show properties
Array of object
idinteger

Id of the similar part.

customIdstring

Custom part id.

ticketIdinteger

Id of the ticket the similar part belongs to.

modelIdinteger

Id of the part model.

pricenumber

Unit price with discount.

currencySymbolstring

Currency symbol.

currencyPositionstring

Currency symbol position.

thumbnailUrlstring

Signed thumbnail URL; null past the first 5 parts.

finalModelNamestring

File name of the final model.

materialNamestring

Material name.

technologyNamestring

Technology name.

serviceListNamesstring[]

Names of the post-processing services on the part.

processingTimenumber

Total processing time of the part services.

similaritynumber

Similarity as a fraction (0-1).

401

Authentication failed. All causes return this identical response.

codeinteger
messagestring
typestring
default

Downstream errors pass through verbatim; x-error-source names the failing service.

codeinteger
messagestring
typestring
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST 'https://next.amfg.ai/engine-service/public-api/v1/ticket-model/string/similarity' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "minSimilarity": 70,
  "limit": 10
}'
Response
{
  "count": 1,
  "avgPrice": 1264.17,
  "avgProcessingTime": 48,
  "avgSimilarity": 0.974,
  "parts": [
    {
      "id": 4846,
      "customId": "X-88-ORDER-95307-2",
      "ticketId": 1726,
      "modelId": 3119,
      "price": 1264.17,
      "currencySymbol": "$",
      "currencyPosition": "before",
      "thumbnailUrl": "https://...",
      "finalModelName": "bracket.stl",
      "materialName": "PA12",
      "technologyName": "SLS",
      "serviceListNames": [
        "Polishing"
      ],
      "processingTime": 48,
      "similarity": 0.974
    }
  ]
}