Skip to main content
GET
/
v1
/
webhooks
/
events
/
{eventId}
/
status
Get Event Status
curl --request GET \
  --url https://api.example.com/v1/webhooks/events/{eventId}/status \
  --header 'Authorization: <authorization>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "eventId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "completed",
  "eventType": "kyc.status.changed",
  "createdAt": "2025-12-29T10:00:00.000Z",
  "processedAt": "2025-12-29T10:00:05.000Z"
}

​
Get Event Status

GET https://api.baanx.com/v1/webhooks/events/{eventId}/status Retrieves the current processing status of a specific event.

​
Overview

Returns a summary of the event’s current status — whether it is pending, processing, completed, or failed. Use this as a lightweight check when you don’t need the full delivery log detail.

​
Authentication

This endpoint requires authentication via Bearer token: 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Request

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
eventId
string (UUID)
required
Unique identifier of the event

​
Request Example

curl -X GET https://api.baanx.com/v1/webhooks/events/550e8400-e29b-41d4-a716-446655440000/status \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Response

​
200 Success

​
id
string (UUID)
Unique identifier for the event record
​
eventId
string (UUID)
Business event identifier
​
status
string
Current processing status: pending, processing, completed, failed, or skipped
​
eventType
string
Type of event (e.g., kyc.status.changed)
​
createdAt
string (ISO 8601)
Timestamp when the event was created
​
processedAt
string (ISO 8601) | null
Timestamp when the event was processed (null if not yet processed)
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "eventId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "completed",
  "eventType": "kyc.status.changed",
  "createdAt": "2025-12-29T10:00:00.000Z",
  "processedAt": "2025-12-29T10:00:05.000Z"
}

​
Error Responses

{
  "message": "Not authenticated"
}
  • GET /v1/webhooks/events - List all events
  • GET /v1/webhooks/events/{eventId}/logs - View full delivery logs for this event
  • POST /v1/webhooks/events/{eventId}/retry - Retry delivery if the event has failed