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

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
retailer_id
integer
required

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.