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
Retrieve proposal products associated with a ruleset.
GET
/
v1
/
rulesets
/
{ruleset_id}
/
proposals
/
products
curl --request GET \
--url https://marketplace-api.fabric.inc/v1/rulesets/{ruleset_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 ruleset unique identifier. To retrieve this ID, login to Dropship and navigate to Settings > Product Rulesets and select a ruleset. The ruleset ID appears at the end of the HTTP URL.
Example:
228
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/rulesets/{ruleset_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.