RFQs

Send a request for quote

Email a request for quote to a supplier you name, under the requester’s name. This sends a real email to supplier.email: every address and name in the request must come from your user, never be guessed or suggested; ask your user for any that are missing. Only these are required: the supplier’s email, the requester’s name, and the requester’s company when it is neither your organization nor, with a key made with POST /v1/keys, that customer. Everything else is optional: leave out what they did not give. Send message only with text your user wrote; omit it and an email is written for you. The supplier replies to the email as usual, and their replies appear on GET /v1/rfq/{id}. A supplier who asked not to receive requests for quote is refused with 409.

POST

rfq

curl --request POST \
  --url https://api.partfinder.dev/v1/rfq \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "supplier": {
    "email": "sales@supplier.example",
    "name": "Example Supplier",
    "contact_name": "Tom Lee"
  },
  "requester": {
    "company": "Acme Corp",
    "contact_name": "Jane Smith",
    "title": "Procurement Manager"
  },
  "parts": [
    {
      "mpn": "TPS54331DR",
      "manufacturer": "Texas Instruments",
      "quantity": 500
    }
  ],
  "needed_by": "2026-11-30"
}
'

import requests

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

payload = {
    "supplier": {
        "email": "sales@supplier.example",
        "name": "Example Supplier",
        "contact_name": "Tom Lee"
    },
    "requester": {
        "company": "Acme Corp",
        "contact_name": "Jane Smith",
        "title": "Procurement Manager"
    },
    "parts": [
        {
            "mpn": "TPS54331DR",
            "manufacturer": "Texas Instruments",
            "quantity": 500
        }
    ],
    "needed_by": "2026-11-30"
}
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({
    supplier: {
      email: 'sales@supplier.example',
      name: 'Example Supplier',
      contact_name: 'Tom Lee'
    },
    requester: {company: 'Acme Corp', contact_name: 'Jane Smith', title: 'Procurement Manager'},
    parts: [{mpn: 'TPS54331DR', manufacturer: 'Texas Instruments', quantity: 500}],
    needed_by: '2026-11-30'
  })
};

fetch('https://api.partfinder.dev/v1/rfq', 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/rfq",
  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([
    'supplier' => [
        'email' => 'sales@supplier.example',
        'name' => 'Example Supplier',
        'contact_name' => 'Tom Lee'
    ],
    'requester' => [
        'company' => 'Acme Corp',
        'contact_name' => 'Jane Smith',
        'title' => 'Procurement Manager'
    ],
    'parts' => [
        [
                'mpn' => 'TPS54331DR',
                'manufacturer' => 'Texas Instruments',
                'quantity' => 500
        ]
    ],
    'needed_by' => '2026-11-30'
  ]),
  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/rfq"

	payload := strings.NewReader("{\n  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\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/rfq")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\n}"

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

{
  "as_of": "2026-10-05T16:02:11.482Z",
  "summary": "Request for quote sent to sales@supplier.example. Replies appear on GET /v1/rfq/5b0f3c1e-8a2d-4f6b-9c7e-1d2a3b4c5d6e.",
  "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.",
  "rfq": {
    "id": "5b0f3c1e-8a2d-4f6b-9c7e-1d2a3b4c5d6e",
    "status": "sent",
    "supplier": {
      "email": "sales@supplier.example",
      "name": "Example Supplier",
      "contact_name": "Tom Lee"
    },
    "requester": {
      "company": "Acme Corp",
      "contact_name": "Jane Smith",
      "title": "Procurement Manager"
    },
    "parts": [
      {
        "mpn": "TPS54331DR",
        "manufacturer": "Texas Instruments",
        "quantity": 500
      }
    ],
    "needed_by": "2026-11-30",
    "notify_email": null,
    "created_at": "2026-10-05T16:02:09.913Z",
    "first_reply_at": null,
    "follow_up_count": 0,
    "replies_received": 0,
    "quotes_received": 0,
    "messages": [
      {
        "id": "9e4d2c7a-1b3f-4a5e-8d6c-0f1e2d3c4b5a",
        "direction": "outbound",
        "subject": "Request for quote: TPS54331DR, 500 units, needed by 30 November 2026",
        "body": "Hi Tom,\n\nMy name is Jane Smith, Procurement Manager at Acme Corp. We're looking for 500 units of the Texas Instruments TPS54331DR and need them delivered by 30 November 2026. Could you send your best unit price, availability and lead time, along with any minimum order quantity and how long the quote is valid?\n\nThank you,\n\nJane Smith\nAcme Corp",
        "sent_at": "2026-10-05T16:02:11.307Z",
        "attachments": [],
        "reply_kind": null,
        "quote": null
      }
    ]
  }
}

{
  "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 1 credit 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>"
  ]
}

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 request for quote, and send the same value again only when retrying that same request after a timeout. A retry with the same key returns the request the first call created and sends no second email. A key is recognised only from the same API key that sent it. Optional.

Body

application/json

supplier

object

required

Show child attributes

requester

object

required

Who the request is from.

Show child attributes

parts

object[]

required

The parts and quantities to quote.

Minimum array length: 1

Show child attributes

needed_by

string<date> | null

The date you need the parts delivered by, YYYY-MM-DD. Stated in the email so the supplier can say whether they can meet it.

message

object | null

Email text your user wrote, sent as written. Omit it unless your user gave the text; an email is then written for you.

Show child attributes

notify_email

string<email> | null

Who is emailed when the supplier replies. Required with a key you created for one of your customers (POST /v1/keys): only this address is told, never your organization. Optional with your organization's own keys.

Response

Sent. The body is the request for quote with its first message.

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.

rfq

object

required

Show child attributes

Send a request for quote

curl --request POST \
  --url https://api.partfinder.dev/v1/rfq \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "supplier": {
    "email": "sales@supplier.example",
    "name": "Example Supplier",
    "contact_name": "Tom Lee"
  },
  "requester": {
    "company": "Acme Corp",
    "contact_name": "Jane Smith",
    "title": "Procurement Manager"
  },
  "parts": [
    {
      "mpn": "TPS54331DR",
      "manufacturer": "Texas Instruments",
      "quantity": 500
    }
  ],
  "needed_by": "2026-11-30"
}
'

import requests

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

payload = {
    "supplier": {
        "email": "sales@supplier.example",
        "name": "Example Supplier",
        "contact_name": "Tom Lee"
    },
    "requester": {
        "company": "Acme Corp",
        "contact_name": "Jane Smith",
        "title": "Procurement Manager"
    },
    "parts": [
        {
            "mpn": "TPS54331DR",
            "manufacturer": "Texas Instruments",
            "quantity": 500
        }
    ],
    "needed_by": "2026-11-30"
}
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({
    supplier: {
      email: 'sales@supplier.example',
      name: 'Example Supplier',
      contact_name: 'Tom Lee'
    },
    requester: {company: 'Acme Corp', contact_name: 'Jane Smith', title: 'Procurement Manager'},
    parts: [{mpn: 'TPS54331DR', manufacturer: 'Texas Instruments', quantity: 500}],
    needed_by: '2026-11-30'
  })
};

fetch('https://api.partfinder.dev/v1/rfq', 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/rfq",
  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([
    'supplier' => [
        'email' => 'sales@supplier.example',
        'name' => 'Example Supplier',
        'contact_name' => 'Tom Lee'
    ],
    'requester' => [
        'company' => 'Acme Corp',
        'contact_name' => 'Jane Smith',
        'title' => 'Procurement Manager'
    ],
    'parts' => [
        [
                'mpn' => 'TPS54331DR',
                'manufacturer' => 'Texas Instruments',
                'quantity' => 500
        ]
    ],
    'needed_by' => '2026-11-30'
  ]),
  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/rfq"

	payload := strings.NewReader("{\n  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\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/rfq")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"supplier\": {\n    \"email\": \"sales@supplier.example\",\n    \"name\": \"Example Supplier\",\n    \"contact_name\": \"Tom Lee\"\n  },\n  \"requester\": {\n    \"company\": \"Acme Corp\",\n    \"contact_name\": \"Jane Smith\",\n    \"title\": \"Procurement Manager\"\n  },\n  \"parts\": [\n    {\n      \"mpn\": \"TPS54331DR\",\n      \"manufacturer\": \"Texas Instruments\",\n      \"quantity\": 500\n    }\n  ],\n  \"needed_by\": \"2026-11-30\"\n}"

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

{
  "as_of": "2026-10-05T16:02:11.482Z",
  "summary": "Request for quote sent to sales@supplier.example. Replies appear on GET /v1/rfq/5b0f3c1e-8a2d-4f6b-9c7e-1d2a3b4c5d6e.",
  "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.",
  "rfq": {
    "id": "5b0f3c1e-8a2d-4f6b-9c7e-1d2a3b4c5d6e",
    "status": "sent",
    "supplier": {
      "email": "sales@supplier.example",
      "name": "Example Supplier",
      "contact_name": "Tom Lee"
    },
    "requester": {
      "company": "Acme Corp",
      "contact_name": "Jane Smith",
      "title": "Procurement Manager"
    },
    "parts": [
      {
        "mpn": "TPS54331DR",
        "manufacturer": "Texas Instruments",
        "quantity": 500
      }
    ],
    "needed_by": "2026-11-30",
    "notify_email": null,
    "created_at": "2026-10-05T16:02:09.913Z",
    "first_reply_at": null,
    "follow_up_count": 0,
    "replies_received": 0,
    "quotes_received": 0,
    "messages": [
      {
        "id": "9e4d2c7a-1b3f-4a5e-8d6c-0f1e2d3c4b5a",
        "direction": "outbound",
        "subject": "Request for quote: TPS54331DR, 500 units, needed by 30 November 2026",
        "body": "Hi Tom,\n\nMy name is Jane Smith, Procurement Manager at Acme Corp. We're looking for 500 units of the Texas Instruments TPS54331DR and need them delivered by 30 November 2026. Could you send your best unit price, availability and lead time, along with any minimum order quantity and how long the quote is valid?\n\nThank you,\n\nJane Smith\nAcme Corp",
        "sent_at": "2026-10-05T16:02:11.307Z",
        "attachments": [],
        "reply_kind": null,
        "quote": null
      }
    ]
  }
}

{
  "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 1 credit 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>"
  ]
}

Overview

Endpoints

Send a request for quote

Authorizations

Headers

Body

Response