Company status changed

Triggered when a company status changes throughout its lifecycle.

This event is sent when:

• Company is activated (PENDING_ACTIVATION → ACTIVE)
• Company is suspended (ACTIVE → SUSPENDED)
• Company is deactivated (ACTIVE → INACTIVE)
• Other status transitions occur

WEBHOOK company.status-changed

Example

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "company.status-changed",
  "version": 1,
  "timestamp": "2025-01-15T10:30:00.000Z",
  "source": "transaction-service",
  "company_id": "comp_123456789",
  "correlation_id": "corr_987654321"
}

Body

application/json

Base structure for all webhook events

id · string<uuid> · required

Unique event identifier

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

type · enum<string> · required

Event type identifier

Available options: company.status-changed

Example:

"company.status-changed"

version · integer · required

Event schema version

Example:

1

timestamp · string<date-time> · required

Event timestamp in ISO 8601 format

Example:

"2025-01-15T10:30:00.000Z"

source · string · required

Service that generated the event

Example:

"transaction-service"

company_id · string · required

Company ID associated with the event

Example:

"comp_123456789"

correlation_id · string · required

Correlation ID for event tracking

Example:

"corr_987654321"

payload · object

Company status change details

Show child attributes

Response

200

Webhook received successfully