Skip to main content
Get suppliers
curl --request GET \
  --url https://api.responsibly.tech/v1/suppliers \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "id": "12h43XyZhc4rak2670e37xv[...]",
      "name": "Embudo Valley Organics",
      "countryIso3Code": "USA",
      "categories": [
        "Organic",
        "Fair Trade"
      ],
      "customFields": [
        {
          "fieldLabel": "Certification Type",
          "fieldValue": "ISO 14001"
        }
      ],
      "averageScore": 0.58,
      "publicSupplierProfileUrl": "https://app.responsibly.tech/supplier-portal/12h43<...>/suppliers/12h43Xy<...>"
    }
  ],
  "pagination": {
    "pageSize": 100,
    "nextPage": 2
  }
}

Authorizations

x-api-key
string
header
required

Query Parameters

page
number
default:1
Required range: x >= 1
perPage
number
default:100
Required range: 1 <= x <= 100
category
string

Optional category to filter by

Minimum string length: 1
customFieldLabel
string

Custom field label to filter by

Minimum string length: 1
customFieldValue
string

Custom field value to filter by

Minimum string length: 1

Response

Returns a list of suppliers.

items
object[]
required
pagination
object
required