API

Retrieve subscription for company

Retrieves subscription information for the company

GET/v1/hq/subscriptions/{subscription_id}

Authorization

BearerTokenAuth

AuthorizationBearer <token>

The Noona HQ API uses Bearer token for authentication.

Endpoints that return generic information that does not contain sensitive data do not require authentication. Endpoints that require authentication are specifically marked in the documentation.

Authorization: Bearer your-token

In: header

Path Parameters

subscription_id*string

Subscription id

Query Parameters

select?array<string>
expand?array<string>

Response Body

application/json

curl -X GET "https://api.noona.is/v1/hq/subscriptions/string"
{
  "id": "7awdXwZoedakjad37a",
  "customer": "7awdXwZoedakjad37a",
  "status": "future",
  "subscription_items": [
    {
      "item_price_id": "7awdXwZoedakjad37a",
      "item_type": "plan",
      "quantity": 0,
      "unit_price": 0,
      "amount": 0,
      "trial_end": "2019-08-24T14:15:22Z"
    }
  ],
  "charged_items": [
    {
      "item_price_id": "7awdXwZoedakjad37a",
      "last_charged_at": "2019-08-24T14:15:22Z"
    }
  ],
  "coupons": [
    {
      "coupon_id": "7awdXwZoedakjad37a",
      "coupon_code": "50off",
      "applied_count": 0,
      "apply_till": "2019-08-24T14:15:22Z"
    }
  ],
  "discounts": [
    {
      "id": "7awdXwZoedakjad37a",
      "coupon": "7awdXwZoedakjad37a",
      "invoice_name": "Good customer discount",
      "apply_on": "invoice_amount",
      "item_price_id": "7awdXwZoedakjad37a",
      "percentage": 100,
      "amount": 0,
      "duration_type": "one_time",
      "period_unit": "day",
      "period": 1,
      "currency_code": "str",
      "included_in_mrr": true,
      "applied_count": 0,
      "apply_till": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "currency_code": "str",
  "exchange_rate": 0.1,
  "auto_close_invoices": true,
  "due_invoices_count": 0,
  "total_dues": 0,
  "due_since": "2019-08-24T14:15:22Z",
  "cancel_reason": "not_paid",
  "cancelled_at": "2019-08-24T14:15:22Z",
  "trial_start": "2019-08-24T14:15:22Z",
  "current_term_start": "2019-08-24T14:15:22Z",
  "current_term_end": "2019-08-24T14:15:22Z",
  "next_billing_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted": true
}
Empty
Empty