Compare

Compare parts

Put parts side by side on the specifications that matter for this kind of part, read from each part’s datasheet. To compare parts you name with each other, send them all in parts, the first being the reference. Send mpn alone only to compare one part with its alternates. Every other part gets one verdict per specification against the reference (same, covers, narrower, higher, lower, different, not_stated) and a count of the specifications that are the same or covered, plus its stock and lead time at distributors. Answers 202 at once; read GET /v1/compare/{id} after 10 seconds, then every 9 seconds, until status is no longer processing: complete with the parts, or failed. Each answer while it runs states the wait in summary and Retry-After. A part that is not one specific part is refused with 422, a part no distributor lists with 404; the refusal names the part and nothing is started.

POST

compare

Compare parts

curl --request POST \
  --url https://api.partfinder.dev/v1/compare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "parts": [
    {
      "mpn": "TPS54331DR"
    },
    {
      "mpn": "TPS5430DDAR"
    }
  ]
}
'

import requests

url = "https://api.partfinder.dev/v1/compare"

payload = { "parts": [{ "mpn": "TPS54331DR" }, { "mpn": "TPS5430DDAR" }] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({parts: [{mpn: 'TPS54331DR'}, {mpn: 'TPS5430DDAR'}]})
};

fetch('https://api.partfinder.dev/v1/compare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.partfinder.dev/v1/compare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'parts' => [
        [
                'mpn' => 'TPS54331DR'
        ],
        [
                'mpn' => 'TPS5430DDAR'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.partfinder.dev/v1/compare"

	payload := strings.NewReader("{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.partfinder.dev/v1/compare")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.partfinder.dev/v1/compare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "as_of": "2026-10-12T02:48:51.650Z",
  "summary": "Comparing TPS54331DR. Poll GET /v1/compare/f2d22c25-e694-428b-bbb8-3948e60d3c7b after 10 seconds, then every 9 seconds, until `status` is no longer `processing`.",
  "notice": "Informational only. Risk scores, stock levels, lead times and alternate-part suggestions may be incomplete, delayed or inaccurate. Independently verify before making procurement, engineering, compliance, safety or sourcing decisions.",
  "id": "f2d22c25-e694-428b-bbb8-3948e60d3c7b",
  "status": "processing"
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "credits_exhausted",
  "summary": "Your organization's credits for this month are used up, so this request was not run. Upgrade your plan in the PartFinder console at https://console.partfinder.dev/settings/billing, then try again.",
  "reason": "This request needs 8 credits and 0 are left.",
  "billing_url": "https://console.partfinder.dev/settings/billing"
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

An API key created in the PartFinder console at https://console.partfinder.dev, or a customer key created with POST /v1/keys. Send as Authorization: Bearer <key>. Revocation takes effect within approximately one minute.

Headers

Idempotency-Key

string

Set by your client code, not by a person or a model: generate a new value (a UUID) for each comparison, and send the same value again only when retrying that same comparison after a timeout. A retry with the same key returns the comparison the first call started and starts no second one. A key is recognised only from the same API key that sent it. Optional.

Body

application/json

parts

object[]

Your own list: 2 to 6 parts, compared as given. The first is the reference the others are compared with. Send this or mpn, not both.

Required array length: 2 - 6 elements

Show child attributes

mpn

string

One part, compared with its alternates (the list GET /v1/alternates returns). If the part has no alternates, the comparison still completes, with this part alone and no columns. To compare parts you name with each other, send them all in parts instead. Send this or parts, not both.

Minimum string length: 1

manufacturer

string

The maker of mpn. Only needed when several companies make a part with this number.

Minimum string length: 1

Response

Accepted. The comparison has started; a retry with an Idempotency-Key already used returns the comparison that key started, with its current status.

as_of

string<date-time>

required

ISO 8601. How current the data in this response is.

summary

string

required

Plain language an agent can relay without re-deriving it.

notice

string

required

Informational-use notice. Always present.

string<uuid>

required

Poll GET /v1/compare/{id} with it.

status

enum<string>

required

processing for a new comparison. A retry with an Idempotency-Key already used returns the comparison that key started, with its current status.

Available options:

processing,

complete,

failed

Compare parts

curl --request POST \
  --url https://api.partfinder.dev/v1/compare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "parts": [
    {
      "mpn": "TPS54331DR"
    },
    {
      "mpn": "TPS5430DDAR"
    }
  ]
}
'

import requests

url = "https://api.partfinder.dev/v1/compare"

payload = { "parts": [{ "mpn": "TPS54331DR" }, { "mpn": "TPS5430DDAR" }] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({parts: [{mpn: 'TPS54331DR'}, {mpn: 'TPS5430DDAR'}]})
};

fetch('https://api.partfinder.dev/v1/compare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.partfinder.dev/v1/compare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'parts' => [
        [
                'mpn' => 'TPS54331DR'
        ],
        [
                'mpn' => 'TPS5430DDAR'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.partfinder.dev/v1/compare"

	payload := strings.NewReader("{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.partfinder.dev/v1/compare")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.partfinder.dev/v1/compare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\"\n    },\n    {\n      \"mpn\": \"TPS5430DDAR\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "as_of": "2026-10-12T02:48:51.650Z",
  "summary": "Comparing TPS54331DR. Poll GET /v1/compare/f2d22c25-e694-428b-bbb8-3948e60d3c7b after 10 seconds, then every 9 seconds, until `status` is no longer `processing`.",
  "notice": "Informational only. Risk scores, stock levels, lead times and alternate-part suggestions may be incomplete, delayed or inaccurate. Independently verify before making procurement, engineering, compliance, safety or sourcing decisions.",
  "id": "f2d22c25-e694-428b-bbb8-3948e60d3c7b",
  "status": "processing"
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "credits_exhausted",
  "summary": "Your organization's credits for this month are used up, so this request was not run. Upgrade your plan in the PartFinder console at https://console.partfinder.dev/settings/billing, then try again.",
  "reason": "This request needs 8 credits and 0 are left.",
  "billing_url": "https://console.partfinder.dev/settings/billing"
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

Overview

Endpoints

Compare parts

Authorizations

Headers

Body

Response