GET
/
v1
/
retailers
/
{retailer_id}
/
proposals
/
{id}
/
proposal-products
/
curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/{id}/proposal-products/ \
  --header 'Authorization: Bearer <token>'
[
  {
    "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

​
id
integer
required

The unique identifier of the proposal. This ID is automatically generated when a proposal is created.

Response

200 - application/json

Products within the proposal

The response is of type object[].