Get proposal

GET /api/v2/storefront/proposals/{id} Returns a single proposal by its numeric row id, including the snapshot — the frozen products[] and proposals[] the buyer receives when they redeem the code. Use this to confirm exactly what offer a code represents before sharing it, or to inspect view and redemption state.

Request

curl "https://api.interchange.io/api/v2/storefront/proposals/318" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Param	Type	Required	Notes
`id`	integer	Yes	Proposal row ID (path parameter)

Response

{
  "id": 318,
  "proposalCode": "PRP-XK4A29",
  "operatorId": "acme",
  "label": "Acme Q3 RFP — CTV",
  "notes": "Offline RFP follow-up; honors the upfront rate.",
  "status": "active",
  "expiresAt": "2026-09-30T23:59:59Z",
  "proposalId": "proposal_abc123",
  "discoverySessionId": "disc_a1b2c3",
  "snapshot": {
    "products": [
      { "productId": "prod_123", "name": "Premium CTV — Sports" }
    ],
    "proposals": [
      { "proposalId": "proposal_abc123" }
    ]
  },
  "createdAt": "2026-06-07T15:00:00Z",
  "createdBy": "seller@acme-media.example.com",
  "firstViewedAt": "2026-06-08T09:12:00Z",
  "lastViewedAt": "2026-06-08T09:14:00Z",
  "redeemedAt": null,
  "redeemedInMediaBuyId": null
}

snapshot.products and snapshot.proposals are the frozen offer, exactly as discover_products returned it at creation — including each composed product’s ext.scope3_merchandise block, if one resolved. See the story-first proposal for what that block states. firstViewedAt and lastViewedAt track buyer views; redeemedAt and redeemedInMediaBuyId are populated once the buyer applies the code to a media buy.

Errors

404 NOT_FOUND — no proposal with that id is visible to the authenticated seller.

See Errors for the full error contract.

Proposal tasks

All proposal operations

List proposals

Find the proposal ID

Update proposal

Edit label, notes, or expiry

Revoke proposal

Withdraw a code before redemption

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Request

Parameters

Response

Errors

Proposal tasks

List proposals

Update proposal

Revoke proposal

​Request

​Parameters

​Response

​Errors

​Related

Proposal tasks

List proposals

Update proposal

Revoke proposal

Request

Parameters

Response

Errors

Related