Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
All 92 tools
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/partstech-callback-cart-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 2.021.1
title: PartsTech Callback Cart API
description: "\n# Rate Limiting\n\nRequests can be limited by user requests, by private partner requests and by all requests with partner's credentials.\nIt has several time intervals:\n - *Per day* restricts count of requests made in one day.\n - *Requests per second* restricts count of requests made in one second.\n - *Concurrent requests* restricts count of parallel requests.\n - *Sliding 15 minutes* restricts count of requests made in last 15 minutes.\n\n**Note**: Every method has own separate sets of the limits.\n\n## Headers\nUse the HTTP headers in order to understand where the application is at for a given rate limit, on the method that was just utilized.\nThe HTTP header is returned only for one general limit or for limit that user reached.\n\n\n*Headers*\n - the rate limit ceiling for that given endpoint:\n ```\n x-rate-limit-limit: 1000\n ```\n - the number of requests left:\n ```\n x-rate-limit-remaining: 570\n ```\n - the remaining window before the rate limit resets, in UTC [epoch seconds](https://en.wikipedia.org/wiki/Unix_time):\n ```\n x-rate-limit-reset: 1552003200\n ```\n\nWhen an application exceeds the rate limit for a given standard API endpoint,\nthe API will return a HTTP 429 “Too Many Requests” response code, and the following error will be returned in the response body:\n```\n{\n \"error\": {\n \"code\": \"TooManyRequests\",\n \"message\": \"Some description\"\n }\n}\n```\n\n# Pagination\n\nWhen you call an API method to retrieve information, it can be returned to you in portions.\nCheck out more detail below on pagination in API methods, including how to use them and which methods follow the pattern.\n\nAPI methods that supports pagination will return the `Link` header. It will include available urls of `first`, `last`, `previous` and `next` pages.\n\n```\nLink: <https://api.partstech.com/purchases?page=1>; rel=\"first\"\nLink: <https://api.partstech.com/purchases?page=1>; rel=\"previous\"\nLink: <https://api.partstech.com/purchases?page=3>; rel=\"next\"\nLink: <https://api.partstech.com/purchases?page=142>; rel=\"last\"\n```\n\n# MOTOR Compliance Requirements\n\nAll MOTOR-powered endpoints (Labor, Maintenance Schedules, Fluids, and Specifications) return a `Link` header\ncontaining the URL to MOTOR's OEM Compliance Requirements documentation.\n\nThe header follows the [RFC 8288 (Web Linking)](https://tools.ietf.org/html/rfc8288) format:\n\n```\nLink: <https://www.motor.com/oem-compliance-requirements/>; rel=\"compliance\"\n```\n\n# Errors\n\nThe API uses standard HTTP status codes to indicate the success or failure of the API call. The body of the response will be JSON in the following format:\n\n```\n{\n \"error\": {\n \"code\": \"InternalErrorCode\",\n \"message\": \"Some description\"\n }\n}\n```\n\n# Error Responses\nSome default error responses used in the API.\n\nHttp Code | Explanation | Content Type | Used error codes\n----------------|-------------|------------------|---------\n400 | Bad Request. The request was unacceptable. | `application/json` | `InvalidRequestSyntax`\n401 | Unauthorized. The request requires user or partner credentials or bearer token. Also used for invalid credentials or bearer token. | `application/json` | `InvalidToken`, `UserAuthenticationFailed`, `PartnerAuthenticationFailed`\n402 | Request Failed. The parameters were valid but the request failed. | `application/json` | Different codes, depend on method.\n403 | Forbidden. Also used for unauthorized requests such as improper credentials scopes or permissions issues. | `application/json` | `IncorrectMode`, `DisabledApiUsage`, `UserIsNotActivated`, `HaveNotPermission`, `NotAvailableMethod`\n404 | Some data in the request is not found. Or incorrect url was used. | `application/json`, `text/html`, no content | `NotFound`\n405 | Method not allowed. | `application/json`, `text/html`, no content |\n406 | Unacceptable content type. Client sent an accepts header for a content type which does not exist on the server. | No content |\n409 | Locked. One of the another operations that is in progress blocks this method call. | `application/json` | `LockedSession`\n429 | Too Many Requests | `application/json` | `TooManyRequests`\n432 | Integration Error | `application/json` |\n500 | Internal Server Error. (This is rare.) | `application/json` | `InternalError`\n501 | Not Implemented | `application/json` | `MethodNotImplemented`\n503 | The backend server is not available. (This is rare.) | No content |\n"
x-logo:
url: https://partstech.com/wp-content/uploads/2025/03/PartsTech_OEC-compnay_logo.svg
altText: PartsTech logo
servers:
- url: https://api.partstech.com
description: Production server
- url: https://api.beta.partstech.com
description: Beta server
tags:
- name: callback-cart
description: Callback
x-displayName: Callback
paths:
/our-callback:
post:
summary: Cart Callback
description: 'The cart callback allows PartsTech to send session quote and order data to the partner application as soon as a cart button is clicked. After a user has added items to the cart, quote data is sent when the user clicks the Submit Quote button, while order data is sent when the Buy Now button is clicked. To receive these callbacks, the partner application needs to set up an endpoint that can accept POST requests from PartsTech.
The URL of the callback endpoint will be sent to PartsTech as the `callbackUrl` and `callbackOrderUrl` in create session requests. The partner application should be able to differentiate between quote and order data when a session''s callback data is received. This can be done by using the `action` field. If the `action` field contains `SUBMIT_QUOTE`, then the user clicked the Submit Quote cart button to transfer quote data to the partner application. If the `action` field contains `PURCHASE`, then the user clicked the Buy Now cart button to place the orders with suppliers and transfer order data to the partner application.
The schema for quote and order data is almost the same, the difference being that order data has two additional fields: `id` (PartsTech generated order ID) and `orderUrl` (URL for order details).
'
tags:
- callback-cart
requestBody:
content:
application/json:
schema:
type: object
required:
- user
- sessionId
- orders
properties:
user:
$ref: '#/components/schemas/User'
sessionId:
type: string
description: The unique identifier of a punchout session.
example: 1ag3d2b5240e4jcbbe3ee9c49c929fe4
orders:
description: Contains quote or order information, including supplier, pricing, and detailed part/tire information. Will contain a list of `PunchoutOrder` for quotes, or a list of `PunchoutPurchasedOrder` for placed orders.
type: array
minItems: 1
items:
oneOf:
- $ref: '#/components/schemas/PunchoutOrder'
- $ref: '#/components/schemas/PunchoutPurchasedOrder'
localInventoryItems:
type: array
items:
$ref: '#/components/schemas/CartLocalInventoryItem'
action:
description: Indicates whether the callback contains quote, order, or tire comparison quote data. Value `SUBMIT_QUOTE` indicates quote data, and `PURCHASE` indicates order data. Value `TIRE_QUOTE` indicates tire comparison quote data, which means that a shop's customer has chosen a tire from PartsTech's tire comparison quote feature.
type: string
enum:
- SUBMIT_QUOTE
- PURCHASE
- TIRE_QUOTE
selectedLaborItems:
type:
- array
- 'null'
description: 'Labor items that were selected by user.
Labor items may be attached to items and cart/punchout session.
Selected labor items are not used (they will not be copied or returned) in next methods:
- [Create Custom Cart](#operation/customCartCreate)
- [Order Custom Cart](#operation/submitItems)
- [Check Custom Cart Availability](#operation/checkItemsAvailability)
'
items:
$ref: '#/components/schemas/PunchoutLaborItem'
responses:
'200':
description: OK
'201':
description: OK
'202':
description: OK
'204':
description: OK
/tire-quote-callback:
post:
summary: Tire Quote Callback
description: 'Callback, that sends orders with quote to partner. It is available if `callbackUrl` is provided.
Please, do not provide invalid `callbackUrl`. It slows user''s work with cart with no effect.
'
tags:
- callback-cart
requestBody:
content:
application/json:
schema:
type: object
required:
- user
- sessionId
- orders
properties:
user:
$ref: '#/components/schemas/User'
sessionId:
type: string
description: The identifier of a punchout session.
orders:
type: array
minItems: 1
items:
$ref: '#/components/schemas/PunchoutOrder'
localInventoryItems:
type: array
items:
$ref: '#/components/schemas/CartLocalInventoryItem'
action:
type: string
enum:
- SUBMIT_QUOTE
- PURCHASE
- TIRE_QUOTE
selectedLaborItems:
type:
- array
- 'null'
description: 'Labor items that were selected by user.
Labor items may be attached to items and cart/punchout session.
Selected labor items are not used (they will not be copied or returned) in next methods:
- [Create Custom Cart](#operation/customCartCreate)
- [Order Custom Cart](#operation/submitItems)
- [Check Custom Cart Availability](#operation/checkItemsAvailability)
'
items:
$ref: '#/components/schemas/PunchoutLaborItem'
itemizedQuote:
$ref: '#/components/schemas/ItemizedQuote'
responses:
'200':
description: OK
'201':
description: OK
'202':
description: OK
'204':
description: OK
components:
schemas:
PartCategory:
type:
- string
- 'null'
enum:
- Maintenance
- Service
- Consumable
Rewards:
type:
- array
- 'null'
minItems: 0
items:
type: object
properties:
program:
type:
- string
- 'null'
points:
type:
- integer
- 'null'
bonusPoints:
type:
- integer
- 'null'
ItemizedQuote:
type:
- object
- 'null'
required:
- quantity
- tax
- lines
properties:
quantity:
type: integer
tax:
type: number
format: float
lines:
type: array
items:
$ref: '#/components/schemas/ItemizedQuotePricingLine'
PunchoutPurchasedOrder:
allOf:
- type: object
required:
- id
- orderUrl
properties:
id:
description: The PartsTech ID for the order.
type: integer
example: 128577
orderUrl:
type: string
example: https://app.partstech.com/some-invoice-url
description: The URL of the PartsTech order details page.
- $ref: '#/components/schemas/PunchoutOrder'
ResponseTaxonomy:
type:
- object
- 'null'
description: "Part taxonomy has three levels of classification. \nCategory, subcategory, and part type. \nCategory is the most broad and each category contains subcategories.\nEach subcategory contains part types. \nPart type is the most specific classification for a part. \nFor example, the taxonomy for brake pads are the following\n\\- Category = Brake - Subcategory = Disc Pads and Brake Shoes - Part Type = Disc Brake Pad Set.\n"
required:
- partTypeId
properties:
partTypeId:
type: integer
example: 14216
description: The ID of a part type from the Autocare Association's PCdb.
partTypeName:
type:
- string
- 'null'
example: Air Filter Set
description: The name of a part type.
partTypeDescription:
type:
- string
- 'null'
example: Initial fill additive for turbochargers.
description: The description of a part type.
categoryId:
type:
- integer
- 'null'
example: 12
description: The ID of a part category from the Autocare Association's PCdb. Category is the highest level of part taxonomy.
categoryName:
type:
- string
- 'null'
example: Air and Fuel Delivery
description: The name of a category.
subCategoryId:
type: integer
example: 153
description: The ID of a subcategory from the Autocare Association's PCdb.
subCategoryName:
type:
- string
- 'null'
example: Filters
description: The name of a subcategory.
example:
partTypeId: 8852
partTypeName: Windshield Wiper Blade
categoryId: 22
categoryName: Wiper and Washer
subCategoryId: 236
subCategoryName: Windshield Wiper Arm, Blade, and Related Components
DeliveryNote:
type: object
required:
- label
- text
- date
properties:
label:
type:
- string
- 'null'
text:
type:
- string
- 'null'
PartPrice:
type: object
required:
- cost
- core
- fet
properties:
list:
type:
- number
- 'null'
format: float
example: 1.2
description: Not all parts will have a list price. This property will contain the null value for parts without a list price.
price:
type: number
format: float
example: 1.6
description: Total price charged to the user for an item, includes discounts and core charge if applicable.
cost:
type: number
format: float
example: 1.24
description: Cost of an item for the user including any discounts. Excludes any core charges.
core:
type: number
format: float
example: 0.4
description: A fee for certain part types that is returned to the purchaser when the old part that is being replaced is returned to the store.
fet:
type:
- number
- 'null'
description: The Federal Excise Tax (FET) applies to tires used on the road with a maximum load capacity greater than 3500 pounds. This tax is charged to the purchaser of the tire from the tire supplier. Only 100% accurate FET values are sent through the PartsTech API.
format: float
example: 1.2
retail:
type:
- number
- 'null'
description: The price to charge customers. PartsTech calculates this price by taking the ``cost`` and then applying the appropriate mark up from the user's retail pricing configuration. This property will be null if there is no applicable mark up to the item or if the user has not set up their retail pricing configuration.
format: float
example: 2
discount:
type:
- number
- 'null'
description: The discount for an item. There can be a discount when an item is quoted or purchased as part of a bundled deal from participating suppliers.
format: float
example: 0.2
map:
type:
- number
- 'null'
description: Minimum Advertised Price
format: float
example: 1.9
PunchoutOrder:
type: object
required:
- supplier
- store
- delivery
- buyerShop
- tax
- totalPrice
- totalDiscount
- coreCharge
- fet
- shippingPrice
- paymentType
- parts
properties:
supplier:
$ref: '#/components/schemas/CartSearchSupplier'
store:
oneOf:
- $ref: '#/components/schemas/OrderStore'
- $ref: '#/components/schemas/PaidOrderStore'
delivery:
description: Delivery details
type: object
required:
- price
properties:
name:
type:
- string
- 'null'
example: hotshot
description: Type of delivery
price:
type: number
format: float
example: 1.24
description: Cost of delivery
buyerShop:
$ref: '#/components/schemas/Address'
tax:
type: number
format: float
example: 9.01
description: Sales tax, if applicable. Typically shops are tax-exempt.
totalPrice:
type: number
format: float
example: 25
description: Total price charged to the user for an order, includes discounts and core charge if applicable.
totalDiscount:
type: number
format: float
example: 5
description: Total discounts for an order
coreCharge:
type: number
format: float
example: 12
description: A fee for certain part types that is returned to the purchaser when the old part that is being replaced is returned to the store.
fet:
type: number
description: The Federal Excise Tax (FET). The tax imposed by the federal government on tires used on the road with a maximum load capacity greater then 3500 pounds. Only 100% accurate FET values are present in this field.
format: float
example: 1.2
shippingPrice:
type: number
format: float
example: 1.24
description: Cost of delivery.
paymentType:
type: string
enum:
- CreditCard
- Wholesale
parts:
type: array
items:
$ref: '#/components/schemas/PunchoutOrderPart'
poNumber:
type:
- string
- 'null'
example: 2743
description: The purchase order number
notes:
type:
- string
- 'null'
example: Notes
description: Supplier notes
BriefStore:
type: object
required:
- id
- name
properties:
id:
type: integer
example: 1
description: PartsTech's ID for a store.
name:
type: integer
example: 5904 - Springfield, MA
description: The name of a store
CartSearchSupplier:
allOf:
- $ref: '#/components/schemas/BriefSupplier'
- type: object
required:
- allowStoreSelect
- availabilitySelect
properties:
allowStoreSelect:
type: boolean
description: If true for a supplier, users have the option to select a specfic store when sourcing parts.
availabilitySelect:
type: boolean
description: If true for a supplier, users are required to select a specific store when sourcing parts.
postOrderUpdates:
type: boolean
description: If true for a supplier, order can be updated after they placed.
Brand:
type: object
description: Contains brand information about a part.
required:
- brandID
- brandName
properties:
brandID:
type: string
example: BBCM
description: The ID of a brand from the Autocare Association.
brandName:
type: string
example: Alba
description: The name of a brand.
id:
description: PartsTech's ID for a brand.
type:
- integer
- 'null'
example: 1
displayName:
type:
- string
- 'null'
example: Alba
lineCode:
type:
- string
- 'null'
example:
brandID: BBHK
brandName: Bosch
id: 551
displayName: Bosch
CartLocalInventoryItem:
type: object
required:
- itemId
- inventoryUID
- partId
- quantity
- price
- partName
- partNumber
- availability
- brand
properties:
itemId:
type: string
example: 0ze4f01824764a61991b9d090fdc1813
description: 'The unique identifier for an item added to a cart.
This ID allows PartsTech to reference a specific item in a specific session and its cart details (e.g. PO number, supplier notes, delivery method)."
'
inventoryUID:
type: string
example: 123123123
description: ID of item in local inventory.
partId:
type: string
example: ABCD-12345
description: PartsTech's ID for a part. Consists of `brandId`-`partNumber`.
quantity:
type: integer
example: 2
description: The requested quantity for a part.
price:
$ref: '#/components/schemas/PartPrice'
partName:
type: string
example: Motorcraft Engine Oil Filter
description: The name of the part. Part name is typically the brand name + the part type name. For tires it is typically the brand name + model. There is a shop setting that can be enabled to remove the brand name from this field for all parts (tires excluded).
partNumber:
type: string
example: 12345
description: The manufacturer part number.
imageUrl:
type:
- string
- 'null'
format: url
description: The URL of the part image that PartsTech uses for the part.
example: https://image.partstech.com/d1/images/e4/11/71/w110_e411711499973c7640e852e84ed20fca0cd5c9d2.png
partstechCatalogURL:
type:
- string
- 'null'
format: url
description: The URL of the part's description on PartsTech.
example: https://punchout.partstech.com/Motorcraft-Engine-Oil-Filter/details/BBRH-FL-500-S?part_term=5340
availability:
type: boolean
example: true
description: Returns true if the part is available at the time of quoting.
vehicleId:
type:
- integer
- 'null'
description: PartsTech's ID for a vehicle.
vehicleName:
type:
- string
- 'null'
description: Name of the vehicle selected for fitment during the PartsTech session. Typically consists of year, make, model, and engine.
brand:
$ref: '#/components/schemas/Brand'
taxonomy:
$ref: '#/components/schemas/ResponseTaxonomy'
partCategory:
$ref: '#/components/schemas/PartCategory'
searchedAsPartNumber:
type:
- string
- 'null'
attributes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Attribute'
Attribute:
type: object
properties:
name:
type: string
label:
type: string
value:
type: string
type:
type: string
enum:
- Vehicle
- Part
- Both
dbInfo:
type:
- object
- 'null'
required:
- dbName
- tableName
- idFieldName
- idValue
properties:
dbName:
type: string
tableName:
type: string
idFieldName:
type: string
idValue:
type: string
ItemizedItemQuote:
type:
- object
- 'null'
required:
- tax
- lines
properties:
tax:
type: number
format: float
lines:
type: array
items:
$ref: '#/components/schemas/ItemizedQuotePricingLine'
PaidOrderStore:
description: Store Data for Paid Orders
allOf:
- $ref: '#/components/schemas/OrderStore'
- type: object
required:
- sellerId
properties:
sellerId:
type:
- string
- 'null'
Address:
type: object
description: Address of the user's shop
required:
- address1
- city
- state
- zipCode
properties:
address1:
type: string
example: 1 Broadway
address2:
type:
- string
- 'null'
example: 14th Floor
city:
type: string
example: Cambridge
state:
description: 'ISO 3166-2: Second part. Example for US-MA - MA.'
type: string
minLength: 2
maxLength: 2
pattern: \w{2,2}
example: MA
zipCode:
type: string
pattern: (^\d{5}$)|(^\d{5}-\d{4}$)
example: '02142'
country:
description: ISO 3166-1 alpha-2
type: string
minLength: 2
maxLength: 2
pattern: \w{2,2}
default: US
example: US
PunchoutOrderPart:
type: object
required:
- orderItemId
- partId
- quantity
- price
- partName
- partNumber
- partstechCatalogURL
- availability
- bundled
- brand
properties:
orderItemId:
type: string
example: 0ze4f01824764a61991b9d090fdc1813
description: The unique identifier for an item added to a cart. This ID allows PartsTech to reference a specific item in a specific session and its cart details (e.g. PO number, supplier notes, delivery method).
partId:
type: string
example: ABCD-12345
description: PartsTech's ID for a part. Consists of `brandId`-`partNumber`.
lineCardId:
type:
- string
- 'null'
example: 123
description: PartsTech's ID for a line code. Makes part selection much more accurate when provided in requests to create a cart or search the PartsTech Catalog.
quantity:
type: integer
example: 2
description: The requested quantity for a part.
price:
$ref: '#/components/schemas/PartPrice'
partName:
type: string
example: Motorcraft Engine Oil Filter
description: The name of the part. Part name is typically the brand name + the part type name. For tires it is typically the brand name + model. There is a shop setting that can be enabled to remove the brand name from this field for all parts (tires excluded).
partNumber:
type: string
example: 12345
description: The manufacturer part number.
variationId:
type:
- string
- 'null'
deprecated: true
imageUrl:
type:
- string
- 'null'
format: url
description: The URL of the part image that PartsTech uses for the part.
example: https://image.partstech.com/d1/images/e4/11/71/w110_e411711499973c7640e852e84ed20fca0cd5c9d2.png
partstechCatalogURL:
type: string
format: url
description: The URL of the part's description on PartsTech.
example: https://punchout.partstech.com/Motorcraft-Engine-Oil-Filter/details/BBRH-FL-500-S?part_term=5340
availability:
type: boolean
example: true
description: Returns true if the part is available at the time of quoting.
backOrder:
type: boolean
example: true
description: Returns true if the requested quantity is more than the available quantity and the remaining quantity will be back ordered.
bundled:
type: boolean
example: true
description: Returns true if the part is included in a bundled deal with one or more other parts in the order.
vehicleId:
type:
- integer
- 'null'
description: PartsTech's ID for a vehicle.
vehicleName:
type:
- string
- 'null'
description: Name of the vehicle selected for fitment during the PartsTech session. Typically consists of year, make, model, and engine.
brand:
$ref: '#/components/schemas/Brand'
taxonomy:
$ref: '#/components/schemas/ResponseTaxonomy'
partCategory:
$ref: '#/components/schemas/PartCategory'
tireSize:
type:
- string
- 'null'
deprecated: true
searchedAsPartNumber:
type:
- string
- 'null'
rewards:
$ref: '#/components/schemas/Rewards'
selectedLaborItems:
type:
- array
- 'null'
description: 'Labor items that were selected by user.
Labor items may be attached to items and cart/punchout session.
Selected labor items are not used (they will not be copied or returned) in next methods:
- [Create Custom Cart](#operation/customCartCreate)
- [Order Custom Cart](#operation/submitItems)
- [Check Custom Cart Availability](#operation/checkItemsAvailability)
'
items:
$ref: '#/components/schemas/PunchoutLaborItem'
storesAvailability:
type:
- array
- 'null'
items:
type: object
minProperties: 2
required:
- quantity
properties:
specificName:
type: string
example: In network
store:
$ref: '#/components/schemas/BriefStore'
quantity:
type: integer
example: 3
main:
type: boolean
example: true
attributes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Attribute'
deliveryNotes:
type: array
items:
$ref: '#/components/schemas/DeliveryNote'
itemizedQuote:
$ref: '#/components/schemas/ItemizedItemQuote'
User:
type: object
required:
- username
- email
- enabled
- lastLogin
- allowOrderEmails
- firstName
- lastName
- demo
properties:
username:
type: string
example: mechanic
email:
type: string
example: iron-man@gmail.com
enabled:
type: boolean
example: true
description: Shows if user is activated.
lastLogin:
type:
- string
- 'null'
format: date-time
description: Shows date and time of last user login. ISO 8601/RFC 3339,
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/partstech/refs/heads/main/openapi/partstech-callback-cart-api-openapi.yml