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

# Search Higg PM

Use this endpoint to search your Higg Product Module (PM) entries. Product Module objects contain detailed product-level sustainability data and can be referenced when creating PIC products.

### Request body params

| Name   | Type            | Description                                     |
| :----- | :-------------- | :---------------------------------------------- |
| `name` | `string`        | Filter PM entries by name.                      |
| `ids`  | `Array<string>` | Filter by specific PM IDs.                      |
| `from` | `number`        | **\[DEFAULT: 0]** Pagination start index.       |
| `size` | `number`        | **\[DEFAULT: 50]** Number of results to return. |

### Implementation Details

* **Published only**: Only non-draft Product Module entries are returned.
* **Pagination**: Standard pagination using `from` and `size` with a default of 50 results.
* **Additional filters**: The full request schema supports additional filter parameters beyond those listed above (e.g., `certifications`, `productType`, date ranges). See the API playground for the complete schema.


## OpenAPI

````yaml api-reference/openapi/french-eco.json POST /higg-index/pm/search
openapi: 3.0.0
info:
  title: pic-api
  version: 1.0.0
servers:
  - url: https://api-v2.production.higg.org/pic-api/v1
    description: Production
  - url: https://api-v2.demo.higg.org/pic-api/v1
    description: Demo
security:
  - sec0: []
    sec1: []
paths:
  /higg-index/pm/search:
    post:
      summary: Search Pm
      operationId: SearchPm
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CorpRepApiPmSearchRequest'
        required: true
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CorpReportApiPaginatedResponseScope3PmEntityResult
components:
  schemas:
    CorpRepApiPmSearchRequest:
      description: MSI & PM Search requests
      properties:
        ids:
          items:
            type: string
          type: array
          nullable: true
        accountId:
          type: string
          nullable: true
        certifications:
          items:
            type: string
          type: array
          nullable: true
        claimsStatus:
          type: string
          nullable: true
        claimsLevel:
          type: number
          format: double
          nullable: true
        claimsExpires:
          type: string
          nullable: true
        higgId:
          type: number
          format: double
          nullable: true
        name:
          type: string
          nullable: true
        productStyleNumber:
          type: string
          nullable: true
        productType:
          $ref: '#/components/schemas/MsiProductType'
        productCategory:
          type: object
          nullable: true
        createdAfter:
          type: string
          format: date-time
          nullable: true
        createdBefore:
          type: string
          format: date-time
          nullable: true
        lastEditedAfter:
          type: string
          format: date-time
          nullable: true
        lastEditedBefore:
          type: string
          format: date-time
          nullable: true
        platformModifiedBy:
          $ref: '#/components/schemas/PlatformDefault'
        platformCreatedBy:
          $ref: '#/components/schemas/PlatformDefault'
        productLastEditedBefore:
          type: string
          format: date-time
          nullable: true
        productLastEditedAfter:
          type: string
          format: date-time
          nullable: true
        submittedBefore:
          type: string
          format: date-time
          nullable: true
        submittedAfter:
          type: string
          format: date-time
          nullable: true
        barcodes:
          items:
            type: string
          type: array
          nullable: true
        claimType:
          $ref: '#/components/schemas/MsiProductClaimsType'
        from:
          type: number
          format: double
          nullable: true
        size:
          type: number
          format: double
          nullable: true
      type: object
      additionalProperties: false
    CorpReportApiPaginatedResponseScope3PmEntityResult:
      description: API Search responses
      properties:
        from:
          type: number
          format: double
        size:
          type: number
          format: double
        total:
          type: number
          format: double
        results:
          items:
            $ref: '#/components/schemas/Scope3PmEntityResult'
          type: array
      required:
        - from
        - results
        - size
        - total
      type: object
      additionalProperties: false
    MsiProductType:
      enum:
        - Apparel
        - Footwear
        - HomeTextiles
        - Other
      type: string
    PlatformDefault:
      enum:
        - User
        - Api
      type: string
    MsiProductClaimsType:
      enum:
        - Materials
        - Disclosure
      type: string
    Scope3PmEntityResult:
      description: MSI & PM Search return objects
      properties:
        _id:
          type: string
        created_on:
          type: number
          format: double
        last_edit:
          type: number
          format: double
          nullable: true
        name:
          type: string
        modelNumber:
          type: string
          nullable: true
        productType:
          $ref: '#/components/schemas/MsiProductType'
        productCategory:
          type: object
        platformModifiedBy:
          $ref: '#/components/schemas/PlatformDefault'
        platformCreatedBy:
          $ref: '#/components/schemas/PlatformDefault'
        barcodes:
          items:
            type: string
          type: array
          nullable: true
        userEmail:
          type: string
        draft:
          type: boolean
        grossWeight:
          type: number
          format: double
        productNetWeight:
          type: number
          format: double
          nullable: true
        bomNetWeight:
          type: number
          format: double
          nullable: true
      required:
        - _id
        - created_on
        - draft
        - grossWeight
        - name
        - productCategory
        - productType
        - userEmail
      type: object
      additionalProperties: false
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: x-api-key
    sec1:
      type: apiKey
      in: header
      name: x-developer-request-token

````