> ## Documentation Index
> Fetch the complete documentation index at: https://docs.campfire.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Search Products

> Resolve many product cells in a single request. Each term is matched against product_id, display_name, product_uuid, id, then product_name, in that order. A term matching more than one product is returned in the ambiguous list instead of being resolved.



## OpenAPI

````yaml https://api.meetcampfire.com/api/schema?format=json post /rr/api/v1/product/bulk-search
openapi: 3.0.3
info:
  title: Campfire Developer APIs
  version: 1.0.0
  description: >
    ## Introduction

    Campfire's developer APIs offer granular access to Campfire's core
    accounting,

    revenue recognition, and financial data features.


    These APIs are designed to be used by developers to build custom
    integrations,

    automate workflows, and perform any other programmatic operations.


    ## Rate limits

    API users can make up to **5 requests per second**. This limit is shared
    across

    all endpoints for the same API user. Requests that exceed the limit receive
    a

    `429 Too Many Requests` response. Wait for the number of seconds specified
    in

    the `Retry-After` response header before retrying.
servers:
  - url: https://api.meetcampfire.com
    description: Production server
security: []
tags:
  - name: Cash Management
    description: Operations related to accounts, transactions, and other bank-related data.
  - name: Core Accounting
    description: >-
      Operations related to core accounting data, such as the chart of accounts,
      entity management, and the general ledger.
  - name: Revenue Recognition
    description: >-
      Operations related to revenue recognition, contract management, and
      contract data aggregation.
  - name: Accounts Receivable
    description: Operations related to invoicing and the AR subledger
  - name: Accounts Payable
    description: Operations related to billing and the AP subledger.
  - name: Financial Statements
    description: Operations related to financial statement generation and data aggregation.
  - name: Settings
    description: Operations related to system and accounting settings configuration.
paths:
  /rr/api/v1/product/bulk-search:
    post:
      tags:
        - Revenue Recognition
        - Accounts Receivable
      summary: Bulk Search Products
      description: >-
        Resolve many product cells in a single request. Each term is matched
        against product_id, display_name, product_uuid, id, then product_name,
        in that order. A term matching more than one product is returned in the
        ambiguous list instead of being resolved.
      operationId: rr_api_v1_product_bulk_search_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkProductSearch'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/BulkProductSearch'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/BulkProductSearch'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkProductSearchResponse'
          description: ''
components:
  schemas:
    BulkProductSearch:
      type: object
      properties:
        products:
          type: array
          items:
            type: string
          maxItems: 10000
          minItems: 1
      required:
        - products
    BulkProductSearchResponse:
      type: object
      description: >-
        Resolved products keyed by the term that matched them, plus the terms
        that matched several.
      properties:
        results:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ProductSearchResult'
        ambiguous:
          type: array
          items:
            $ref: '#/components/schemas/AmbiguousProductTerm'
      required:
        - ambiguous
        - results
    ProductSearchResult:
      type: object
      description: Lookup-only product shape used by bulk search.
      properties:
        id:
          type: integer
          readOnly: true
        product_id:
          type: string
          nullable: true
          maxLength: 250
        product_name:
          type: string
          nullable: true
          maxLength: 250
        display_name:
          type: string
          nullable: true
          maxLength: 550
        product_uuid:
          type: string
          format: uuid
      required:
        - id
    AmbiguousProductTerm:
      type: object
      properties:
        term:
          type: string
        match_count:
          type: integer
      required:
        - match_count
        - term

````