> ## 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 Tier 1 facilities

Use this endpoint to search for Tier 1 Final Assembly facilities whose FEM assessments have been shared with your Worldly account. The returned FEM assessment IDs can be linked to purchase orders for more accurate Scope 3 impact calculations.

<Note title="moduleType">
  Filter results by assessment module type. See the `AssessmentRfiPid` enum in the API playground for the full list of supported values.
</Note>

<Note title="status">
  Filter results by assessment status. See the `AssessmentStatus` enum in the API playground for the full list of supported values.
</Note>

### Request body properties

| Name         | Type            | Description                                   |
| :----------- | :-------------- | :-------------------------------------------- |
| `femIds`     | `Array<string>` | Filter by specific FEM assessment IDs.        |
| `moduleType` | `string`        | Assessment module type (e.g. `fem2025`).      |
| `status`     | `string`        | Assessment status (e.g. `ASC` for completed). |

### Response body properties

| Name      | Type                     | Description                                                              |
| :-------- | :----------------------- | :----------------------------------------------------------------------- |
| `from`    | `number`                 | **\[REQUIRED]** Starting index of the results.                           |
| `size`    | `number`                 | **\[REQUIRED]** Number of results returned per page.                     |
| `total`   | `number`                 | **\[REQUIRED]** Total number of facilities matching the search criteria. |
| `results` | `Array<AssemblyLibrary>` | **\[REQUIRED]** List of facilities and their assessment data.            |

### Result item properties

Each entry in `results` is an `AssemblyLibrary` object. The fields below are the common subset most callers consume; refer to the API playground for the complete schema (additional fields include `accountId`, `accountCountry`, `tags`, `customIds`, `verificationPosted`, and impact metric blocks).

| Name          | Type     | Description                                                            |
| :------------ | :------- | :--------------------------------------------------------------------- |
| `femId`       | `string` | **\[REQUIRED]** Unique ID of the FEM assessment.                       |
| `accountName` | `string` | **\[REQUIRED]** Name of the facility's account.                        |
| `country`     | `string` | **\[REQUIRED]** Country where the facility is located.                 |
| `year`        | `number` | **\[REQUIRED]** Assessment year.                                       |
| `status`      | `string` | **\[REQUIRED]** Assessment status code.                                |
| `moduleType`  | `string` | **\[REQUIRED]** The type of assessment module.                         |
| `sacId`       | `number` | **\[REQUIRED]** The Sustainable Apparel Coalition ID for the facility. |
| `oarId`       | `string` | The Open Apparel Registry ID for the facility.                         |

### Implementation details

* **Shared assessments only**: Only FEM assessments that suppliers have shared with your account are returned.
* **Usage**: Use the returned `femId` value in the `purchaseOrder.assembly.femId` field when [creating](/api-reference/pic/purchase-orders/create) or [updating](/api-reference/pic/purchase-orders/update) purchase orders.

Refer to the [PIC Data Dictionary](/data-dictionary/pic) for more information on PIC fields.


## OpenAPI

````yaml api-reference/openapi/french-eco.json POST /supplier/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:
  /supplier/search:
    post:
      summary: Facility Search
      operationId: FacilitySearch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CorpRepApiAssembliesRequest'
        required: true
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CorpReportApiPaginatedResponseAssemblyLibrary
components:
  schemas:
    CorpRepApiAssembliesRequest:
      properties:
        femIds:
          items:
            type: string
          type: array
          nullable: true
        moduleType:
          $ref: '#/components/schemas/AssessmentRfiPid'
        status:
          $ref: '#/components/schemas/AssessmentStatus'
      type: object
      additionalProperties: false
    CorpReportApiPaginatedResponseAssemblyLibrary:
      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/AssemblyLibrary'
          type: array
      required:
        - from
        - results
        - size
        - total
      type: object
      additionalProperties: false
    AssessmentRfiPid:
      description: >-
        This interface was referenced by `Exports`'s JSON-Schema via the
        `definition` "assessmentRfiPid".
      enum:
        - fem2017
        - fem2018
        - fem2019
        - fem2020
        - fem2021
        - fem2022
        - fem2023
        - fem2024
        - fem2025
        - fem2026
        - fslm
        - brm2019
        - brm2020
        - brm2021
        - brm2022
        - brm2023
        - brm2024
        - brm2025
        - dct
        - one2022
        - ffc
      type: string
    AssessmentStatus:
      description: >-
        This interface was referenced by `Exports`'s JSON-Schema via the
        `definition` "assessmentStatus".
      enum:
        - NS
        - ASI
        - ASC
        - VRP
        - VRQ
        - VRE
        - VRC
        - VRD
        - VRF
        - VRI
        - ASD
      type: string
    AssemblyLibrary:
      properties:
        finalAssemblyImpacts:
          type: number
          format: double
          nullable: true
        printingProductDyeingImpacts:
          type: number
          format: double
          nullable: true
        verificationPosted:
          type: boolean
        tags:
          items:
            type: string
          type: array
        annualProdVolUnits:
          type: string
        status:
          $ref: '#/components/schemas/AssessmentStatus'
        year:
          type: number
          format: double
        rfi_pid:
          $ref: '#/components/schemas/AssessmentRfiPid'
        femId:
          type: string
        accountName:
          type: string
        accountId:
          type: string
        accountCountry:
          type: string
        customIds:
          items:
            type: string
          type: array
        totalNormalizedImpacts:
          type: number
          format: double
          nullable: true
        sipfacilitytype:
          items:
            type: string
          type: array
        moduleType:
          type: string
        oarId:
          type: string
          nullable: true
        sacId:
          type: number
          format: double
        country:
          type: string
        surveyVersion:
          type: string
        materialProductionNormalized:
          type: number
          format: double
          nullable: true
        rawMaterialProcessingNormalized:
          type: number
          format: double
          nullable: true
        sipFacilityMaterialProcessTextiles:
          items:
            type: string
          type: array
          nullable: true
        facilityPosted:
          type: boolean
        finishedProductImpacts:
          type: number
          format: double
          nullable: true
      required:
        - accountCountry
        - accountId
        - accountName
        - annualProdVolUnits
        - country
        - customIds
        - facilityPosted
        - femId
        - moduleType
        - rfi_pid
        - sacId
        - sipfacilitytype
        - status
        - surveyVersion
        - tags
        - verificationPosted
        - year
      type: object
      additionalProperties: false
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: x-api-key
    sec1:
      type: apiKey
      in: header
      name: x-developer-request-token

````