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 /// 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: manufacturer: part_number: short_description: long_description: sellable: product_url: product_images: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: condition: breadcrumb_ancestors: id: name: permalink: is_hidden: current_variant: variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: preferred_variant_id: variants: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: recommendations_url: product_review_count: product_review_rating: manufacturer_image: msrp: purchase_notes: - type: SPECIAL_ORDER html_message: - type: SHIPPING_CUTOFF html_message: product_reviews: - title: rating: summary: - title: rating: summary: pies_data: descriptions: - title: description_code: value: language_code: sequence: - title: description_code: value: language_code: sequence: part_interchanges: - brand_label: part_number: brand_aaiaid: - brand_label: part_number: brand_aaiaid: product_attributes: - name: value: - name: value: extended_product_informations: - description: value: expi_code: language_code: - description: value: expi_code: language_code: errno: '500': description: API error content: application/json: schema: type: object properties: errno: type: integer message: type: string example: errno: message: x-postman-request: https://finditparts.com/api/v1/products/:product_id?include_pies_data= /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: manufacturer: part_number: short_description: long_description: sellable: product_url: product_images: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: condition: breadcrumb_ancestors: id: name: permalink: is_hidden: current_variant: variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: preferred_variant_id: variants: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: recommendations_url: product_review_count: product_review_rating: manufacturer_image: msrp: purchase_notes: - type: SPECIAL_ORDER html_message: - type: RETURNS html_message: product_reviews: - title: rating: summary: - title: rating: summary: pies_data: descriptions: - title: description_code: value: language_code: sequence: - title: description_code: value: language_code: sequence: part_interchanges: - brand_label: part_number: brand_aaiaid: - brand_label: part_number: brand_aaiaid: product_attributes: - name: value: - name: value: extended_product_informations: - description: value: expi_code: language_code: - description: value: expi_code: language_code: - id: manufacturer: part_number: short_description: long_description: sellable: product_url: product_images: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: condition: breadcrumb_ancestors: id: name: permalink: is_hidden: current_variant: variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: preferred_variant_id: variants: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: - variant_id: price: quantity: pack_quantity: minimum: verified: location: timezone: cutoff: past_cutoff: core_price: estimated_business_days_to_ship: estimated_ship_date: estimated_days_to_deliver: estimated_delivery_date_ground: account_price: minimum_order: minimum_order_fee: recommendations_url: product_review_count: product_review_rating: manufacturer_image: msrp: purchase_notes: - type: NA_CA html_message: - type: SHIPPING_PROMISE html_message: product_reviews: - title: rating: summary: - title: rating: summary: pies_data: descriptions: - title: description_code: value: language_code: sequence: - title: description_code: value: language_code: sequence: part_interchanges: - brand_label: part_number: brand_aaiaid: - brand_label: part_number: brand_aaiaid: product_attributes: - name: value: - name: value: extended_product_informations: - description: value: expi_code: language_code: - description: value: expi_code: language_code: errno: '500': description: API error content: application/json: schema: type: object properties: errno: type: integer message: type: string example: errno: message: x-postman-request: https://finditparts.com/api/v1/products/:product_ids/multi /products/lookup: get: operationId: lookupProductByPartNumber summary: Lookup Product by Part Number tags: - Products description: 'Returns the Product Details for each Product that exactly matches the part number provided. Results are split by part number exact matches and cross reference exact matches. 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: part_number in: query required: false schema: type: string responses: '200': description: Product Lookup Response content: application/json: schema: type: object properties: part_number_matches: 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: - SHIPPING_MESSAGE 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 cross_reference_matches: 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: - SHIPPING_MESSAGE 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: part_number_matches: - id: manufacturer: part_number: short_description: long_description: sellable: product_url: product_images: - product: jpeg: webp: large: jpeg: webp: small: jpeg: webp: medium: jpeg: webp: - product: jpeg: webp: large: jpeg: