Suppliers - CDR.fyi API

List Suppliers

Retrieves a list of suppliers.

HTTP Request

GET https://api.cdr.fyi/v1/suppliers

Query Parameters

Parameter	Type	Description
entityFilterType	String	Filter by entity (Supplier, Marketplace, Purchaser)
entityFilterId	String	Filter by entity ID

Custom Headers

x-page: The page number (default is 1)
x-limit: Number of items per page (max 100, default is 10)

Example Request

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.cdr.fyi/suppliers?entityFilterType=Supplier&entityFilterId=123"

Create or Update a Supplier

This endpoint creates a new supplier or updates an existing one by upserting based on the supplier_id.

HTTP Request

POST https://api.cdr.fyi/v1/suppliers

Request Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Body Parameters

Parameter	Type	Description	Required
supplier_id	String	Unique identifier for the supplier	No
name	String	Name of the supplier	Yes
methods	String	Payment methods available	No
website	String	Website URL	No
logo	String	Logo URL	No
slug	String	URL slug	No
tagline	String	Tagline	No
description	String	Description (max 500 characters)	No
year_founded	Integer	Year founded	No
geo_city	String	Geographic city	No
geo_country	String	Geographic country	No
twitter	String	Twitter handle	No
is_verified	Boolean	Verification status	No

Example Request

curl -X GET https://api.cdr.fyi/v1/suppliers \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" 

Example Response

{
  "suppliers": [{
    "supplier_id": "sup_sample",
    "name": "Sample Supplier",
    "methods": "Credit Card",
    "website": "https://sample.com",
    "logo": "https://sample.com/logo.png",
    "slug": "sample-supplier",
    "tagline": "The best supplier",
    "description": "This is a sample supplier",
    "year_founded": 2010,
    "geo_city": "New York",
    "geo_country": "USA",
    "twitter": "@sample",
    "is_verified": true
  }]
}

Error Responses

If the request is not successful, you will receive a 400 Bad Request or 401 Unauthorized response along with an error message indicating the issue.

​List Suppliers

​HTTP Request

​Query Parameters

​Custom Headers

​Example Request

​Create or Update a Supplier

​HTTP Request

​Request Headers

​Request Body Parameters

​Error Responses

List Suppliers

HTTP Request

Query Parameters

Custom Headers

Example Request

Create or Update a Supplier

HTTP Request

Request Headers

Request Body Parameters

Error Responses