---
title: "Get webhook subscription"
method: GET
path: "/v2/webhook-subscriptions/{subscriptionId}"
tags: ["Webhook Event Subscriptions"]
---

# Get webhook subscription

`GET /v2/webhook-subscriptions/{subscriptionId}`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/webhook-subscriptions/{subscriptionId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/webhook-subscriptions/:subscriptionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns one public webhook subscription for the authenticated brokerage, or `404` if no matching public subscription exists.

## Response `200`

Webhook subscription returned successfully

- WebhookSubscription: Public webhook subscription connecting one webhook endpoint to one event type.
  - `id` string, required: Webhook subscription ID
  - `webhookEndpointId` string, required: Webhook endpoint ID that receives this event type
  - `eventType` 'TRACKING_UPDATE' | 'STOP_UPDATE' | 'LOAD_CARRIER_UPDATE' | 'SEND_TMS_COMMENT' | 'SCHEDULED_CARRIER_OUTREACH' | 'UPLOAD_FILES' | 'PUSH_BID_TO_TMS' | 'PUSH_LOAD_DRAFT' | 'CARRIER_ISSUE_UPDATED', required: Public event type for webhook subscription creation. Call `GET /v2/webhook-event-types` for the current source of truth.
  - `isActive` boolean, required: Whether this subscription is active

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Webhook subscription not found

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)