PRprewave
Suppliers - Management

Bulk fetch detailed target information by target IDs

Changed on

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

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"
    }
  ]
}

Changes

  • cedf01f35c95Revision changes
    • info

      added to the // response property allOf list for the response status

    • info

      removed from the // response property allOf list for the response status

  • 0ab68d9081f9Revision changes
    • info

      response property targets/items/earliestAlert deprecated