API Reference
Suppliers
Create, update & list supplier records.
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
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 |
String | Twitter handle | No | |
is_verified | Boolean | Verification status | No |
Example Request
Example Response
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.