Sign in
latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Suppliers - Management

Bulk fetch detailed target information by target IDs

Fetch detailed information for multiple targets at once, including name, supplier identifiers, and other target details. This endpoint supports both Prewave internal target IDs and foreign system mappings for maximum flexibility.

Required Permission: access_public_target

Performance impact: Medium (depends on batch size)

Use cases:

  • Get target details for multiple suppliers at once
  • Resolve foreign system IDs to Prewave target information
  • Bulk data synchronization and integration

Request format:

  • Use targetIds for Prewave internal target IDs: [101, 102, 103]
  • Use foreignTargets for foreign system mappings: [{"systemId": "customer", "targetId": "SUPPLIER001"}]
  • Both fields are optional, but at least one must be provided

Response format:

  • targets: Successfully fetched targets with full details (same as individual target endpoint)
  • errors: Failed lookups with specific error reasons (NOT_FOUND, ACCESS_DENIED, etc.)

Error handling:

  • Individual target errors are returned in the errors field, not as HTTP errors
  • Empty results are valid (empty targets list)
  • Permission checks are performed per target
post/public/v1/target/targets/bulk-fetch

Request body

targetIdsinteger[] nullable

List of Prewave internal target IDs to fetch

isValidboolean required

Example request

{
  "targetIds": [
    101,
    102,
    103
  ],
  "foreignTargets": [
    {
      "systemId": "customer",
      "targetId": "SUPPLIER001"
    }
  ]
}

Response

Bulk fetch completed successfully. Check the response for successful targets and any errors.

Example response

{
  "targets": [
    {
      "id": 102006215,
      "name": "Høyanger",
      "sname": "3191281",
      "description": "Description shown in the target profile",
      "location": "Mistelbach",
      "yearFounded": 1999,
      "screened": true,
      "screenedStatus": "Screened",
      "linkedInId": "general-motors",
      "ctype": {
        "id": 1234,
        "ctype": "mine",
        "targetTypeId": 1234,
        "displayName": "Mine",
        "pluralName": "Mines",
        "icon": "fas fa-mine",
        "bgColor": "#ff0000",
        "textColor": "#ffffff"
      },
      "foreignSystems": [
        {
          "id": "1234",
          "source": "SAP_ARIBA"
        }
      ]
    }
  ],
  "errors": [
    {
      "targetId": 101,
      "systemId": "customer",
      "systemTargetId": "SUPPLIER001",
      "reason": "NOT_FOUND"
    }
  ]
}