FinditParts

FinditParts Products API

Part search, part-number lookup and product/variant detail across the FinditParts catalog.

Documentation GitHub OpenAPI

Operations 4

GET /products/{product_id} Product Details #

GET /products/{product_ids}/multi Product Details Multi #

GET /products/lookup Lookup Product by Part Number #

GET /products Product Search #

Work with this as data

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/finditparts-products-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 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: FinditParts Reseller Products API
  version: 2.0.1
  description: 'REST surface of the FinditParts Reseller API — the partner/reseller integration for FinditParts, an online marketplace for heavy-duty truck, trailer, fleet and industrial replacement parts. It covers catalog search and part-number lookup, variant pricing and availability, shipping-method quoting, hosted customer setup and order sessions, cart/checkout, and order history.


    DERIVED, NOT PUBLISHED BY THE PROVIDER. FinditParts publishes no OpenAPI document. This spec was mechanically derived by API Evangelist from the first-party public Postman collection "FinditParts Reseller API 2.0.1", published by FinditParts at https://api-docs.finditparts.com/ and saved verbatim in this repo at postman/finditparts-reseller-api-postman.json. Every path, method, parameter, request body, example response and description below is carried over from that collection; nothing was invented. Response schemas are derived from the collection''s example payloads, whose <string>/<integer>/<boolean>/<float> placeholders are Postman''s rendering of the provider''s own declared types. Each operation records its original collection URL template in x-postman-request.


    Authentication is a short-lived HS256 JWT signed with the Reseller Client Secret (iss = Reseller Client ID, exp required, sub = Customer Reference when acting on behalf of a customer), or an issued API key of the form api-XYZ123 — both presented as an Authorization: Bearer credential. See authentication/finditparts-authentication.yml.'
  contact:
    name: FinditParts Support
    email: support@finditparts.com
    url: https://www.finditparts.com/developers
  termsOfService: https://www.finditparts.com/terms-of-use
  x-generated-by: API Evangelist enrichment pipeline (derived from first-party Postman collection)
  x-source: postman/finditparts-reseller-api-postman.json
  x-source-url: https://api-docs.finditparts.com/
servers:
- url: https://finditparts.com/api/v1
  description: Production. This is the baseUrl collection variable published in the FinditParts Reseller API Postman collection; FinditParts documents no separate sandbox host.
security:
- resellerJWT: []
- apiKey: []
tags:
- name: Products
  description: Part search, part-number lookup and product/variant detail across the FinditParts catalog.
paths:
  /products/{product_id}:
    get:
      operationId: getProduct
      summary: Product Details
      tags:
      - Products
      description: 'Returns the Product Details


        Requires a generic JWT in the Authorization header.


        Use a customer referenced JWT to return account specific pricing or a Generic JWT token (no customer reference) to return list price.'
      parameters:
      - name: include_pies_data
        in: query
        required: false
        schema:
          type: boolean
      - name: product_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: 'Product Details Response: Details for a given Product'
          content:
            application/json:
              schema:
                type: object
                properties:
                  product:
                    type: object
                    properties:
                      id:
                        type: integer
                      manufacturer:
                        type: string
                      part_number:
                        type: string
                      short_description:
                        type: string
                      long_description:
                        type: string
                      sellable:
                        type: boolean
                      product_url:
                        type: string
                      product_images:
                        type: array
                        items:
                          type: object
                          properties:
                            product:
                              type: object
                              properties:
                                jpeg:
                                  type: string
                                webp:
                                  type: string
                            large:
                              type: object
                              properties:
                                jpeg:
                                  type: string
                                webp:
                                  type: string
                            small:
                              type: object
                              properties:
                                jpeg:
                                  type: string
                                webp:
                                  type: string
                            medium:
                              type: object
                              properties:
                                jpeg:
                                  type: string
                                webp:
                                  type: string
                      condition:
                        type: string
                      breadcrumb_ancestors:
                        type: object
                        properties:
                          id:
                            type: integer
                          name:
                            type: string
                          permalink:
                            type: string
                          is_hidden:
                            type: boolean
                      current_variant:
                        type: object
                        properties:
                          variant_id:
                            type: integer
                          price:
                            type: string
                          quantity:
                            type: integer
                          pack_quantity:
                            type: integer
                          minimum:
                            type: integer
                          verified:
                            type: boolean
                          location:
                            type: string
                          timezone:
                            type: string
                          cutoff:
                            type: string
                            format: date-time
                          past_cutoff:
                            type: boolean
                          core_price:
                            type: string
                          estimated_business_days_to_ship:
                            type: integer
                          estimated_ship_date:
                            type: string
                            format: date-time
                          estimated_days_to_deliver:
                            type: integer
                          estimated_delivery_date_ground:
                            type: string
                            format: date-time
                          account_price:
                            type: string
                          minimum_order:
                            type: string
                          minimum_order_fee:
                            type: string
                      preferred_variant_id:
                        type: integer
                      variants:
                        type: array
                        items:
                          type: object
                          properties:
                            variant_id:
                              type: integer
                            price:
                              type: string
                            quantity:
                              type: integer
                            pack_quantity:
                              type: integer
                            minimum:
                              type: integer
                            verified:
                              type: boolean
                            location:
                              type: string
                            timezone:
                              type: string
                            cutoff:
                              type: string
                              format: date-time
                            past_cutoff:
                              type: boolean
                            core_price:
                              type: string
                            estimated_business_days_to_ship:
                              type: integer
                            estimated_ship_date:
                              type: string
                              format: date-time
                            estimated_days_to_deliver:
                              type: integer
                            estimated_delivery_date_ground:
                              type: string
                              format: date-time
                            account_price:
                              type: string
                            minimum_order:
                              type: string
                            minimum_order_fee:
                              type: string
                      recommendations_url:
                        type: string
                      product_review_count:
                        type: integer
                      product_review_rating:
                        type: number
                        format: float
                      manufacturer_image:
                        type: string
                      msrp:
                        type: number
                        format: float
                      purchase_notes:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              examples:
                              - SPECIAL_ORDER
                            html_message:
                              type: string
                      product_reviews:
                        type: array
                        items:
                          type: object
                          properties:
                            title:
                              type: string
                            rating:
                              type: integer
                            summary:
                              type: string
                      pies_data:
                        type: object
                        properties:
                          descriptions:
                            type: array
                            items:
                              type: object
                              properties:
                                title:
                                  type: string
                                description_code:
                                  type: string
                                value:
                                  type: string
                                language_code:
                                  type: string
                                sequence:
                                  type: integer
                          part_interchanges:
                            type: array
                            items:
                              type: object
                              properties:
                                brand_label:
                                  type: string
                                part_number:
                                  type: string
                                brand_aaiaid:
                                  type: string
                          product_attributes:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                value:
                                  type: string
                          extended_product_informations:
                            type: array
                            items:
                              type: object
                              properties:
                                description:
                                  type: string
                                value:
                                  type: string
                                expi_code:
                                  type: string
                                language_code:
                                  type: string
                  errno:
                    type: integer
              example:
                product:
                  id: <integer>
                  manufacturer: <string>
                  part_number: <string>
                  short_description: <string>
                  long_description: <string>
                  sellable: <boolean>
                  product_url: <string>
                  product_images:
                  - product:
                      jpeg: <string>
                      webp: <string>
                    large:
                      jpeg: <string>
                      webp: <string>
                    small:
                      jpeg: <string>
                      webp: <string>
                    medium:
                      jpeg: <string>
                      webp: <string>
                  - product:
                      jpeg: <string>
                      webp: <string>
                    large:
                      jpeg: <string>
                      webp: <string>
                    small:
                      jpeg: <string>
                      webp: <string>
                    medium:
                      jpeg: <string>
                      webp: <string>
                  condition: <string>
                  breadcrumb_ancestors:
                    id: <integer>
                    name: <string>
                    permalink: <string>
                    is_hidden: <boolean>
                  current_variant:
                    variant_id: <integer>
                    price: <string>
                    quantity: <integer>
                    pack_quantity: <integer>
                    minimum: <integer>
                    verified: <boolean>
                    location: <string>
                    timezone: <string>
                    cutoff: <dateTime>
                    past_cutoff: <boolean>
                    core_price: <string>
                    estimated_business_days_to_ship: <integer>
                    estimated_ship_date: <dateTime>
                    estimated_days_to_deliver: <integer>
                    estimated_delivery_date_ground: <dateTime>
                    account_price: <string>
                    minimum_order: <string>
                    minimum_order_fee: <string>
                  preferred_variant_id: <integer>
                  variants:
                  - variant_id: <integer>
                    price: <string>
                    quantity: <integer>
                    pack_quantity: <integer>
                    minimum: <integer>
                    verified: <boolean>
                    location: <string>
                    timezone: <string>
                    cutoff: <dateTime>
                    past_cutoff: <boolean>
                    core_price: <string>
                    estimated_business_days_to_ship: <integer>
                    estimated_ship_date: <dateTime>
                    estimated_days_to_deliver: <integer>
                    estimated_delivery_date_ground: <dateTime>
                    account_price: <string>
                    minimum_order: <string>
                    minimum_order_fee: <string>
                  - variant_id: <integer>
                    price: <string>
                    quantity: <integer>
                    pack_quantity: <integer>
                    minimum: <integer>
                    verified: <boolean>
                    location: <string>
                    timezone: <string>
                    cutoff: <dateTime>
                    past_cutoff: <boolean>
                    core_price: <string>
                    estimated_business_days_to_ship: <integer>
                    estimated_ship_date: <dateTime>
                    estimated_days_to_deliver: <integer>
                    estimated_delivery_date_ground: <dateTime>
                    account_price: <string>
                    minimum_order: <string>
                    minimum_order_fee: <string>
                  recommendations_url: <string>
                  product_review_count: <integer>
                  product_review_rating: <float>
                  manufacturer_image: <string>
                  msrp: <float>
                  purchase_notes:
                  - type: SPECIAL_ORDER
                    html_message: <string>
                  - type: SHIPPING_CUTOFF
                    html_message: <string>
                  product_reviews:
                  - title: <string>
                    rating: <integer>
                    summary: <string>
                  - title: <string>
                    rating: <integer>
                    summary: <string>
                  pies_data:
                    descriptions:
                    - title: <string>
                      description_code: <string>
                      value: <string>
                      language_code: <string>
                      sequence: <integer>
                    - title: <string>
                      description_code: <string>
                      value: <string>
                      language_code: <string>
                      sequence: <integer>
                    part_interchanges:
                    - brand_label: <string>
                      part_number: <string>
                      brand_aaiaid: <string>
                    - brand_label: <string>
                      part_number: <string>
                      brand_aaiaid: <string>
                    product_attributes:
                    - name: <string>
                      value: <string>
                    - name: <string>
                      value: <string>
                    extended_product_informations:
                    - description: <string>
                      value: <string>
                      expi_code: <string>
                      language_code: <string>
                    - description: <string>
                      value: <string>
                      expi_code: <string>
                      language_code: <string>
                errno: <integer>
        '500':
          description: API error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errno:
                    type: integer
                  message:
                    type: string
              example:
                errno: <integer>
                message: <string>
      x-postman-request: https://finditparts.com/api/v1/products/:product_id?include_pies_data=<boolean>
  /products/{product_ids}/multi:
    get:
      operationId: getProductsMulti
      summary: Product Details Multi
      tags:
      - Products
      description: 'Returns the Product Details for each comma separated ID.


        Requires a generic JWT in the Authorization header.


        Use a customer referenced JWT to return account specific pricing or a Generic JWT token (no customer reference) to return list price.'
      parameters:
      - name: product_ids
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Product Details Multi Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  products:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                        manufacturer:
                          type: string
                        part_number:
                          type: string
                        short_description:
                          type: string
                        long_description:
                          type: string
                        sellable:
                          type: boolean
                        product_url:
                          type: string
                        product_images:
                          type: array
                          items:
                            type: object
                            properties:
                              product:
                                type: object
                                properties:
                                  jpeg:
                                    type: string
                                  webp:
                                    type: string
                              large:
                                type: object
                                properties:
                                  jpeg:
                                    type: string
                                  webp:
                                    type: string
                              small:
                                type: object
                                properties:
                                  jpeg:
                                    type: string
                                  webp:
                                    type: string
                              medium:
                                type: object
                                properties:
                                  jpeg:
                                    type: string
                                  webp:
                                    type: string
                        condition:
                          type: string
                        breadcrumb_ancestors:
                          type: object
                          properties:
                            id:
                              type: integer
                            name:
                              type: string
                            permalink:
                              type: string
                            is_hidden:
                              type: boolean
                        current_variant:
                          type: object
                          properties:
                            variant_id:
                              type: integer
                            price:
                              type: string
                            quantity:
                              type: integer
                            pack_quantity:
                              type: integer
                            minimum:
                              type: integer
                            verified:
                              type: boolean
                            location:
                              type: string
                            timezone:
                              type: string
                            cutoff:
                              type: string
                              format: date-time
                            past_cutoff:
                              type: boolean
                            core_price:
                              type: string
                            estimated_business_days_to_ship:
                              type: integer
                            estimated_ship_date:
                              type: string
                              format: date-time
                            estimated_days_to_deliver:
                              type: integer
                            estimated_delivery_date_ground:
                              type: string
                              format: date-time
                            account_price:
                              type: string
                            minimum_order:
                              type: string
                            minimum_order_fee:
                              type: string
                        preferred_variant_id:
                          type: integer
                        variants:
                          type: array
                          items:
                            type: object
                            properties:
                              variant_id:
                                type: integer
                              price:
                                type: string
                              quantity:
                                type: integer
                              pack_quantity:
                                type: integer
                              minimum:
                                type: integer
                              verified:
                                type: boolean
                              location:
                                type: string
                              timezone:
                                type: string
                              cutoff:
                                type: string
                                format: date-time
                              past_cutoff:
                                type: boolean
                              core_price:
                                type: string
                              estimated_business_days_to_ship:
                                type: integer
                              estimated_ship_date:
                                type: string
                                format: date-time
                              estimated_days_to_deliver:
                                type: integer
                              estimated_delivery_date_ground:
                                type: string
                                format: date-time
                              account_price:
                                type: string
                              minimum_order:
                                type: string
                              minimum_order_fee:
                                type: string
                        recommendations_url:
                          type: string
                        product_review_count:
                          type: integer
                        product_review_rating:
                          type: number
                          format: float
                        manufacturer_image:
                          type: string
                        msrp:
                          type: number
                          format: float
                        purchase_notes:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                examples:
                                - SPECIAL_ORDER
                              html_message:
                                type: string
                        product_reviews:
                          type: array
                          items:
                            type: object
                            properties:
                              title:
                                type: string
                              rating:
                                type: integer
                              summary:
                                type: string
                        pies_data:
                          type: object
                          properties:
                            descriptions:
                              type: array
                              items:
                                type: object
                                properties:
                                  title:
                                    type: string
                                  description_code:
                                    type: string
                                  value:
                                    type: string
                                  language_code:
                                    type: string
                                  sequence:
                                    type: integer
                            part_interchanges:
                              type: array
                              items:
                                type: object
                                properties:
                                  brand_label:
                                    type: string
                                  part_number:
                                    type: string
                                  brand_aaiaid:
                                    type: string
                            product_attributes:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                  value:
                                    type: string
                            extended_product_informations:
                              type: array
                              items:
                                type: object
                                properties:
                                  description:
                                    type: string
                                  value:
                                    type: string
                                  expi_code:
                                    type: string
                                  language_code:
                                    type: string
                  errno:
                    type: integer
              example:
                products:
                - id: <integer>
                  manufacturer: <string>
                  part_number: <string>
                  short_description: <string>
                  long_description: <string>
                  sellable: <boolean>
                  product_url: <string>
                  product_images:
                  - product:
                      jpeg: <string>
                      webp: <string>
                    large:
                      jpeg: <string>
                      webp: <string>
                    small:
                      jpeg: <string>
                      webp: <string>
                    medium:
                      jpeg: <string>
                      webp: <string>
                  - product:
                      jpeg: <string>
                      webp: <string>
                    large:
                      jpeg: <string>
                      webp: <string>
                    small:
                      jpeg: <string>
                      webp: <string>
                    medium:
                      jpeg: <string>
                      webp: <string>
                  condition: <string>
                  breadcrumb_ancestors:
                    id: <integer>
                    name: <string>
                    permalink: <string>
                    is_hidden: <boolean>
                  current_variant:
                    variant_id: <integer>
                    price: <string>
                    quantity: <integer>
                    pack_quantity: <integer>
                    minimum: <integer>
                    verified: <boolean>
                    location: <string>
                    timezone: <string>
                    cutoff: <dateTime>
                    past_cutoff: <boolean>
                    core_price: <string>
                    estimated_business_days_to_ship: <integer>
                    estimated_ship_date: <dateTime>
                    estimated_days_to_deliver: <integer>
                    estimated_delivery_date_ground: <dateTime>
                    account_price: <string>
                    minimum_order: <string>
                    minimum_order_fee: <string>
 

# --- truncated at 32 KB (109 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/openapi/finditparts-products-api-openapi.yml