Sign in
latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Suppliers - Connection Contacts

Find supplier connection contacts by identifier

Overview

Retrieve all connection contacts for a supplier identified by any of its identifiers (supplierId, customerId, ownId, or prewaveId).

Connection contacts are contact persons associated with suppliers that can be used for communication and relationship management. This endpoint returns contacts that are accessible to your organization.

Search Behavior

  • Provide at least one identifier parameter.
  • The identifiers must resolve to exactly one supplier.
  • If multiple suppliers are found, a 400 Bad Request is returned.

Related Operations

  • Create Contact: POST /public/v2/suppliers/connection-contacts
  • Delete Contact: DELETE /public/v2/suppliers/connection-contacts/{contactId}
  • Find Suppliers: GET /public/v2/suppliers/sites/find-by-identifier

Required Permission

access_public_suppliers and access_public_conn_contacts

get/public/v2/suppliers/connection-contacts

Query parameters

supplierIdstring

Supplier ID to search for. Can be combined with customerId, ownId, and/or prewaveId.

customerIdstring

Customer ID to search for. Can be combined with supplierId, ownId, and/or prewaveId.

ownIdstring

Own site ID to search for. Can be combined with supplierId, customerId, and/or prewaveId.

prewaveIdinteger

Prewave ID to search for. Can be combined with supplierId, customerId, and/or ownId.

sourcestring

Optional source system to filter by. If not provided, matches IDs with any source or without a source. Applies to all provided ID parameters.

Response

Successfully retrieved connection contacts

idinteger required

Unique identifier of the connection contact.

emailstring email nullable

Email address of the connection contact. May be null if not provided.

Example response

[
  {
    "id": 42,
    "email": "contact@example.com"
  }
]