> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baanx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Event Status

> Retrieve the current processing status of a specific event

# Get Event Status

GET [https://api.baanx.com/v1/webhooks/events/\{eventId}/status](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:

```bash theme={null} theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication
</ParamField>

### Path Parameters

<ParamField path="eventId" type="string (UUID)" required>
  Unique identifier of the event
</ParamField>

### Request Example

<CodeGroup>
  ```bash cURL theme={null} theme={null}
  curl -X GET https://api.baanx.com/v1/webhooks/events/550e8400-e29b-41d4-a716-446655440000/status \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null} theme={null}
  const eventId = '550e8400-e29b-41d4-a716-446655440000';

  const response = await fetch(
    `https://api.baanx.com/v1/webhooks/events/${eventId}/status`,
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null} theme={null}
  import requests

  event_id = "550e8400-e29b-41d4-a716-446655440000"
  url = f"https://api.baanx.com/v1/webhooks/events/{event_id}/status"
  headers = {
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```typescript TypeScript theme={null} theme={null}
  const getEventStatus = async (eventId: string) => {
    const response = await fetch(
      `https://api.baanx.com/v1/webhooks/events/${eventId}/status`,
      {
        method: 'GET',
        headers: {
          'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
        }
      }
    );

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    return await response.json();
  };
  ```
</CodeGroup>

## Response

### 200 Success

<ResponseField name="id" type="string (UUID)">
  Unique identifier for the event record
</ResponseField>

<ResponseField name="eventId" type="string (UUID)">
  Business event identifier
</ResponseField>

<ResponseField name="status" type="string">
  Current processing status: `pending`, `processing`, `completed`, `failed`, or `skipped`
</ResponseField>

<ResponseField name="eventType" type="string">
  Type of event (e.g., `kyc.status.changed`)
</ResponseField>

<ResponseField name="createdAt" type="string (ISO 8601)">
  Timestamp when the event was created
</ResponseField>

<ResponseField name="processedAt" type="string (ISO 8601) | null">
  Timestamp when the event was processed (`null` if not yet processed)
</ResponseField>

<ResponseExample>
  ```json 200 - Completed theme={null} theme={null}
  {
    "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"
  }
  ```

  ```json 200 - Failed theme={null} theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "eventId": "660e8400-e29b-41d4-a716-446655440001",
    "status": "failed",
    "eventType": "card.activated",
    "createdAt": "2025-12-29T10:00:00.000Z",
    "processedAt": null
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 401 - Unauthorized theme={null} theme={null}
  {
    "message": "Not authenticated"
  }
  ```

  ```json 403 - Forbidden theme={null} theme={null}
  {
    "message": "Not authorized"
  }
  ```

  ```json 404 - Not Found theme={null} theme={null}
  {
    "message": "Event not found"
  }
  ```

  ```json 503 - Service Unavailable theme={null} theme={null}
  {
    "message": "Notification service is not configured for this environment"
  }
  ```
</ResponseExample>

## Related Endpoints

* `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