Fairmarkit RFQ API
The RFQ API from Fairmarkit — 11 operation(s) for rfq.
The RFQ API from Fairmarkit — 11 operation(s) for rfq.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fairmarkit-rfq-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: BUYER PUBLIC RFQ API
version: '3'
description: The Fairmarkit Buyer API is a RESTful API that uses HTTP requests to allow you to access and use your Fairmarkit data. It has predictable resource-oriented URLs that use standard HTTP response codes, authentication, and verbs. See the Fairmarkit API developer portal for more information.
termsOfService: https://www.fairmarkit.com/terms-of-service
contact:
name: Fairmarkit Support
url: https://fmkt.zendesk.com/hc/en-us
email: support@fairmarkit.com
servers:
- url: https://staging.fairmarkit.com/
tags:
- name: RFQ
paths:
/services/self-service/api/v3/rfq/{uuid}/internal-notes/:
post:
tags:
- RFQ
summary: Add Internal Note
operationId: add_internal_note_services_self_service_api_v3_rfq__uuid__internal_notes__post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQInternalNote'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/InternalNote'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Creates a new internal note for an RFQ event.
get:
tags:
- RFQ
summary: List Internal Notes
operationId: get_internal_notes_services_self_service_api_v3_rfq__uuid__internal_notes__get
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 20
description: Maximum number of records to return. Defaults to 20.
name: limit
in: query
description: Maximum number of records to return. Defaults to 20.
- required: false
schema:
title: Offset
minimum: 0
type: integer
default: 0
description: Zero-based offset of the first record to return. Defaults to 0.
name: offset
in: query
description: Zero-based offset of the first record to return. Defaults to 0.
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ListRetrieve_InternalNote_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns a list of internal notes for an RFQ event.
/services/self-service/api/v3/rfq/{uuid}/:
delete:
tags:
- RFQ
summary: Delete RFQ Event
operationId: soft_delete_services_self_service_api_v3_rfq__uuid___delete
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Deletes an existing RFQ event.
put:
tags:
- RFQ
summary: Update RFQ Event
operationId: update_services_self_service_api_v3_rfq__uuid___put
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQUpdate'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFQRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Updates an existing RFQ event.
get:
tags:
- RFQ
summary: Get RFQ Event Details
operationId: retrieve_services_self_service_api_v3_rfq__uuid___get
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFQRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns details for an RFQ event.
/services/self-service/api/v3/rfq/:
get:
tags:
- RFQ
summary: List RFQ Events
operationId: get_rfq_list_services_self_service_api_v3_rfq__get
parameters:
- description: Start of the created-at time range. Use ISO 8601 format.
required: false
schema:
type: string
format: date-time
title: Updated At Min
description: Start of the created-at time range. Use ISO 8601 format.
name: created_at_min
in: query
- description: End of the created-at time range. Use ISO 8601 format.
required: false
schema:
type: string
format: date-time
title: Updated At Max
description: End of the created-at time range. Use ISO 8601 format.
name: created_at_max
in: query
- description: Start of the updated-at time range. Use ISO 8601 format.
required: false
schema:
type: string
format: date-time
title: Updated At Min
description: Start of the updated-at time range. Use ISO 8601 format.
name: updated_at_min
in: query
- description: End of the updated-at time range. Use ISO 8601 format.
required: false
schema:
type: string
format: date-time
title: Updated At Max
description: End of the updated-at time range. Use ISO 8601 format.
name: updated_at_max
in: query
- description: Maximum number of records to return. Defaults to 20.
required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 20
description: Maximum number of records to return. Defaults to 20.
name: limit
in: query
- description: Zero-based offset of the first record to return. Defaults to 0.
required: false
schema:
title: Offset
minimum: 0
type: integer
default: 0
description: Zero-based offset of the first record to return. Defaults to 0.
name: offset
in: query
- required: false
schema:
$ref: '#/components/schemas/CoreRFQStatus'
description: Filter by status.
name: status
in: query
description: Filter by status.
- required: false
schema:
title: External Id
type: string
name: external_id
in: query
description: Filter RFQ records by external RFQ ID.
- description: Fairmarkit API Key
required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ListRetrieve_RFQListDetail_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns a list of RFQ events.
post:
tags:
- RFQ
summary: Create RFQ Event
operationId: create_services_self_service_api_v3_rfq__post
parameters:
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQ'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFQRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Creates a new RFQ event.
/services/self-service/api/v3/rfq/{uuid}/cancel:
post:
tags:
- RFQ
summary: Cancel RFQ Event
operationId: cancel_services_self_service_api_v3_rfq__uuid__cancel_post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQCancelRequest'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Cancels an existing RFQ event.
/services/self-service/api/v3/rfq/{uuid}/award:
post:
tags:
- RFQ
summary: Award RFQ
operationId: award_rfq_services_self_service_api_v3_rfq__uuid__award_post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: API key for authentication.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQAwardRequestData'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RfqIDResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Awards an RFQ by selecting quotation items and optionally providing a purchase order number.
/services/self-service/api/v3/rfq/{uuid}/quotations/:
get:
tags:
- RFQ
summary: List Quotations
operationId: get_quotations_list_services_self_service_api_v3_rfq__uuid__quotations__get
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 20
description: Maximum number of records to return. Defaults to 20.
name: limit
in: query
description: Maximum number of records to return. Defaults to 20.
- required: false
schema:
title: Offset
minimum: 0
type: integer
default: 0
description: Zero-based offset of the first record to return. Defaults to 0.
name: offset
in: query
description: Zero-based offset of the first record to return. Defaults to 0.
- description: If true, return only awarded quotations and within them only awarded items/subitems. Filter is applied on the current page only; `count` and pagination links reflect the unfiltered set.
required: false
schema:
title: Is Awarded Only
type: boolean
description: If true, return only awarded quotations and within them only awarded items/subitems. Filter is applied on the current page only; `count` and pagination links reflect the unfiltered set.
default: false
name: is_awarded_only
in: query
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ListRetrieve_Quotation_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns a list of quotations for an RFQ event.
/services/self-service/api/v3/rfq/{uuid}/archive:
post:
tags:
- RFQ
summary: Archive RFQ Event
operationId: archive_services_self_service_api_v3_rfq__uuid__archive_post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQArchiveRequest'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Archives an existing RFQ event.
/services/self-service/api/v3/rfq/{uuid}/approvals:
get:
tags:
- RFQ
summary: List RFQ Approvals
operationId: get_rfq_approvals_services_self_service_api_v3_rfq__uuid__approvals_get
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
title: Response Get Rfq Approvals
type: array
items:
$ref: '#/components/schemas/ApprovalDetail'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns approval data for an RFQ event.
/services/self-service/api/v3/rfq/{uuid}/approvals/{approval_id}/reject-step:
post:
tags:
- RFQ
summary: Reject RFQ Step
operationId: reject_rfq_step_services_self_service_api_v3_rfq__uuid__approvals__approval_id__reject_step_post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: true
schema:
title: Approval Id
format: uuid
type: string
name: approval_id
in: path
description: Approval ID.
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApprovalStepRejectRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ApprovalIdResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Rejects a step in the RFQ approval workflow.
/services/self-service/api/v3/rfq/{uuid}/approvals/{approval_id}/approve-step:
post:
tags:
- RFQ
summary: Approve RFQ Step
operationId: approve_rfq_step_services_self_service_api_v3_rfq__uuid__approvals__approval_id__approve_step_post
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
description: RFQ ID (Fairmarkit).
- required: true
schema:
title: Approval Id
type: string
format: uuid
name: approval_id
in: path
description: Approval ID.
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ApprovalStepRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ApprovalIdResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Approves a step in the RFQ approval workflow.
/services/self-service/api/v3/rfq/{uuid}/purchase-order/:
description: Updates purchase order information for an existing RFQ. The RFQ must be awarded before this endpoint can update it.
put:
tags:
- RFQ
summary: Update Purchase Order
operationId: update_purchase_order_services_self_service_api_v3_rfq__uuid__purchase_order__put
parameters:
- required: true
schema:
title: Uuid
type: string
format: uuid
name: uuid
in: path
- required: false
schema:
title: X-Fm-Api-Key
type: string
name: X-FM-API-KEY
in: header
description: Fairmarkit API Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RFQPurchaseOrder'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFQRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Updates purchase order information for an existing RFQ.
components:
schemas:
RFQArchiveRequest:
title: RFQArchiveRequest
required:
- archiving_note
type: object
properties:
archiving_note:
title: Archiving Note
maxLength: 1000
minLength: 1
type: string
BusinessUnitBuyerCompany:
title: BusinessUnitBuyerCompany
description: Defines the buyer company for a business unit.
required:
- id
- uuid
- title
type: object
properties:
id:
title: Id
type: integer
description: Company ID.
uuid:
title: Uuid
type: string
description: Company UUID.
title:
title: Title
type: string
description: Company name.
QuotationItem:
title: QuotationItem
required:
- uuid
- title
- kind
- is_cancelled
- is_awarded
- manufacturer
- manufacturer_pn
- is_awarding
- items
type: object
description: Data for a specific line item added to a quote.
properties:
uuid:
title: Uuid
type: string
description: Quotation Item ID
title:
title: Title
type: string
description: A brief, descriptive title for the request.
kind:
title: Kind
type: string
description: RFQ item type. Fairmarkit supports *item* and *service* types.
is_cancelled:
title: Is Cancelled
type: boolean
description: Is the request for quote canceled?
is_awarded:
title: Is Awarded
type: boolean
description: Is the request for quote awarded?
manufacturer:
title: Manufacturer
type: string
description: Manufacturer of the item.
manufacturer_pn:
title: Manufacturer Pn
type: string
description: Manufacturer part number of the item.
attachments:
title: Attachments
type: array
description: Attachments added to the line item on the supplier's response.
items:
$ref: '#/components/schemas/AttachmentRetrieve'
rfq_item_uuid:
title: Rfq Item Uuid
type: string
description: RFQ item ID (Fairmarkit).
delivery_days:
title: Delivery Days
type: integer
description: The number of days it will take to deliver the item.
quantity:
title: Quantity
type: number
description: Quantity of the item in the selected UOM.
minimum_order_quantity:
title: Minimum Order Quantity
type: integer
description: The minimum number of a item that is needed.
unit_price:
title: Unit Price
type: number
description: The USD price per unit (based on UOM).
unit_price_rfx:
title: Unit Price RFX
type: number
description: The price per unit (based on UOM and original RFX currency).
uom_percent:
title: Uom Percent
type: number
description: If the selected UOM is a percent value, the quantity of the item in percent.
uom_number_value:
title: Uom Number Value
type: number
description: If the selected UOM is a number value, the quantity of the item in a number value.
uom_text_value:
title: Uom Text Value
type: string
description: If the selected UOM is a text value, the amount of the item in a text value.
uom_yesno_value:
title: Uom Yesno Value
type: string
description: If the selected UOM is a yes/no value, the value for the item.
uom_date_value:
title: Uom Date Value
type: string
format: date
description: If the selected UOM is a date value, the date value for the item.
uom_date_range_start_value:
title: Uom Date Range Start Value
type: string
format: date
description: The start date in a date range.
uom_date_range_end_value:
title: Uom Date Range End Value
type: string
format: date
description: The end date in a date range.
uom_compliance_value:
title: Uom Compliance Value
anyOf:
- $ref: '#/components/schemas/CompliantUOM'
- $ref: '#/components/schemas/EmptyString'
description: Enter if the UOM is compliant. Available selections are *fully_compliant*, *partially_compliant*, or *non-compliant*.
uom_conversion_rate:
title: Uom Conversion Rate
type: string
description: UOM conversion rate.
uom_attachment:
title: Uom Attachment
type: string
description: UOM attachment.
uom:
title: Uom
anyOf:
- $ref: '#/components/schemas/ItemUOM'
- $ref: '#/components/schemas/ServiceUOM'
description: Unit of measurement for the item/quantity.
sku:
title: Sku
type: string
description: Item SKU.
comments:
title: Comments
type: string
description: Comments about the item.
country_of_origin:
title: Country Of Origin
anyOf:
- $ref: '#/components/schemas/Country'
- $ref: '#/components/schemas/EmptyString'
description: Two-character alphabetic code that represents a country name. Fairmarkit uses the Alpha-2 country codes defined in the ISO 3166 international standard.
awarded_at:
title: Awarded At
type: string
format: date-time
description: Date and time when the quote item was awarded by the buyer. String must be formatted using ISO 8601 format.
awarded_quantity:
title: Awarded Quantity
type: number
description: Awarded quantity of the item in the selected UOM.
quantity_change_reason_note:
title: Quantity Change Reason Note
type: string
external_supplier_item_id:
title: External Supplier Item ID
type: string
description: 'External Supplier Item ID. '
meta_tags:
title: Meta Tags
type: array
items:
$ref: '#/components/schemas/api__v3__models__meta_tag__MetaTagRetrieve'
default: []
description: Meta tags to store additional information.
supplier_pn:
type: string
title: Supplier Pn
is_awarding:
title: Is Awarding
type: boolean
description: Whether the item is currently being awarded.
awarding_quantity:
title: Awarding Quantity
type: number
description: Quantity being awarded for the item.
items:
title: Items
type: array
description: A list of requested items and services.
items:
$ref: '#/components/schemas/NestedQuotationItem'
AttachmentRetrieve:
title: AttachmentRetrieve
required:
- file
type: object
properties:
file:
title: File
type: string
description: Stored file name. If two files with the same name are added, a unique hash is added to the file. The file name when uploaded is available in orig_file_name.
orig_file_name:
title: Orig File Name
type: string
description: File name when uploaded.
description: Attachment details returned by the API.
InternalNote:
title: InternalNote
type: object
description: Internal notes capture event details for internal use only.
properties:
attachments:
items:
$ref: '#/components/schemas/AttachmentRetrieve'
type: array
body:
title: Body
type: string
description: Text for the internal note.
created_at:
title: Created At
type: string
format: date-time
description: Date and time when the internal note was created. String must be formatted using ISO 8601 format.
user:
title: User
type: string
description: Email of the user that created the internal note.
required:
- attachments
- body
- created_at
- user
AwardedQuotationItem:
title: AwardedQuotationItem
required:
- quotation_item_uuid
- awarded_quantity
type: object
properties:
quotation_item_uuid:
type: string
format: uuid
title: Quotation Item Uuid
awarded_quantity:
type: string
title: Awarded Quantity
description: Awarded quantity as a decimal string
subitems:
type: array
items:
$ref: '#/components/schemas/AwardedQuotationSubItem'
title: Subitems
description: List of sub-items, each represented as an AwardedQuotationSubItem object
CoreRFQStatus:
title: CoreRFQStatus
enum:
- draft
- pending
- opened
- closed
- awarded
- canceled
- archived
- scheduled
description: Request for quote (RFQ) event status values.
RFQItemRetrieve:
title: RFQItemRetrieve
required:
- uuid
- title
- kind
- attachments
- is_awarded_to_benchmark
type: object
description: Data for a specific line item added to an RFQ.
properties:
uuid:
title: Uuid
type: string
description: RFQ item ID (Fairmarkit).
title:
title: Title
type: string
description: A brief, descriptive title for the item.
kind:
$ref: '#/components/schemas/Kind'
attachments:
title: Attachments
type: array
description: Line item attachments.
items:
$ref: '#/components/schemas/AttachmentRetrieve'
quantity:
title: Quantity
type: number
description: Quantity of the item in the selected UOM.
items:
title: Items
type: array
description: A list of requested goods and services (subitems to the item).
items:
$ref: '#/components/schemas/RFQSubitemRetrieve'
uom:
title: Uom
anyOf:
- $ref: '#/components/schemas/ItemUOM'
- $ref: '#/components/schemas/ServiceUOM'
description: Unit of measurement for items. See Fairmarkit documentation for supported UOM values.
manufacturer:
title: Manufacturer
type: string
description: Manufacturer of the item.
m
# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fairmarkit/refs/heads/main/openapi/fairmarkit-rfq-api-openapi.yml