FinditParts Reseller API

openapi: 3.1.0
info:
  title: FinditParts Reseller 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.
tags:
- name: Products
  description: Part search, part-number lookup and product/variant detail across the FinditParts catalog.
- name: Variants
  description: Variant-level price, quantity, cutoff and core lookups.
- name: Shipping
  description: Shipping method quoting and estimated cost for a proposed set of line items and an address.
- name: Reseller Customer Sessions
  description: Hosted USER_SETUP and NEW_ORDER sessions returned as a finditparts.com redirect_url for iframe embedding or
    redirect.
- name: Sessions
  description: User-specific JWT session creation, refresh, inspection and destruction.
- name: Reseller Customers
  description: Sub-users created on a reseller master account and addressed by customer_reference.
- name: Users
  description: Direct FinditParts user creation for API-key clients.
- name: Partners
  description: Partner API-key surface for white-label shipping quotes and order placement.
- name: Orders
  description: Order listing, search and detail for a user-specific session.
- name: Addresses
  description: Shipping and billing address book for a user-specific session.
- name: Carts
  description: 'Draft-order (cart) lifecycle: line items, addresses, shipping method, coupon, PO number and checkout.'
security:
- resellerJWT: []
- apiKey: []
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:
               

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