Search Client Vendors

Retrieves a paginated list of vendors for the client.

Supports filtering, sorting and cursor-based pagination.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Client UUID or tenant_id accessible to the API key.

Accepts either the client UUID or the client's tenant_id.

Body Params

Filters, pagination and sorting for vendor search.

filter
object

Vendor filters using field names and operator:value strings.

  • Fields: id, code, name, status, tier, vendor_type, owner_id, contact_name,
    created_at, updated_at, tags (or tag), risk_score and search.
  • Status, tier and vendor_type accept client display names with eq, neq or in.
    Names are case-insensitive; tiers must be enabled.
  • Tags and risk_score support eq or in. Use tag names and risk labels;
    numeric band inputs are not accepted. Not set matches vendors without a score.
  • owner_id uses the client user's ID.
  • Other fields support eq, in, cont, like, gte, lte, gt, lt or neq where applicable.
string

Not supported for vendors. This field does not change the response fields.

int32
1 to 200
Defaults to 50

Number of vendors per page. Defaults to 50; maximum is 200.

string
^[A-Za-z0-9+/=]*$

Cursor returned in next_cursor. Omit for the first page; pass it unchanged with the same filters and sort.

string
^[+-]?(id|name|code|status|tier|created_at|updated_at)(,[+-]?(id|name|code|status|tier|created_at|updated_at)){0,9}$
Defaults to id

Comma-separated sort fields. Use '-' for descending order. Defaults to id ascending; ID breaks ties between equal values.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json