Sign in
Suppliers - Management

Update target data.

Update spend data and Code of Conduct status for the specified target.

Required Permission: update_supplier_data

put/public/v1/target/{systemId}/{targetId}/data

Path parameters

systemIdstring required

The system ID is an identifier to determine from which the targetId might originate from. Supported systemIds are "prewave", "customer", "supplier", "own".

targetIdstring required

The target ID can be the target's prewaveId or an external id (edge number) representing the site in another system.

Request body

yearinteger required

Year that provided spend data applies to

spendDataMlnEuronumber double required

Spend data in millions of euros (e.g., 0.15 for 150,000 euros, 1.5 for 1.5 million euros)

cocSignedboolean nullable

Flag indicating if the supplier is signed by the Code of Conduct (Coc)

Example request

{
  "year": 2025,
  "spendDataMlnEuro": 0.15
}

Response

Target data updated successfully. Returns the full updated target payload.

idinteger required

Prewave target id

namestring required

Name of the Prewave target

snamestring nullable

Geonames Id (see https://geonames.org)

logostring nullable

URL to the logo shown in the target profile

backgroundPicturestring nullable

URL to the background picture shown in the target profile

descriptionstring nullable

Description of the Prewave target

websitestring nullable

URL to the website shown in the target profile

locationstring nullable

Location of the target

yearFoundedinteger nullable

Year the target was founded shown in the target profile

size'Small' | 'Medium' | 'Large' | 'Very large'
screenedboolean required

Whether the target is screened or not

screenedStatus'Required' | 'Pending' | 'Screened' | 'NotPossible'

Screening status of the target

linkedInIdstring nullable

LinkedIn ID of the target

monitoredSincestring date-time nullable

Date the target was monitored since

earliestAlertstring date-time nullable

Deprecated. Date of the earliest alert. Omitted when enabled for your organization.

orderinginteger nullable

Ordering of the target

disruptionStatusUpdateobject nullable

Deprecated. Disruption status has been removed and this field is always null.

ownboolean required

Whether the target is owned by user customer or not

managedboolean required

true if user is target connection contact or target is owned by user customer, false otherwise

isPublicboolean nullable

Whether the target is public or not

connectionContactsCountinteger nullable

Number of connection contacts of the target

populationinteger nullable

Population of the target. Generally applies to locations

followingboolean required

Target resides in "My follows" collection

collectionFollowingboolean required

Target resides in any followed collection (including children)

tierinteger nullable

Tier of the target (relevant when fetching Tier-N)

collectionLevelinteger nullable

How deep the target is in the collection hierarchy

scoreAvail'None' | 'Peer' | 'Alert' | 'SSA' | 'External' required
revenuenumber nullable

Revenue of the target

impact'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical'
mergedTargetsinteger[] required

Target ids of past targets that were merged into this current target

publicboolean

Example response

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

Changes

Changed in 2 of the 10 revisions of this API.22

  • 0ab68d9081f91See the full diff
    • ○

      response property earliestAlert deprecated

      response-property-deprecated

  • d08b2fe6a84f21See the full diff
    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became optional for the status

      response-property-became-optional

    • ○

      response property ctype/priority deprecated

      response-property-deprecated