# Get a subscription by ID

Endpoint: GET /api/v1.0/subscriptions/{subscriptionId}
Version: 1.0
Security: api_key

## Path parameters:

  - `subscriptionId` (string, required)
    The ID of the subscription.

## Query parameters:

  - `includeMeters` (boolean)
    If true, include meters in the response.

## Response 200 fields (application/json):

  - `marketplaceSubscriptionId` (string)
    Example: "aa930163-2330-45c2-a17c-dd325f9f2d44"

  - `created` (string)
    Example: "2025-11-25T00:00:00Z"

  - `customerTenantId` (string)
    Example: "36a5a162-2d92-4255-8f01-0a6b35dba770"

  - `companyName` (string)
    Example: "WeTransact"

  - `marketplaceOfferId` (string)
    Example: "my-product"

  - `marketplacePlanId` (string)
    Example: "my-sku"

  - `seatQuantity` (string)
    Example: "10"

  - `termUnit` (string)
    Example: "P1M | P1Y | P2Y | P3Y"

  - `initialUserEmail` (string)
    Example: "test@wetransact.io"

  - `additionalDetails` (string)
    Example: "{'phonenumber':'445533663388'}"

  - `status` (string)
    Example: "New | Approved | Cancelled | Suspended | Rejected | ApproveBy | Succeeded | Failed | Deleted"

  - `meteringDetails` (object)

  - `meteringDetails.meters` (array)

  - `meteringDetails.meters.meterId` (string)
    Example: "0a6b35dba770"

  - `meteringDetails.meters.meterName` (string)
    Example: "transactions"

  - `meteringDetails.meters.unit` (string)
    Example: "each"

  - `links` (array)

  - `links.href` (string)
    Example: "https://<yourdomain>.wetransact.io/api/v1.0/subscriptions/aa930163-2330-45c2-a17c-dd325f9f2d44"

  - `links.rel` (string)
    Example: "self"

  - `links.method` (string)
    Example: "GET"