> ## Documentation Index > Fetch the complete documentation index at: https://developer.fabric.inc/llms.txt > Use this file to discover all available pages before exploring further. # Get a specific proposal ## OpenAPI ````yaml dropship_proposals.openapi get /v1/retailers/{retailer_id}/proposals/{id}/ openapi: 3.0.0 info: title: Proposals API version: 1.0.0 description: | Endpoints for managing product proposals and their statuses. servers: - url: https://marketplace-api.fabric.inc description: Production server security: - Bearer: [] tags: - name: Proposals description: Proposal operations paths: /v1/retailers/{retailer_id}/proposals/{id}/: get: tags: - Proposals summary: Get a specific proposal parameters: - name: retailer_id in: path required: true description: >- 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. schema: type: integer example: 1001 - name: id in: path required: true description: >- The unique identifier of the proposal. This ID is automatically generated when a proposal is created. schema: type: integer example: 8008 responses: '200': description: Proposal details content: application/json: schema: $ref: '#/components/schemas/ProductProposal' components: schemas: ProductProposal: type: object properties: id: type: integer title: ID readOnly: true description: >- Unique identifier for the proposal. This ID is automatically generated when a proposal is created. example: 101 name: type: string title: Name maxLength: 128 minLength: 1 description: Name of the proposal. example: Winter 2025 Collection Update status: type: string title: Status enum: - draft - proposed - revised - completed - approved - declined - archived - pricing_approved - reopened - withdrawn description: Current status of the proposal. example: proposed source: type: string title: Source enum: - console - merchandising description: The origin of the proposal. example: console proposal_type: type: string title: Proposal type enum: - new_product - cost_update - image_update - attribute_update - legacy description: Type of proposal indicating its purpose. example: new_product recipient: type: string title: Recipient readOnly: true description: Recipient of the proposal. example: retailer_456 sender: type: string title: Sender readOnly: true description: Sender who created the proposal. example: supplier_123 memos: type: string title: Memos readOnly: true description: Internal notes or memos associated with the proposal. example: Initial draft submitted by merchandising team. created_by: type: string title: Created by readOnly: true description: User or system that created the proposal. example: user_789 connection: type: string title: Connection readOnly: true description: Integration or channel connection identifier. example: integration_abc retailer: type: string title: Retailer readOnly: true description: Retailer associated with the proposal. example: Fashion Retail Co. brand: type: string title: Brand readOnly: true description: Brand associated with the products in the proposal. example: FrostWear department: type: string title: Department readOnly: true description: Department to which the proposal belongs. example: Apparel return_reason: type: string title: Return reason readOnly: true description: Reason the proposal was returned for revisions. example: Insufficient pricing justification return_reason_detail: type: string title: Return reason detail nullable: true description: Additional details explaining the return reason. example: Missing supplier cost comparison documentation. products: type: string title: Products readOnly: true description: Products included in the proposal. example: '[{ product_id: 202, name: ''Arctic Parka'' }]' push_to_shopify: type: boolean title: Push to Shopify description: Indicates whether the proposal should be pushed to Shopify. example: true shopify_template: type: string title: Shopify template readOnly: true description: Shopify-specific template used. example: default_fashion_template export_platform_template: type: string title: Export platform template readOnly: true description: Template used for exporting to external platforms. example: standard_export_v1 attachments: type: string title: Attachments readOnly: true description: Attached files or resources for the proposal. example: '[{ filename: ''lookbook.pdf'' }]' end_at: type: string format: date-time title: End at nullable: true description: Optional end date for the proposal's active status. example: '2025-09-30T23:59:59Z' issues_summary: type: string title: Issues summary readOnly: true description: Summary of identified issues within the proposal. example: Missing product images for 3 items is_acknowledged: type: boolean title: Is acknowledged readOnly: true description: Indicates whether the proposal has been acknowledged. example: false item_approved_count: type: integer title: Item approved count readOnly: true description: Number of approved items in the proposal. example: 5 item_deleted_count: type: integer title: Item deleted count readOnly: true description: Number of deleted items in the proposal. example: 0 item_rejected_count: type: integer title: Item rejected count readOnly: true description: Number of rejected items in the proposal. example: 1 item_skipped_count: type: integer title: Item skipped count readOnly: true minimum: -2147483648 maximum: 2147483647 description: Number of items skipped during processing. example: 2 item_count: type: string title: Item count readOnly: true description: Total number of items in the proposal. example: '10' item_classified_count: type: string title: Item classified count readOnly: true description: Number of items that have been classified. example: '8' item_ready_count: type: string title: Item ready count readOnly: true description: Number of items ready for final review or processing. example: '6' item_failed_count: type: string title: Item failed count readOnly: true description: Number of items that failed validation or processing. example: '1' action_required: type: string title: Action required readOnly: true description: Description of action required from the user. example: Upload missing product photos has_action: type: string title: Has action readOnly: true description: Indicates whether there is a pending action. example: 'yes' has_revision: type: string title: Has revision readOnly: true description: Flag indicating whether the proposal includes revisions. example: 'true' has_unresolved_issues: type: boolean title: Has unresolved issues readOnly: true description: Indicates if the proposal still has unresolved issues. example: true has_price_changes: type: boolean title: Has price changes description: Indicates if there are pricing updates in the proposal. example: true collaborators: type: string title: Collaborators readOnly: true description: Users collaborating on the proposal. example: user_789, user_321 target_live_date: type: string format: date-time title: Target live date nullable: true description: Intended go-live date for the proposed changes. example: '2025-10-01T00:00:00Z' start_at: type: string format: date-time title: Start at nullable: true description: Start date of the proposal. example: '2025-04-01T00:00:00Z' expires_at: type: string format: date-time title: Expires at nullable: true description: Expiration date of the proposal. example: '2025-06-01T00:00:00Z' updated_at: type: string format: date-time title: Updated at readOnly: true description: Timestamp when the proposal was last updated. example: '2025-04-22T15:30:00Z' created_at: type: string format: date-time title: Created at readOnly: true description: Timestamp when the proposal was created. example: '2025-04-20T08:45:00Z' draft_proposed_at: type: string format: date-time title: Draft proposed at nullable: true description: Timestamp when the draft was proposed. example: '2025-04-10T12:00:00Z' acknowledged_at: type: string format: date-time title: Acknowledged at nullable: true description: Timestamp when the proposal was acknowledged. example: '2025-04-15T09:30:00Z' proposed_at: type: string format: date-time title: Proposed at nullable: true description: Timestamp when the proposal was officially proposed. example: '2025-04-20T10:00:00Z' archived_at: type: string format: date-time title: Archived at nullable: true description: Timestamp when the proposal was archived. example: '2025-04-22T17:00:00Z' revised_at: type: string format: date-time title: Revised at nullable: true description: Timestamp when the proposal was last revised. example: '2025-04-21T14:15:00Z' approved_at: type: string format: date-time title: Approved at nullable: true description: Timestamp when the proposal was approved. example: '2025-04-25T11:00:00Z' declined_at: type: string format: date-time title: Declined at nullable: true description: Timestamp when the proposal was declined. example: '2025-04-26T10:30:00Z' pricing_approved_at: type: string format: date-time title: Pricing approved at nullable: true description: Timestamp when pricing was approved. example: '2025-04-24T13:45:00Z' completed_at: type: string format: date-time title: Completed at nullable: true description: Timestamp when the proposal was completed. example: '2025-04-28T16:00:00Z' withdrawn_at: type: string format: date-time title: Withdrawn at nullable: true description: Timestamp when the proposal was withdrawn. example: '2025-04-27T08:00:00Z' withdraw_reason: type: string title: Withdraw reason maxLength: 300 nullable: true description: Reason why the proposal was withdrawn. example: The product line was discontinued by the supplier. tags: type: string title: Tags readOnly: true description: Metadata tags for classification or filtering. example: seasonal,featured,high-priority required: - name securitySchemes: Bearer: type: http scheme: bearer ````