---
title: "Retrieve an asset"
method: GET
path: "/billing/v1/assets/{id}"
tags: ["Assets"]
---

# Retrieve an asset

`GET /billing/v1/assets/{id}`

Returns the full details of an asset specified by the asset id.

## Path parameters

- `id` string, required

## Response `200`

OK - Asset details returned.

- AssetItemDetailed — Detailed information about a single asset, including subscription properties.
  - `createTime` integer — The time when the asset was created, in milliseconds since the epoch.
  - `id` string — The unique identifier of the asset.
  - `name` string — A human-readable label for the asset, typically combining the product name and domain or account ID.
  - `quantity` integer — The number of licenses or seats currently assigned to this asset.
  - `type` string — The asset type, e.g. g-suite, office-365, google-cloud, amazon-web-services, or microsoft-azure.
  - `url` string — A link to the asset details page in the DoiT console.
  - `properties` AssetProperties — Additional properties associated with an asset, such as subscription and customer details.
    - `customerDomain` string — The primary domain of the customer associated with this asset.
    - `customerID` string — The unique identifier of the customer in the reseller or partner portal.
    - `reseller` string — The reseller domain through which this asset was provisioned.
    - `subscription` Subscription — Subscription details for a G Suite or Office 365 asset.
      - `billingMethod` string — The billing method, e.g. ONLINE or OFFLINE.
      - `creationTime` integer — The time when the subscription was created, in milliseconds since the epoch.
      - `id` string — The unique identifier of the subscription.
      - `plan` SubscriptionPlan — Plan details for a subscription, indicating whether it is a commitment or flexible plan.
        - `commitmentInterval` SubscriptionPlanCommitmentInterval — The start and end dates of an annual commitment term.
          - `endTime` integer — The end time of the commitment interval, in milliseconds since the epoch.
          - `startTime` integer — The start time of the commitment interval, in milliseconds since the epoch.
        - `isCommitmentPlan` boolean — Whether this subscription is on an annual commitment plan (true) or a flexible plan (false).
        - `planName` string — The name of the plan, e.g. ANNUAL_MONTHLY_PAY, ANNUAL_YEARLY_PAY, FLEXIBLE, or TRIAL.
      - `purchaseOrderID` string — The purchase order ID associated with this subscription, if any.
      - `renewalSettings` RenewalSettings — Settings that control subscription renewal behavior at the end of a commitment term.
        - `renewalType` string — The type of renewal, e.g. AUTO_RENEW_MONTHLY_PAY, AUTO_RENEW_YEARLY_PAY, RENEW_CURRENT_USERS_MONTHLY_PAY, RENEW_CURRENT_USERS_YEARLY_PAY, SWITCH_TO_PAY_AS_YOU_GO, or CANCEL.
      - `resourceUIURL` string — A URL to the subscription management page in the admin console.
      - `seats` Seats — Licensing seat counts for a subscription.
        - `licensedNumberOfSeats` integer — The number of seats that are currently in use or assigned to users.
        - `maximumNumberOfSeats` integer — The maximum number of seats that can be used. Applies to flexible (non-commitment) plans.
        - `numberOfSeats` integer — The number of committed seats. Applies to annual commitment plans.
      - `skuID` string — The unique SKU identifier for the subscribed product.
      - `skuName` string — A human-readable name for the subscribed product SKU.
      - `status` string — The current status of the subscription, e.g. ACTIVE, SUSPENDED, or PENDING.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `404` — Not Found - The requested resource does not exist.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)