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

# Get Webhook Event

> Retrieve a single webhook event by its event ID.

Use this endpoint to retrieve a specific webhook event by its ID.

### Path Parameters

* **id** (required): The unique identifier of the webhook event (the `event_id` from the list endpoint)

### Example Request

```bash theme={null}
curl -X GET "https://api.usecobalt.com/v1/webhook-events/evt_abc123def456" \
  -H "client_id: your_client_id" \
  -H "client_secret: your_client_secret" \
  -H "access_token: your_access_token"
```

### Example Response

```json theme={null}
{
  "success": true,
  "webhook_event": {
    "event_id": "evt_abc123def456",
    "event_type": "appointment.created",
    "webhook_url": "https://your-webhook-url.com/webhooks",
    "delivery_status": "success",
    "data": {
      "appointment_id": "appt123456789",
      "date_time": "2025-01-20T14:30:00",
      "timezone": "America/Los_Angeles",
      "provider_id": "prov_456",
      "secondary_provider_id": null,
      "provider_name": "Dr. Jane Smith",
      "mrn": "MRN123456"
    },
    "created_at": "2025-01-15T11:00:00.000Z",
    "job_id": "67890",
    "access_token_reference_id": "your_reference_id"
  }
}
```

### Response Fields

* **event\_id** (string): Unique event identifier
* **event\_type** (string): Event type (e.g., "patient.insurance.added", "appointment.created")
* **webhook\_url** (string): The URL the event was sent to
* **delivery\_status** (string): Delivery status - "success" or "failed"
* **data** (object): Event-specific payload data
* **created\_at** (string): ISO 8601 timestamp of event creation
* **job\_id** (string, nullable): Job ID if this event is related to an asynchronous operation
* **access\_token\_reference\_id** (string, nullable): The reference ID associated with your access token

### Error Responses

#### Webhook Event Not Found

```json theme={null}
{
  "success": false,
  "message": "Webhook event not found."
}
```

This error occurs when:

* The event ID doesn't exist
* The event belongs to a different user account

<Note>
  The `data` field contains event-specific information that varies depending on the event type. Refer to the webhook event docs for payload structures: [Operation Events](/docs/webhooks/operation-events), [Sync Events](/docs/webhooks/sync-events), [Account Events](/docs/webhooks/account-events).
</Note>


## OpenAPI

````yaml GET /webhook-events/{id}
openapi: 3.0.0
info:
  title: Cobalt API
  version: 1.0.1
  description: API for interacting with Cobalt's EHR integration services
servers:
  - url: https://api.usecobalt.com/v1
security:
  - ClientCredentials: []
    ClientSecret: []
    AccessToken: []
paths:
  /webhook-events/{id}:
    get:
      tags:
        - Webhooks
      summary: Get Webhook Event
      description: Retrieve a single webhook event by its event ID.
      operationId: getWebhookEventById
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: The webhook event ID
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  webhook_event:
                    type: object
                    properties:
                      event_id:
                        type: string
                        description: Unique event identifier
                      event_type:
                        type: string
                        description: >-
                          Event type (e.g., "patient.insurance.added",
                          "appointment.created")
                      webhook_url:
                        type: string
                        description: The URL the event was sent to
                      delivery_status:
                        type: string
                        enum:
                          - success
                          - failed
                        description: >-
                          Delivery status - "success" or "failed". Indicates
                          whether the webhook event was delivered to the webhook
                          URL on file
                      data:
                        type: object
                        description: Event-specific payload data
                      created_at:
                        type: string
                        format: date-time
                        description: ISO 8601 timestamp of event creation
                      job_id:
                        type: string
                        nullable: true
                        description: >-
                          Job ID if this event is related to an asynchronous
                          operation
                      access_token_reference_id:
                        type: string
                        nullable: true
                        description: The reference ID associated with your access token
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '404':
          description: Webhook event not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
components:
  securitySchemes:
    ClientCredentials:
      type: apiKey
      in: header
      name: client_id
    ClientSecret:
      type: apiKey
      in: header
      name: client_secret
    AccessToken:
      type: apiKey
      in: header
      name: access_token

````