API Reference
Marketplaces
Documentation for the Marketplaces API endpoints including retrieving and updating marketplace records.
List Marketplaces
Retrieves a list of marketplaces.
HTTP Request
GET https://api.cdr.fyi/v1/marketplaces
Query Parameters
Parameter | Type | Description |
---|---|---|
entityFilterType | String | Filter by entity type (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 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
Parameter | Type | Description | Required |
---|---|---|---|
marketplace_id | String | Unique identifier for the marketplace | No |
name | String | Name of the marketplace | 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.