---
title: "Get subscription"
method: GET
path: "/subscriptions/{id}"
tags: ["Subscriptions & Webhooks"]
---

# Get subscription

`GET /subscriptions/{id}`

## Path parameters

- `id` integer, required

## Response `200`

Successfully retrieved subscription's information

- object
  - `subscription` object, required
    - `id` integer, required — Global ID of the subscription
    - `type` 'API_TOKEN_CREATED' | 'API_TOKEN_REVOKED' | 'ASSET_STATUS_CHANGE' | 'CONNECTOR_TOKEN_REVOKED' | 'DATA_EXPORT_INITIATED' | 'INVITE_LINK_ARCHIVED' | 'INVITE_LINK_CREATED' | 'INVITE_LINK_UPDATED' | 'METER_TRIGGER_STATE_CHANGE' | 'NEW_ASSET' | 'NEW_CATEGORY_ON_WORK_ORDER' | 'NEW_COMMENT_ON_WORK_ORDER' | 'NEW_LOCATION' | 'NEW_PART' | 'NEW_PURCHASE_ORDER' | 'NEW_SLASH_COMMAND' | 'NEW_VENDOR' | 'NEW_WORK_ORDER' | 'NEW_WORK_REQUEST' | 'PART_CHANGE' | 'PART_DELETE' | 'PART_QUANTITY_CHANGE' | 'PART_TRANSFER' | 'PURCHASE_ORDER_CHANGE' | 'PURCHASE_ORDER_STATUS_CHANGE' | 'ROLE_ARCHIVED' | 'ROLE_CREATED' | 'ROLE_UPDATED' | 'SSO_CONFIG_CHANGED' | 'USER_ACTIVATED' | 'USER_INVITED' | 'USER_LOGIN_FAILURE' | 'USER_LOGIN_SUCCESS' | 'USER_LOGOUT' | 'USER_PERMISSIONS_CHANGED' | 'USER_REMOVED' | 'USER_ROLE_CHANGED' | 'USER_SESSION_REVOKED' | 'WEBHOOK_ARCHIVED' | 'WEBHOOK_CREATED' | 'WORK_ORDER_CHANGE' | 'WORK_ORDER_DELETE' | 'WORK_ORDER_OVERDUE' | 'WORK_ORDER_PART_STATUS_CHANGE' | 'WORK_ORDER_STATUS_CHANGE' | 'WORK_REQUEST_STATUS_CHANGE', required — Type of event subscribed to
    - `url` string, required
    - `status` 'VALID' | 'PENDING_APPROVAL', required — Validation status of the subscription. Contact support if your subscription returns PENDING_APPROVAL before using the subscription.

## Other responses

- `400` — Error with query
- `401` — Invalid token
- `404` — Could not find the specified subscription or the user cannot access it.

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)