# Retrieve a subscription

Endpoint: GET /subscriptions/{subscriptionID}
Version: 1.0.445.36017
Security: OAuth2

## Path parameters:

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

## Response 200 fields (application/json):

  - `ID` (string)

  - `Frequency` (integer)
    Used to define how often to process the subscription. The subscription will process once every {Frequency} {Interval}.

  - `Interval` (string)
    Enum: "Days", "Weeks", "Months"

  - `NextOrderDate` (string)
    Next order date of the subscription. The hourly process that creates subscription orders will query for subscriptions with a NextOrderDate between now and five hours ago.
    Example: "2018-01-01T00:00:00-06:00"

  - `LastOrderDate` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `NotificationDate` (string)
    Date that subscription order reminder message sender will be triggered if used. Value is the result of NextOrderDate less NotificationDays on the subscription integration.
    Example: "2018-01-01T00:00:00-06:00"

  - `DateCreated` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `EndDate` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `Active` (boolean)

  - `FromCompanyID` (string)
    Only use when creating a subscription on behalf of another user. ID of the buyer or marketplace owner placing the order.

  - `FromUserID` (string)
    Only use when creating a subscription on behalf of a another user.

  - `ToCompanyID` (string)
    ID of the marketplace owner or supplier receiving the order created by this subscription, only writable on create.

  - `Payment` (object)
    Example: {"Type":"PurchaseOrder","CreditCardID":"","SpendingAccountID":""}

  - `Payment.Type` (string)
    Enum: "PurchaseOrder", "CreditCard", "SpendingAccount"

  - `Payment.CreditCardID` (string)

  - `Payment.SpendingAccountID` (string)

  - `BillingAddressID` (string)

  - `ShippingAddressID` (string)

  - `ProjectedSubtotal` (number)
    Tentative subtotal of next subscription order. Based on current known pricing; avoid if product or pricing is provided by an external integration.

  - `xp` (object)
    Example: {}

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: "404"

  - `ErrorCode` (string)
    Example: "NotFoundError"

  - `Message` (string)
    Example: "Object not found"

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}