Skip to main content

Trade Disabled

Event Type​

trade_disabled

Summary​

Company-only. Sent when a trade is disabled. Triggered when an active trade is disabled; this transition sends trade_disabled rather than trade_amended. Payload includes only the trade ID; fetch full details from GET /trades/{id}.

Access​

Company webhooks only. Agency webhooks cannot subscribe to this event.

Delivery​

Requidex sends a signed POST request with Content-Type: application/json to the configured webhook URL. Return a 2xx response after accepting the event for processing. Duplicate or out-of-order deliveries are possible; deduplicate by event ID.

See delivery headers, signature verification and retry handling for the shared contract. The webhook signing secret is separate from an API key used to fetch the record.

Payload Fields​

FieldTypeRequiredDescription
idstringYesStable event identifier, reused for delivery retries
typestringYestrade_disabled
createdAtstringYesEvent creation time in ISO 8601 UTC format
dataobjectYesAffected resource reference; not a snapshot of the changed record
Show child attributes
  • trade object — Affected trade reference
    Show child attributes
    • id string — Identifier used by the corresponding detail endpoint
testbooleanNoPresent and true for test deliveries; the resource ID is test

Payload Example​

{
"id": "evt_01K1WEBHOOKEXAMPLE",
"type": "trade_disabled",
"createdAt": "2026-09-10T12:00:00.000Z",
"data": {
"trade": {
"id": "507f1f77bcf86cd799439013"
}
}
}

Read the Affected Record​

The payload contains the full object ID in data.trade.id. Fetch the record with GET /trades/{id}.

The follow-up API request uses your API key and the endpoint’s scope and access rules. A webhook subscription does not grant additional API access. Test deliveries include test: true and use the resource ID test; do not fetch a business record for those deliveries.