Withdraw an information request

POST /api/v2/storefront/account-mappings/information-requests/{requestId}/withdraw Sometimes you no longer need what you asked for — the buyer resolved it another way, you changed your mind about what evidence you need, or the request was a mistake. This call drops the request without deciding the case: the case stays open and returns to your queue, exactly like an expired request re-blocks on you. This is different from declining. Declining closes the whole case with no grant. Withdrawing keeps the case open — you can still accept, link to an existing account, ask again, or reject later. Works whether the request is still live or has already expired. Once withdrawn, the request can no longer be confirmed or resent — send a fresh request if you still need something from the buyer.

Request

curl -X POST https://api.interchange.io/api/v2/storefront/account-mappings/information-requests/9931/withdraw \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "No longer needed."}'

Parameters

Field	Type	Required	Notes
`requestId`	string (path)	Yes	The information request’s `id`, from the `request-information` response or the pending request on a review row.
`reason`	string	No	Optional free-text note (1–500 characters), recorded on the case’s event history only — never stored on the request itself.

Response

200 OK with the withdrawn request:

{
  "id": "9931",
  "caseId": "4821",
  "status": "superseded",
  "message": "Please send your completed W-9 and a signed insertion order to finish setup.",
  "destinationUrl": "https://forms.example-seller.com/onboarding/w9",
  "url": "https://api.interchange.io/seller/acme-storefront/mcp/handoffs/kx9F2...",
  "expiresAt": "2026-09-15T00:00:00.000Z",
  "createdBy": "ops@example-seller.com",
  "confirmedBy": null,
  "confirmedAt": null,
  "createdAt": "2026-08-25T14:02:11.000Z"
}

Errors

401 UNAUTHORIZED — missing or invalid API key.
404 NOT_FOUND — no pending information request with this id under your storefront (already confirmed, superseded, cancelled, or never existed).

See Errors for the full error contract.

Request buyer information

Ask for information in the first place

Confirm buyer information

Record that the requested material arrived

Buyer Account Mapping

The review queue this case comes from

Start here

Buy media

Sell media

Help and updates

Withdraw an information request

Request

Parameters

Response

Errors

Request buyer information

Confirm buyer information

Buyer Account Mapping

​Request

​Parameters

​Response

​Errors

​Related

Request buyer information

Confirm buyer information

Buyer Account Mapping

Request

Parameters

Response

Errors

Related