We hope you enjoy our updated documentation! The old documentation website is still available here. Reach out to us with feedback or questions. Happy programming! 🎉

Get list of available suppliers in a locale

GET

/suppliers

Last modified:2025-10-02 19:10:05

Description

This endpoint can be used to view a list of suppliers available in your account, by survey localization.

The response of this endpoint will return suppliers, by supplier ID, which may then be used in other API requests like Selecting Suppliers For Your Survey & Setting Quotas By Supplier.

Only suppliers that are not blocked, and have sample available in the selected survey localization will appear in the response.

Caching data

Our list of suppliers updates as we add / remove suppliers to our marketplace. Please take this into consideration when caching supplier names & ID’s.

We do not paginate the results of this endpoint. Passing an invalid localization code will result in an HTTP 400 error.

For a list of valid survey localization codes, please see Survey Localization Codes page.

Request

Authorization

Add parameter in header

access-token

Example:

access-token: ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

PHP

Python

Ruby

curl --location --request GET 'https://staging.spectrumsurveys.com/buyers/v2/suppliers?locale=en_US' \
--header 'access-token: <api-key>'

Responses

🟢200Success

application/json

Body

Example

Non exhaustive list of all available suppliers for a locale.

[
    {
        "id": 7,
        "name": "Say For Example"
    },
    {
        "id": 12,
        "name": "Decision Analyst"
    },
    {
        "id": 16,
        "name": "Innovate"
    },
    {
        "id": 17,
        "name": "P2 Sample"
    }
]

🟠400Bad Request

Modified at 2025-10-02 19:10:05

Update the list of suppliers for a survey

Get list of available suppliers for a survey

Get list of available suppliers in a locale

Description#

Request

Request Code Samples

Responses

Description