Merchants
- Overview
- Plan Your Dropship Implementation
- Dropship Integrations
- Merchant Best Practices
- Integrations
- Orders
- Products
- Suppliers
- Reports
- Settings
- Support
Merchant API Endpoints
- Authentication in Dropship
- Carriers
- Compliance Reports
- Connection Invites
- Inventory
- Invoices
- Orders
- Products
- Proposals
- Returns
- Shipments
- Webhooks
Suppliers
- Overview
- Getting Started
- Integrations
- Orders
- Products
- Reports
- Settings
Proposals
Get all product proposals
GET
/
v1
/
retailers
/
{retailer_id}
/
proposals
/
products
curl --request GET \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/products/ \
--header 'Authorization: Bearer <token>'
{
"count": 100,
"next": "https://api.example.org/demo/{retailer_id}/?page=5",
"previous": "https://api.example.org/demo/{retailer_id}/?page=3",
"results": [
{
"id": 101,
"name": "Winter 2025 Collection Update",
"status": "proposed",
"source": "console",
"proposal_type": "new_product",
"recipient": "retailer_456",
"sender": "supplier_123",
"memos": "Initial draft submitted by merchandising team.",
"created_by": "user_789",
"connection": "integration_abc",
"retailer": "Fashion Retail Co.",
"brand": "FrostWear",
"department": "Apparel",
"return_reason": "Insufficient pricing justification",
"return_reason_detail": "Missing supplier cost comparison documentation.",
"products": "[{ product_id: 202, name: 'Arctic Parka' }]",
"push_to_shopify": true,
"shopify_template": "default_fashion_template",
"export_platform_template": "standard_export_v1",
"attachments": "[{ filename: 'lookbook.pdf' }]",
"end_at": "2025-09-30T23:59:59Z",
"issues_summary": "Missing product images for 3 items",
"is_acknowledged": false,
"item_approved_count": 5,
"item_deleted_count": 0,
"item_rejected_count": 1,
"item_skipped_count": 2,
"item_count": "10",
"item_classified_count": "8",
"item_ready_count": "6",
"item_failed_count": "1",
"action_required": "Upload missing product photos",
"has_action": "yes",
"has_revision": "true",
"has_unresolved_issues": true,
"has_price_changes": true,
"collaborators": "user_789, user_321",
"target_live_date": "2025-10-01T00:00:00Z",
"start_at": "2025-04-01T00:00:00Z",
"expires_at": "2025-06-01T00:00:00Z",
"updated_at": "2025-04-22T15:30:00Z",
"created_at": "2025-04-20T08:45:00Z",
"draft_proposed_at": "2025-04-10T12:00:00Z",
"acknowledged_at": "2025-04-15T09:30:00Z",
"proposed_at": "2025-04-20T10:00:00Z",
"archived_at": "2025-04-22T17:00:00Z",
"revised_at": "2025-04-21T14:15:00Z",
"approved_at": "2025-04-25T11:00:00Z",
"declined_at": "2025-04-26T10:30:00Z",
"pricing_approved_at": "2025-04-24T13:45:00Z",
"completed_at": "2025-04-28T16:00:00Z",
"withdrawn_at": "2025-04-27T08:00:00Z",
"withdraw_reason": "The product line was discontinued by the supplier.",
"tags": "seasonal,featured,high-priority"
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.
Example:
1001
Response
200 - application/json
OK
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/products/ \
--header 'Authorization: Bearer <token>'
{
"count": 100,
"next": "https://api.example.org/demo/{retailer_id}/?page=5",
"previous": "https://api.example.org/demo/{retailer_id}/?page=3",
"results": [
{
"id": 101,
"name": "Winter 2025 Collection Update",
"status": "proposed",
"source": "console",
"proposal_type": "new_product",
"recipient": "retailer_456",
"sender": "supplier_123",
"memos": "Initial draft submitted by merchandising team.",
"created_by": "user_789",
"connection": "integration_abc",
"retailer": "Fashion Retail Co.",
"brand": "FrostWear",
"department": "Apparel",
"return_reason": "Insufficient pricing justification",
"return_reason_detail": "Missing supplier cost comparison documentation.",
"products": "[{ product_id: 202, name: 'Arctic Parka' }]",
"push_to_shopify": true,
"shopify_template": "default_fashion_template",
"export_platform_template": "standard_export_v1",
"attachments": "[{ filename: 'lookbook.pdf' }]",
"end_at": "2025-09-30T23:59:59Z",
"issues_summary": "Missing product images for 3 items",
"is_acknowledged": false,
"item_approved_count": 5,
"item_deleted_count": 0,
"item_rejected_count": 1,
"item_skipped_count": 2,
"item_count": "10",
"item_classified_count": "8",
"item_ready_count": "6",
"item_failed_count": "1",
"action_required": "Upload missing product photos",
"has_action": "yes",
"has_revision": "true",
"has_unresolved_issues": true,
"has_price_changes": true,
"collaborators": "user_789, user_321",
"target_live_date": "2025-10-01T00:00:00Z",
"start_at": "2025-04-01T00:00:00Z",
"expires_at": "2025-06-01T00:00:00Z",
"updated_at": "2025-04-22T15:30:00Z",
"created_at": "2025-04-20T08:45:00Z",
"draft_proposed_at": "2025-04-10T12:00:00Z",
"acknowledged_at": "2025-04-15T09:30:00Z",
"proposed_at": "2025-04-20T10:00:00Z",
"archived_at": "2025-04-22T17:00:00Z",
"revised_at": "2025-04-21T14:15:00Z",
"approved_at": "2025-04-25T11:00:00Z",
"declined_at": "2025-04-26T10:30:00Z",
"pricing_approved_at": "2025-04-24T13:45:00Z",
"completed_at": "2025-04-28T16:00:00Z",
"withdrawn_at": "2025-04-27T08:00:00Z",
"withdraw_reason": "The product line was discontinued by the supplier.",
"tags": "seasonal,featured,high-priority"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.