Fairmarkit RFP API
The RFP API from Fairmarkit — 5 operation(s) for rfp.
The RFP API from Fairmarkit — 5 operation(s) for rfp.
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-rfp-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 Business Units RFP 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: RFP
paths:
/services/self-service/api/v3/rfp/:
get:
tags:
- RFP
summary: List RFPs
operationId: get_rfp_list_services_self_service_api_v3_rfp__get
parameters:
- 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/CoreRFPStatus'
description: Filter by status.
name: status
in: query
description: Filter by status.
- 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: 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_RFPListDetail_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns a list of RFP events.
/services/self-service/api/v3/templates/rfp/{template_uuid}/create-rfp/:
post:
tags:
- RFP
summary: Create RFP From Template
operationId: create_rfp_from_template_services_self_service_api_v3_templates_rfp__template_uuid__create_rfp_post
parameters:
- required: true
schema:
title: Template UUID
type: string
format: uuid
name: template_uuid
in: path
description: Fairmarkit UUID of the RFP template.
- 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/RFP'
required: true
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFPCreateFromTemplateRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Creates a new request for proposal (RFP) event from a RFP template.
/services/self-service/api/v3/rfp/{uuid}/proposals/:
get:
tags:
- RFP
summary: Get Proposals List
operationId: get_proposals_list_services_self_service_api_v3_rfp__uuid__proposals__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.
- 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_Proposal_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns data about a specific proposal (response) on a request for proposals (RFP) event.
/services/self-service/api/v3/rfp/{uuid}/:
get:
tags:
- RFP
summary: Get RFP Details
operationId: retrieve_services_self_service_api_v3_rfp__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
responses:
'200':
description: Successful Response
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/RFPRetrieve'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns details for an RFP event.
/services/self-service/api/v3/templates/rfp/:
get:
tags:
- RFP
summary: List RFP Templates
operationId: get_rfp_templates_services_self_service_api_v3_templates_rfp__get
parameters:
- 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_RFPTemplateRetrieve_'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Returns a list of all created RFP Templates.
components:
schemas:
RFPListDetail:
title: RFPListDetail
required:
- id
- uuid
- title
- status
- created_at
- is_rfi
- is_outlier
type: object
properties:
id:
type: string
title: Id
uuid:
title: Uuid
type: string
description: RFP UUID (Fairmarkit).
title:
title: Title
type: string
description: A brief, descriptive title for the request.
status:
$ref: '#/components/schemas/CoreRFPStatus'
external_id:
title: External Id
type: string
default: ''
description: External RFP reference ID. It can be used to track RFPs across systems.
created_at:
title: Created At
type: string
format: date-time
description: Date and time when the RFP was created. String must be formatted using ISO 8601 format.
closes_at:
type: string
format: date-time
title: Closes At
scheduled_publish_at:
type: string
format: date-time
title: Scheduled Publish At
questions_due_at:
type: string
format: date-time
title: Questions Due At
is_rfi:
type: boolean
title: Is Rfi
is_outlier:
type: boolean
title: Is Outlier
request_id:
type: string
title: Request Id
description: Data returned for a list of request for proposal (RFP) events.
CompliantUOM:
title: CompliantUOM
enum:
- fully_compliant
- partially_compliant
- non_compliant
description: UOM compliance values.
RFPItem:
title: RFPItem
required:
- uuid
- is_optional
- description
- is_awarded
- kind
type: object
properties:
uuid:
title: Uuid
type: string
format: uuid
description: RFP item ID (Fairmarkit).
is_optional:
title: Is Optional
type: boolean
description: Whether or not the item is optional.
description:
title: Description
type: string
description: RFP item description.
is_awarded:
title: Is Awarded
type: boolean
description: Whether or not the RFP item is awarded.
benchmark_price:
title: Benchmark Price
type: number
description: Benchmark price of the RFP item.
comments:
title: Comments
type: string
default: ''
description: Comments about the item
unspsc:
title: Unspsc
type: string
description: Standard UNSPSC code for the item.
unspsc_manual:
title: Unspsc Manual
type: string
description: Manually entered UNSPSC code for the item.
meta_tags:
title: Meta Tags
description: Meta tags to store additional information. Send a list of meta tags, and they will be processed. To remove all meta tags, send an empty list.
type: array
items:
$ref: '#/components/schemas/schemas__base__meta_tag__MetaTagRetrieve'
default: []
manufacturer:
title: Manufacturer
type: string
description: Manufacturer of the item.
manufacturer_pn:
title: Manufacturer Pn
type: string
description: Manufacturer part number of the item.
quantity:
title: Quantity
type: number
description: Quantity of the item in the selected UOM.
kind:
$ref: '#/components/schemas/Kind'
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.
attachments:
description: RFP item attachments.
title: Attachments
type: array
items:
$ref: '#/components/schemas/File'
default: []
items:
title: Items
type: array
description: A list of requested items and services.
items:
$ref: '#/components/schemas/BaseRFPItem'
default: []
NestedProposalSupplier:
title: NestedProposalSupplier
required:
- uuid
- email
- title
type: object
properties:
uuid:
title: Uuid
type: string
erp_systems:
title: Erp Systems
type: array
items:
$ref: '#/components/schemas/NestedProposalSupplierErpSystem'
default: []
email:
title: Email
type: string
description: Supplier contact's email address.
title:
title: Title
type: string
description: Supplier Title
CategoryRetrieve:
title: CategoryRetrieve
description: Data to retrieve about a specific category.
required:
- uuid
- title
- visual_title
- external_id
type: object
properties:
uuid:
title: Uuid
type: string
description: Category UUID.
title:
title: Title
type: string
description: Category name.
visual_title:
title: Visual Title
type: string
description: Category display name.
external_id:
title: External Id
type: string
description: Category external ID.
EmptyString:
title: EmptyString
enum:
- ''
type: string
description: Marker used to represent an empty string.
RFPRetrieve:
title: RFPRetrieve
type: object
required:
- is_rfi
- is_outlier
properties:
title:
title: Title
type: string
description: The title of the RFP.
status:
$ref: '#/components/schemas/CoreRFPStatus'
external_rfp_id:
title: External Rfp Id
type: string
description: External RFP reference ID. It can be used to track RFPs across systems.
event_description:
title: Event Description
type: string
description: Event description. A detailed description to explain why you are running an event.
justification:
title: Justification
type: string
description: Event Justification. A note describing the justification for the event.
value:
title: Value
type: number
description: Projected value of the event.
savings:
title: Savings
type: number
description: Projected savings.
currency:
$ref: '#/components/schemas/Currency'
is_nda_required:
title: Is Nda Required
type: boolean
description: Is NDA required to participate in this RFP?
department:
title: Department
type: string
description: Department or business unit that requested the event.
scheduled_publish_at:
title: Scheduled Publish At
type: string
format: date-time
description: Date and time when the RFP is scheduled to be published. At this date and time, suppliers are invited to submit responses. String must be formatted using ISO 8601 format.
questions_due_at:
title: Questions Due At
type: string
format: date-time
description: Date and time when suppliers should submit any questions about the event. String must be formatted using ISO 8601 format.
closes_at:
title: Closes At
type: string
format: date-time
description: Date and time when the RFP is scheduled to close. String must be formatted using ISO 8601 format.
request_id:
type: string
title: Request Id
sections:
title: Sections
type: array
description: A list of sections on the RFP.
items:
$ref: '#/components/schemas/RFPSection'
default: []
category:
$ref: '#/components/schemas/CategoryRetrieve'
is_rfi:
type: boolean
title: Is Rfi
awarded_amount_manual:
type: string
title: Awarded Amount Manual
awarded_amount_manual_usd:
type: string
title: Awarded Amount Manual USD
awarded_savings_manual:
type: string
title: Awarded Savings Manual
awarded_savings_manual_usd:
type: string
title: Awarded Savings Manual USD
awarding_amount_manual:
type: string
title: Awarding Amount Manual
highest_proposal_manual:
type: string
title: Highest Proposal Manual
highest_proposal_manual_usd:
type: string
title: Highest Proposal Manual USD
identified_savings_manual:
type: string
title: Identified Savings Manual
identified_savings_manual_usd:
type: string
title: Identified Savings Manual USD
lowest_proposal_manual:
type: string
title: Lowest Proposal Manual
lowest_proposal_manual_usd:
type: string
title: Lowest Proposal Manual USD
projected_savings_manual:
type: string
title: Projected Savings Manual
projected_savings_manual_usd:
type: string
title: Projected Savings Manual USD
is_outlier:
type: boolean
title: Is Outlier
BaseRFPItem:
title: BaseRFPItem
required:
- uuid
- is_optional
- description
type: object
properties:
uuid:
title: Uuid
type: string
format: uuid
description: UUID of the RFP Item
is_optional:
title: Is Optional
type: boolean
description: Whether or not the item is optional
description:
title: Description
type: string
description: Description of the RFP item
is_awarded:
title: Is Awarded
type: boolean
description: Whether or not the item is awarded
benchmark_price:
title: Benchmark Price
type: number
description: Benchmark price of the RFP item
comments:
title: Comments
type: string
default: ''
description: Comments about the item.
unspsc:
title: Unspsc
type: string
description: Standard UNSPSC code for the item.
unspsc_manual:
title: Unspsc Manual
type: string
description: Manually entered UNSPSC code for the item.
meta_tags:
title: Meta Tags
type: array
items:
$ref: '#/components/schemas/schemas__base__meta_tag__MetaTagRetrieve'
default: []
description: Meta tags to store additional information. Send a list of meta tags, and they will be processed. To remove all meta tags, send an empty list.
manufacturer:
title: Manufacturer
type: string
description: Manufacturer of the item.
manufacturer_pn:
title: Manufacturer Pn
type: string
description: Manufacturer part number of the item.
quantity:
title: Quantity
type: number
description: Quantity of the item in the selected UOM.
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.
attachments:
items:
$ref: '#/components/schemas/File'
type: array
title: Attachments
default: []
RFP:
title: RFP
type: object
description: Request for proposal (RFP) from RFP template
properties:
title:
title: Title
type: string
description: RFP event title. A brief title that describes what is included in the event.
event_description:
title: Event Description
type: string
description: 'Event description. A detailed description to explain why you are running an event '
justification:
title: Justification
type: string
description: Event Justification. A note describing the justification for the event.
external_rfp_id:
title: External RFP Id
type: string
description: External RFP reference ID. It can be used to track RFPs across systems.
value:
title: Value
type: number
description: Projected value of the event.
savings:
title: Savings
type: number
description: Projected savings.
currency:
allOf:
- $ref: '#/components/schemas/Currency'
default: USD
is_nda_required:
title: Is NDA Required
type: boolean
description: Is NDA required to participate in this RFP?
department:
title: Department
type: string
description: Department or business unit that requested the event.
scheduled_publish_at:
title: Scheduled Publish At
type: string
format: date-time
description: Date and time when the RFP is scheduled to be published. At this date and time, suppliers are invited to submit responses. String must be formatted using ISO 8601 format.
questions_due_at:
title: Questions Due Date
type: string
format: date-time
description: Date and time when suppliers should sumbit any questions about the event. String must be formatted using ISO 8601 format.
closes_at:
title: Close date
type: string
format: date-time
description: Date and time when the RFP is scheduled to close. String must be formatted using ISO 8601 format.
planned_start_at:
title: Planned Start At
type: string
format: date-time
description: Date you plan to purchase items or services or start the project.
request_id:
type: string
title: Request Id
buyer:
title: Buyer
type: string
format: email
description: Fairmarkit buyer's email address. If left blank RFP will be created for Admins Only.
status:
$ref: '#/components/schemas/CoreRFPStatus'
ServiceUOM:
title: ServiceUOM
enum:
- each
- fte
- yes_no
- hour
- day
- analysis
- multiple_choice
- audit
- campaign
- contract
- event
- integration
- production
- program
- project
- site
- sme
- training
- webinar
- year
- quarter
- month
- week
- minute
- second
- date
- date_range
- text
- attachment
- percent
- no_response
- number
- compliance
- lump sum
- set
- metric ton
- words
- asin
- segments
- annotations_lines
- labels
- videos
- pages
- per_thousand_words
- meter_minute
- pikofarad
- acre
- ton_cubic_meter
- enzyme_units
- gigajoule
- canister
- crate
- activity_unit
- mile
- cubic_millimeter
- milliwatt
- megawatt_hour
- points
- group_proportion
- microsiemens_per_cm
description: Supported units of measurement for services.
ProposalSubitem:
title: ProposalSubitem
required:
- uuid
- title
- is_awarded
- is_cancelled
- rfp_subitem_uuid
type: object
description: Data for a specific line item added to a proposal.
properties:
uuid:
title: Uuid
type: string
format: uuid
description: Proposal Item ID (Fairmarkit).
title:
title: Title
type: string
description: A brief, descriptive title for the request.
is_awarded:
title: Is Awarded
type: boolean
description: Is the line item awarded?
is_cancelled:
title: Is Cancelled
type: boolean
description: Is the line item canceled?
quantity:
title: Quantity
type: number
description: Quantity of the item in the selected UOM.
manufacturer:
title: Manufacturer
type: string
description: Manufacturer of the item
manufacturer_pn:
title: Manufacturer Pn
type: string
description: Manufacturer part number of the item.
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.
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
unit_price:
title: Unit Price
type: number
description: The USD price per unit (based on UOM).
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.
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.
sku:
title: Sku
type: string
description: Item SKU.
uom:
title: Uom
anyOf:
- $ref: '#/components/schemas/ItemUOM'
- $ref: '#/components/schemas/ServiceUOM'
description: Unit of measurement for the item/quantity.
awarded_at:
title: Awarded At
type: string
format: date-time
description: Date and time when the proposal item was awarded by the buyer. String must be formatted using ISO 8601 format.
rfp_subitem_uuid:
title: Rfp Subitem Uuid
type: string
format: uuid
description: RFP item ID (Fairmarkit).
attachments:
title: Attachments
type: array
description: Attachments added to the line item on the supplier's response.
items:
$ref: '#/components/schemas/File'
default: []
uom_attachment:
$ref: '#/components/schemas/File'
ListRetrieve_Proposal_:
title: ListRetrieve[Proposal]
required:
- count
- results
type: object
properties:
count:
title: Count
type: integer
next:
title: Next
type: string
previous:
title: Previous
type: string
results:
title: Results
type: array
items:
$ref: '#/components/schemas/Proposal'
ItemUOM:
title: ItemUOM
enum:
- each
- acre
- activity_unit
- assembly
- bag
- bale
- bar
- barrel
- block
- board foot
- bottle
- box
- bucket
- bulk
- bundle
- cake
- can
- canister
- card
- carton
- cartridge
- case
- centimeter
- coil
- container
- crate
- cube
- cubic foot
- cubic meter
- cubic_millimeter
- cubic yard
- cup
- cylinder
- dozen
- drum
- enzyme_units
- foot
- gallon
- gigajoule
- gram
- gross
- group_proportion
- 1/2 cubic yard
- hank
- hectare
- hour
- hundred
- imperial gallon
- inch
- jar
- keg
- kilogram
- kiloliter
- kilometer
- kilowatt
- kit
- length
- light
- liter
- lot
- lug
- lump sum
- megawatt_hour
- meter
- meter_minute
- metric ton
- microsiemens_per_cm
- mile
- milliliter
- millimeter
- milliwatt
- multiple_choice
- net ton
- night
- ounce
- pack
- package
- packet
- pad
- pail
- pair
- pallet
- pancake
- part
- pg
- piece
- pikofarad
- pint
- points
- pot
- pound
- punnet
- quart
- rack
- ream
- reel
- roll
- sachet
- set
- sheet
- spool
- square foot
- square inch
- square meter
- square yard
- suit
- tank
- thousand
- tin
- ton
- tonne
- ton_cubic_meter
- tray
- tub
- tube
- unit
- unit_f
- volt-amper
- yard
- year
description: Supported units of measurement for items.
RFPTemplateRetrieve:
title: RFPTempla
# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fairmarkit/refs/heads/main/openapi/fairmarkit-rfp-api-openapi.yml