FinditParts

FinditParts Orders API

Order listing, search and detail for a user-specific session.

GitHub OpenAPI

Operations 3

GET /orders/search Search Orders #
GET /orders/{order_id} Order Details #
GET /orders List Orders #

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-orders-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-orders-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-orders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: FinditParts Reseller Orders 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: Orders
  description: Order listing, search and detail for a user-specific session.
paths:
  /orders/search:
    get:
      operationId: searchOrders
      summary: Search Orders
      tags:
      - Orders
      description: 'Returns a list of the users orders filtered by search parameters.


        Requires a user specific JWT in the Authorization header.'
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      - name: start_date
        in: query
        required: false
        schema:
          type: string
      - name: end_date
        in: query
        required: false
        schema:
          type: string
      - name: sort_field
        in: query
        required: false
        schema:
          type: string
          examples:
          - currently_assigned_to_id
      - name: sort_direction
        in: query
        required: false
        schema:
          type: string
          examples:
          - asc
      - name: page
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Search Orders Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  errno:
                    type: integer
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        number:
                          type: string
                        state:
                          type: string
                          examples:
                          - delivered
                        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
                  pagination:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      per_page:
                        type: integer
                      total_count:
                        type: integer
              example:
                errno: <integer>
                orders:
                - number: <string>
                  state: delivered
                  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>
                - number: <string>
                  state: delivered
                  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: commercial
                    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>
                pagination:
                  current_page: <integer>
                  per_page: <integer>
                  total_count: <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/orders/search?q=<string>&start_date=<string>&end_date=<string>&sort_field=currently_assigned_to_id&sort_direction=asc&page=<string>
  /orders/{order_id}:
    get:
      operationId: getOrder
      summary: Order Details
      tags:
      - Orders
      description: 'Returns the Order Details


        Requires a user specific JWT in the Authorization header.'
      parameters:
      - name: order_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Order Details Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  order:
                    type: object
                    properties:
                      number:
                        type: string
                      state:
                        type: string
                        examples:
                        - processing
                      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:
                            - commercial
                          address2:
                            type: string
                          company:
                            type: string
                          is_default:
                            type: boolean
                  

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