Skip to main content
GET
Get a specific proposal product by ruleset

Authorizations

Authorization
string
header
required

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

Path Parameters

ruleset_id
integer
required

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.

id
integer
required

The unique identifier of the proposal.

Response

200 - application/json

List of products in the proposal.

name
string
required

Name of the proposal.

Required string length: 1 - 128
Example:

"Winter 2025 Collection Update"

id
integer
read-only

Unique identifier for the proposal. This ID is automatically generated when a proposal is created.

Example:

101

status
enum<string>

Current status of the proposal.

Available options:
draft,
proposed,
revised,
completed,
approved,
declined,
archived,
pricing_approved,
reopened,
withdrawn
Example:

"proposed"

source
enum<string>

The origin of the proposal.

Available options:
console,
merchandising
Example:

"console"

proposal_type
enum<string>

Type of proposal indicating its purpose.

Available options:
new_product,
cost_update,
image_update,
attribute_update,
legacy
Example:

"new_product"

recipient
string
read-only

Recipient of the proposal.

Example:

"retailer_456"

sender
string
read-only

Sender who created the proposal.

Example:

"supplier_123"

memos
string
read-only

Internal notes or memos associated with the proposal.

Example:

"Initial draft submitted by merchandising team."

created_by
string
read-only

User or system that created the proposal.

Example:

"user_789"

connection
string
read-only

Integration or channel connection identifier.

Example:

"integration_abc"

retailer
string
read-only

Retailer associated with the proposal.

Example:

"Fashion Retail Co."

brand
string
read-only

Brand associated with the products in the proposal.

Example:

"FrostWear"

department
string
read-only

Department to which the proposal belongs.

Example:

"Apparel"

return_reason
string
read-only

Reason the proposal was returned for revisions.

Example:

"Insufficient pricing justification"

return_reason_detail
string | null

Additional details explaining the return reason.

Example:

"Missing supplier cost comparison documentation."

products
string
read-only

Products included in the proposal.

Example:

"[{ product_id: 202, name: 'Arctic Parka' }]"

push_to_shopify
boolean

Indicates whether the proposal should be pushed to Shopify.

Example:

true

shopify_template
string
read-only

Shopify-specific template used.

Example:

"default_fashion_template"

export_platform_template
string
read-only

Template used for exporting to external platforms.

Example:

"standard_export_v1"

attachments
string
read-only

Attached files or resources for the proposal.

Example:

"[{ filename: 'lookbook.pdf' }]"

end_at
string<date-time> | null

Optional end date for the proposal's active status.

Example:

"2025-09-30T23:59:59Z"

issues_summary
string
read-only

Summary of identified issues within the proposal.

Example:

"Missing product images for 3 items"

is_acknowledged
boolean
read-only

Indicates whether the proposal has been acknowledged.

Example:

false

item_approved_count
integer
read-only

Number of approved items in the proposal.

Example:

5

item_deleted_count
integer
read-only

Number of deleted items in the proposal.

Example:

0

item_rejected_count
integer
read-only

Number of rejected items in the proposal.

Example:

1

item_skipped_count
integer
read-only

Number of items skipped during processing.

Required range: -2147483648 <= x <= 2147483647
Example:

2

item_count
string
read-only

Total number of items in the proposal.

Example:

"10"

item_classified_count
string
read-only

Number of items that have been classified.

Example:

"8"

item_ready_count
string
read-only

Number of items ready for final review or processing.

Example:

"6"

item_failed_count
string
read-only

Number of items that failed validation or processing.

Example:

"1"

action_required
string
read-only

Description of action required from the user.

Example:

"Upload missing product photos"

has_action
string
read-only

Indicates whether there is a pending action.

Example:

"yes"

has_revision
string
read-only

Flag indicating whether the proposal includes revisions.

Example:

"true"

has_unresolved_issues
boolean
read-only

Indicates if the proposal still has unresolved issues.

Example:

true

has_price_changes
boolean

Indicates if there are pricing updates in the proposal.

Example:

true

collaborators
string
read-only

Users collaborating on the proposal.

Example:

"user_789, user_321"

target_live_date
string<date-time> | null

Intended go-live date for the proposed changes.

Example:

"2025-10-01T00:00:00Z"

start_at
string<date-time> | null

Start date of the proposal.

Example:

"2025-04-01T00:00:00Z"

expires_at
string<date-time> | null

Expiration date of the proposal.

Example:

"2025-06-01T00:00:00Z"

updated_at
string<date-time>
read-only

Timestamp when the proposal was last updated.

Example:

"2025-04-22T15:30:00Z"

created_at
string<date-time>
read-only

Timestamp when the proposal was created.

Example:

"2025-04-20T08:45:00Z"

draft_proposed_at
string<date-time> | null

Timestamp when the draft was proposed.

Example:

"2025-04-10T12:00:00Z"

acknowledged_at
string<date-time> | null

Timestamp when the proposal was acknowledged.

Example:

"2025-04-15T09:30:00Z"

proposed_at
string<date-time> | null

Timestamp when the proposal was officially proposed.

Example:

"2025-04-20T10:00:00Z"

archived_at
string<date-time> | null

Timestamp when the proposal was archived.

Example:

"2025-04-22T17:00:00Z"

revised_at
string<date-time> | null

Timestamp when the proposal was last revised.

Example:

"2025-04-21T14:15:00Z"

approved_at
string<date-time> | null

Timestamp when the proposal was approved.

Example:

"2025-04-25T11:00:00Z"

declined_at
string<date-time> | null

Timestamp when the proposal was declined.

Example:

"2025-04-26T10:30:00Z"

pricing_approved_at
string<date-time> | null

Timestamp when pricing was approved.

Example:

"2025-04-24T13:45:00Z"

completed_at
string<date-time> | null

Timestamp when the proposal was completed.

Example:

"2025-04-28T16:00:00Z"

withdrawn_at
string<date-time> | null

Timestamp when the proposal was withdrawn.

Example:

"2025-04-27T08:00:00Z"

withdraw_reason
string | null

Reason why the proposal was withdrawn.

Maximum string length: 300
Example:

"The product line was discontinued by the supplier."

tags
string
read-only

Metadata tags for classification or filtering.

Example:

"seasonal,featured,high-priority"