List Marketplaces

Retrieves a list of marketplaces.

HTTP Request

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

Query Parameters

ParameterTypeDescription
entityFilterTypeStringFilter by entity type (Supplier, Marketplace, Purchaser)
entityFilterIdStringFilter 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/marketplaces?entityFilterType=Marketplace&entityFilterId=123"

Create or Update a Marketplace

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

HTTP Request

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

Request Headers

  • Authorization: Bearer YOUR_ACCESS_TOKEN
  • Content-Type: application/json

Request Body Parameters

ParameterTypeDescriptionRequired
marketplace_idStringUnique identifier for the marketplaceNo
nameStringName of the marketplaceYes
methodsStringPayment methods availableNo
websiteStringWebsite URLNo
logoStringLogo URLNo
slugStringURL slugNo
taglineStringTaglineNo
descriptionStringDescription (max 500 characters)No
year_foundedIntegerYear foundedNo
geo_cityStringGeographic cityNo
geo_countryStringGeographic countryNo
twitterStringTwitter handleNo
is_verifiedBooleanVerification statusNo

Example Request

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

Example Response

{
  "newMarketplace": {
    "marketplace_id": "mkt_sample",
    "name": "Sample Marketplace",
    "methods": "Credit Card",
    "website": "https://sample.com",
    "logo": "https://sample.com/logo.png",
    "slug": "sample-marketplace",
    "tagline": "The best marketplace",
    "description": "This is a sample marketplace",
    "year_founded": 2020,
    "geo_city": "San Francisco",
    "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.