FinditParts

FinditParts Reseller Customer Sessions API

Hosted USER_SETUP and NEW_ORDER sessions returned as a finditparts.com redirect_url for iframe embedding or redirect.

GitHub OpenAPI

Operations 3

GET /reseller_customer_sessions/{reseller_customer_session_id} Get Reseller Customer Session #
DELETE /reseller_customer_sessions/{reseller_customer_session_id} Cancels Reseller Customer Session Intent #
POST /reseller_customer_sessions Create Reseller Customer Session #

Documentation

📖
Documentation
https://api-docs.finditparts.com/
📖
APIReference
https://api-docs.finditparts.com/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/authentication/finditparts-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/openapi/finditparts-reseller-customer-sessions-api-openapi.yml

Other Resources

🔗
Postman
https://documenter.getpostman.com/view/12847304/TVReeWcY
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/errors/finditparts-error-codes.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/examples/_index.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/mcp/finditparts-tool-crosswalk.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/finditparts/refs/heads/main/data-model/finditparts-data-model.yml

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-reseller-customer-sessions-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

finditparts-reseller-customer-sessions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: FinditParts Reseller Reseller Customer Sessions 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: Reseller Customer Sessions
  description: Hosted USER_SETUP and NEW_ORDER sessions returned as a finditparts.com redirect_url for iframe embedding or redirect.
paths:
  /reseller_customer_sessions/{reseller_customer_session_id}:
    get:
      operationId: getResellerCustomerSession
      summary: Get Reseller Customer Session
      tags:
      - Reseller Customer Sessions
      description: Returns status and details of a session. For NEW_ORDER intent sessions, this will also return the order details including status and shipments. Use a Generic JWT token (no customer reference).
      parameters:
      - name: reseller_customer_session_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Reseller Customer Session Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reseller_customer_session:
                    type: object
                    properties:
                      intent:
                        type: string
                        examples:
                        - user_setup
                      id:
                        type: string
                      redirect_url:
                        type: string
                      resolution:
                        type: string
                        examples:
                        - pending
                      order:
                        type: object
                        properties:
                          number:
                            type: string
                          state:
                            type: string
                            examples:
                            - returned
                          total:
                            type: string
                          items_total:
                            type: string
                          po_number:
                            type: string
                          customer_reference:
                            type: string
                          user_id:
                            type: string
                          shipping_method_name:
                            type: string
                          shipping_method_id:
                            type: string
                          shipping_carrier_type:
                            type: string
                          shipping_address:
                            type: object
                            properties:
                              id:
                                type: integer
                              first_name:
                                type: string
                              last_name:
                                type: string
                              country_id:
                                type: integer
                              country_iso:
                                type: string
                              address1:
                                type: string
                              state_id:
                                type: integer
                              state_name:
                                type: string
                              city_name:
                                type: string
                              zipcode:
                                type: string
                              phone:
                                type: string
                              address_type:
                                type: string
                                examples:
                                - residential
                              address2:
                                type: string
                              company:
                                type: string
                              is_default:
                                type: boolean
                          billing_address:
                            type: object
                            properties:
                              id:
                                type: integer
                              first_name:
                                type: string
                              last_name:
                                type: string
                              country_id:
                                type: integer
                              country_iso:
                                type: string
                              address1:
                                type: string
                              state_id:
                                type: integer
                              state_name:
                                type: string
                              city_name:
                                type: string
                              zipcode:
                                type: string
                              phone:
                                type: string
                              address_type:
                                type: string
                                examples:
                                - residential
                              address2:
                                type: string
                              company:
                                type: string
                              is_default:
                                type: boolean
                          completed_at:
                            type: string
                          url:
                            type: string
                          line_items:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: integer
                                quantity:
                                  type: integer
                                amount:
                                  type: number
                                  format: float
                                manufacturer:
                                  type: string
                                part_number:
                                  type: string
                                pack_qty:
                                  type: number
                                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
                                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
                                variant_id:
                                  type: integer
                                product_id:
                                  type: integer
                          adjustments:
                            type: array
                            items:
                              type: object
                              properties:
                                label:
                                  type: string
                                amount:
                                  type: number
                                  format: float
                          shipments:
                            type: array
                            items:
                              type: object
                              properties:
                                carrier:
                                  type: string
                                is_shipped:
                                  type: boolean
                                is_delivered:
                                  type: boolean
                                has_tracking:
                                  type: boolean
                                shipping_method:
                                  type: string
                                tracking_number:
                                  type: string
                          payments:
                            type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                amount:
                                  type: number
                                  format: float
                      expires_at:
                        type: string
                      customer_reference:
                        type: string
                  errno:
                    type: integer
              example:
                reseller_customer_session:
                  intent: user_setup
                  id: <string>
                  redirect_url: <string>
                  resolution: pending
                  order:
                    number: <string>
                    state: returned
                    total: <string>
                    items_total: <string>
                    po_number: <string>
                    customer_reference: <string>
                    user_id: <string>
                    shipping_method_name: <string>
                    shipping_method_id: <string>
                    shipping_carrier_type: <string>
                    shipping_address:
                      id: <integer>
                      first_name: <string>
                      last_name: <string>
                      country_id: <integer>
                      country_iso: <string>
                      address1: <string>
                      state_id: <integer>
                      state_name: <string>
                      city_name: <string>
                      zipcode: <string>
                      phone: <string>
                      address_type: residential
                      address2: <string>
                      company: <string>
                      is_default: <boolean>
                    billing_address:
                      id: <integer>
                      first_name: <string>
                      last_name: <string>
                      country_id: <integer>
                      country_iso: <string>
                      address1: <string>
                      state_id: <integer>
                      state_name: <string>
                      city_name: <string>
                      zipcode: <string>
                      phone: <string>
                      address_type: residential
                      address2: <string>
                      company: <string>
                      is_default: <boolean>
                    completed_at: <string>
                    url: <string>
                    line_items:
                    - id: <integer>
                      quantity: <integer>
                      amount: <float>
                      manufacturer: <string>
                      part_number: <string>
                      pack_qty: <number>
                      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>
                      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>
                      variant_id: <integer>
                      product_id: <integer>
                    - id: <integer>
                      quantity: <integer>
                      amount: <float>
                      manufacturer: <string>
                      part_number: <string>
                      pack_qty: <number>
                      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>
                      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>
                      variant_id: <integer>
                      product_id: <integer>
                    adjustments:
                    - label: <string>
                      amount: <float>
                    - label: <string>
                      amount: <float>
                    shipments:
                    - carrier: <string>
                      is_shipped: <boolean>
                      is_delivered: <boolean>
                      has_tracking: <boolean>
                      shipping_method: <string>
                      tracking_number: <string>
                    - carrier: <string>
                      is_shipped: <boolean>
                      is_delivered: <boolean>
                      has_tracking: <boolean>
                      shipping_method: <string>
                      tracking_number: <string>
                    payments:
                    - type: <string>
                      amount: <float>
                    - type: <string>
                      amount: <float>
                  expires_at: <string>
                  customer_reference: <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/reseller_customer_sessions/:reseller_customer_session_id
    delete:
      operationId: cancelResellerCustomerSession
      summary: Cancels Reseller Customer Session Intent
      tags:
      - Reseller Customer Sessions
      description: Returns new order status or user status depending on intent. For NEW_ORDER intent sessions, this request will attempt to cancel an order that was submitted or return an error if unable to cancel. Use a Generic JWT token (no customer reference).
      parameters:
      - name: reseller_customer_session_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Delete Reseller Customer Session Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reseller_customer_session:
                    type: object
                    properties:
                      intent:
                        type: string
                        examples:
                        - user_setup
                      id:
                        type: string
                      redirect_url:
                        type: string
                      resolution:
                        type: string
                        examples:
                        - pending
                      order:
                        type: object
                        properties:
                          number:
                            type: string
                          state:
                            type: string
                            examples:
                            - returned
                          total:
                            type: string
                          items_total:
                            type: string
                          po_number:
                            type: string
                          customer_reference:
                            type: string
                          user_id:
                            type: string
                          shipping_method_name:
                            type: string
                          shipping_method_id:
                            type: string
                          shipping_carrier_type:
                            type: string
                          shipping_address:
                            type: object
                            properties:
                              id:
                                type: integer
                              first_name:
                                type: string
                              last_name:
                                type: string
                              country_id:
                                type: integer
                              country_iso:
                                type: string
                              address1:
                                type: string
                              state_id:
                                type: integer
                              state_name:
                                type: string
                              city_name:
                                type: string
                              zipcode:
                                type: string
                              phone:
                                type: string
                              address_type:
                                type: string
                                examples:
                                - residential
                              address2:
                                type: string
                              company:
                                type: string
                              is_default:
                                type: boolean
                          billing_address:
                            type: object
                            properties:
                              id:
                                type: integer
                              first_name:
                                type: string
                              last_name:
                                type: string
                              country_id:
                                type: integer
                              country_iso:
                                type: string
                              address1:
                                type: string
                              state_id:
                                type: integer
                              state_name:
                                type: string
                              city_name:
                                type: string
                              zipcode:
                                type: string
                              phone:
                                type: string
                              address_type:
                                type: string
                                examples:
                                - residential
                              address2:
                                type: string
                              company:
                                type: string
                              is_default:
                                type: boolean
                          completed_at:
                            type: string
                          url:
                            type: string
                          line_items:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: integer
                                quantity:
                                  type: integer
                                amount:
                                  type: number
                                  format: float
                                manufacturer:
                                  type: string
                                part_number:
                                  type: string
                                pack_qty:
                                  type: number
                                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
                                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
                                variant_id:
                                  type: integer
                                product_id:
               

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