> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer-stage.shipbob.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-stage.shipbob.dev/_mcp/server. # Get Subscriptions GET https://sandbox-api.shipbob.com/2026-01/webhook This endpoint returns a list of webhook subscriptions. Reference: https://developer-stage.shipbob.dev/api/webhooks/get-subscriptions ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: api-2026-01 version: 1.0.0 paths: /2026-01/webhook: get: operationId: get-subscriptions summary: | Get Subscriptions description: |2 This endpoint returns a list of webhook subscriptions. tags: - subpackage_webhooks parameters: - name: RecordsPerPage in: query description: | Number of webhooks returned per page in a paginated response. required: false schema: $ref: >- #/components/schemas/Webhooks.Get.V2.Webhook.RecordsPerPage.Integer - name: Cursor in: query description: > [Optional] A pagination token used to retrieve the next or previous page of results. Omit to start at the first page. required: false schema: $ref: '#/components/schemas/Webhooks.Get.V2.Webhook.Cursor.String' - name: Authorization in: header description: Authentication using Personal Access Token (PAT) token required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Webhooks.GetWebhookResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Webhooks.BadRequestObjectResult' '401': description: No access right at this time content: application/json: schema: description: Any type '403': description: No access content: application/json: schema: description: Any type servers: - url: https://sandbox-api.shipbob.com description: https://sandbox-api.shipbob.com components: schemas: Webhooks.Get.V2.Webhook.RecordsPerPage.Integer: type: integer description: Number of webhooks returned per page in a paginated response. title: Webhooks.Get.V2.Webhook.RecordsPerPage.Integer Webhooks.Get.V2.Webhook.Cursor.String: type: string description: >- [Optional] A pagination token used to retrieve the next or previous page of results. Omit to start at the first page. title: Webhooks.Get.V2.Webhook.Cursor.String Webhooks.Topics: type: string enum: - order.shipped - order.shipment.delivered - order.shipment.exception - order.shipment.on_hold - order.shipment.cancelled - order.shipment.tracking.updated - order.shipment.address.updated - order.shipment.line_item.added - order.shipment.line_item.removed - order.shipment.line_item.updated - order.shipment.shipping_service.updated - return.created - return.updated - return.completed - return.load_shipment.departed - return.gaylord.departed - return.load_shipment.arrived - return.gaylord.arrived - billing.charge.created - billing.refund.created - billing.credit.created - wro.box.arrived - wro.box.scanned - wro.box.stowed - wro.completed - wro.created - wro.updated title: Webhooks.Topics Webhooks.V2.WebhookViewModelV2: type: object properties: created_at: type: string format: date-time description: TimeStamp the webhook subscription was created description: type: string description: Description of the webhook subscription enabled: type: boolean description: Indicates if the webhook subscription is enabled or not id: type: string description: ID of the webhook subscription topics: type: array items: $ref: '#/components/schemas/Webhooks.Topics' description: List of event types the webhook will receive notifications for url: type: string description: URL subscription events will be posted to title: Webhooks.V2.WebhookViewModelV2 Webhooks.GetWebhookResponse: type: object properties: items: type: array items: $ref: '#/components/schemas/Webhooks.V2.WebhookViewModelV2' next: type: string description: Go to the Next page prev: type: string description: Go to the Previous page title: Webhooks.GetWebhookResponse WebhooksBadRequestObjectResultValue: type: object properties: {} title: WebhooksBadRequestObjectResultValue Webhooks.BadRequestObjectResult: type: object properties: content_types: type: array items: type: string declared_type: description: Any type formatters: type: array items: description: Any type status_code: type: integer value: $ref: '#/components/schemas/WebhooksBadRequestObjectResultValue' title: Webhooks.BadRequestObjectResult securitySchemes: PAT: type: http scheme: bearer description: Authentication using Personal Access Token (PAT) token OAuth2: type: http scheme: bearer description: OAuth2 authentication using JWT tokens ``` ## Examples **Response** ```json { "items": [ { "created_at": "2019-08-24T14:15:22+00:00", "description": "string", "enabled": true, "id": "12345", "topics": [ "order.shipped" ], "url": "string" } ], "next": "string", "prev": "string" } ``` **SDK Code** ```python default import requests url = "https://sandbox-api.shipbob.com/2026-01/webhook" querystring = {"RecordsPerPage":"1","Cursor":"string"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript default const url = 'https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go default package main import ( "fmt" "net/http" "io" ) func main() { url := "https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby default require 'uri' require 'net/http' url = URI("https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java default import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string") .header("Authorization", "Bearer ") .asString(); ``` ```php default request('GET', 'https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp default using RestSharp; var client = new RestClient("https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift default import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://sandbox-api.shipbob.com/2026-01/webhook?RecordsPerPage=1&Cursor=string")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```