Skip to main content
POST
Facility Search
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.
Filter results by assessment module type. See the AssessmentRfiPid enum in the API playground for the full list of supported values.
Filter results by assessment status. See the AssessmentStatus enum in the API playground for the full list of supported values.

Request body properties

Response body properties

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).

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 or updating purchase orders.
Refer to the PIC Data Dictionary for more information on PIC fields.

Authorizations

x-api-key
string
header
required
x-developer-request-token
string
header
required

Body

application/json
femIds
string[] | null
moduleType
enum<string>

This interface was referenced by Exports's JSON-Schema via the definition "assessmentRfiPid".

Available options:
fem2017,
fem2018,
fem2019,
fem2020,
fem2021,
fem2022,
fem2023,
fem2024,
fem2025,
fem2026,
fslm,
brm2019,
brm2020,
brm2021,
brm2022,
brm2023,
brm2024,
brm2025,
dct,
one2022,
ffc
status
enum<string>

This interface was referenced by Exports's JSON-Schema via the definition "assessmentStatus".

Available options:
NS,
ASI,
ASC,
VRP,
VRQ,
VRE,
VRC,
VRD,
VRF,
VRI,
ASD

Response

200 - application/json

Ok

API Search responses

from
number<double>
required
size
number<double>
required
total
number<double>
required
results
object[]
required