Create quote

POST

quotes

curl --request POST \
  --url https://api.hyperline.co/v1/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "draft",
  "owner_email": "joe@acme.com",
  "customer_id": "cus_QalW2vTAdkR6IY",
  "invoicing_entity_id": "ive_47484fjdhy5",
  "comments": "Please find the contract and subscription details we discussed.",
  "terms": "By signing this quote, you accept our conditions of use for the use of our products and services.",
  "amount": 20000,
  "collect_payment_details": true,
  "collect_custom_property_ids": [],
  "automatically_start_subscription": true,
  "template_id": "quot_9hNWq4c84Z146W",
  "expires_at": "2024-04-28T14:12:09.293Z",
  "subscription": {
    "purchase_order": "<string>",
    "invoicing_entity_id": "ive_jerrb484RHn",
    "generate_draft_invoices": true,
    "commitment_interval": {
      "period": "years",
      "count": 1
    },
    "renew_automatically": true,
    "renew_for": {
      "period": "years",
      "count": 1
    },
    "minimum_invoice_fee": 250,
    "starts_at": "2024-12-20T16:04:11Z",
    "contract_start": "2024-01-15T00:00:00Z",
    "contract_end": "2025-01-15T00:00:00Z",
    "initial_billing_at": "2024-12-20T16:04:11Z",
    "trial_ends_at": "2024-12-20T16:04:11Z",
    "trial_delay_first_invoice": true,
    "cancel_at": "2024-12-20T16:04:11Z",
    "cancellation_strategy": "refund_prorata",
    "cancellation_amount": 24000,
    "products": [
      {
        "id": "itm_FJKlqUb8COXw55",
        "name": "Product name",
        "description": "A description of the product.",
        "description_display_interval_dates": false,
        "payment_interval": {
          "period": "months",
          "count": 1
        },
        "payment_schedule": "start",
        "price": {
          "type": "fee",
          "amount": 200
        },
        "prices": [
          {
            "type": "volume",
            "from": 0,
            "to": 20,
            "amount": 200,
            "unit_count": 1,
            "on_tier_incomplete": null
          },
          {
            "type": "volume",
            "from": 21,
            "to": null,
            "amount": 150,
            "unit_count": 1,
            "on_tier_incomplete": null
          }
        ],
        "count": 2,
        "unit_name": "user",
        "min_committed_count": 2,
        "min_amount": 123,
        "max_amount": 123,
        "metering_interval_type": "subscription_commitment",
        "bill_usage_difference": true
      }
    ],
    "coupons": [
      {
        "id": "<string>",
        "repeat": "once",
        "expires_at": "2024-12-20T16:04:11Z",
        "apply_at": "2024-12-20T16:04:11Z",
        "product_ids": [
          "<string>"
        ]
      }
    ],
    "properties": {},
    "custom_properties": {}
  }
}'

{
  "id": "quo_hXQCd5y8P3GYXa",
  "customer_id": "cus_QalW2vTAdkR6IY",
  "invoicing_entity_id": "ive_47484fjdhy5",
  "template_id": "quot_9hNWq4c84Z146W",
  "crm_opportunity_id": "<string>",
  "number": "327",
  "comments": "Please find the contract and subscription details we discussed.",
  "terms": "By signing this quote, you accept our conditions of use for the use of our products and services.",
  "collect_payment_details": true,
  "collect_custom_property_ids": [],
  "attachments": [
    {
      "id": "quof_5GYXy8P3QCdaXh",
      "name": "General Conditions of Sale",
      "mimetype": "application/pdf"
    }
  ],
  "signed_file": {
    "id": "<string>",
    "name": "<string>",
    "mimetype": "<string>"
  },
  "url": "https://billing.hyperline.co/quote/quo_hXQCd5y8P3GYXa",
  "created_at": "2024-12-20T16:04:11Z",
  "automatically_start_subscription": true,
  "status": "draft",
  "subscription_id": "sub_B6ClkdqNqVNBgY",
  "amount": 200000,
  "expires_at": "2024-10-13T02:00:00.000Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

customer_id

string

required

ID of the customer.

template_id

string

required

ID of the quote template. If not specified, a subscription configuration must be defined.

status

enum<string>

Quote status.

draft: The quote is a draft.
approved: The quote is approved and ready to be sent to the customer.
pending_signature: The quote is awaiting the customer's signature.

Available options:

draft,

approved,

pending_signature

owner_email

string

Email address of the Hyperline user acting as the quote owner. If not specified, the Hyperline account owner will be assigned.

invoicing_entity_id

string

ID of the invoicing entity attached to the quote.

comments

string

Custom comments displayed on the quote.

terms

string

Custom quotation terms.

amount

number | null

Estimated contract value. If not specified, automatically computed from the subscription configuration.

collect_payment_details

Collect customer payment method mandate during signature flow or not.

collect_custom_property_ids

string[]

IDs of the customer custom properties required to be filled during the signature flow.

automatically_start_subscription

Whether the subscription should be automatically started when the quote is signed.

expires_at

string

Quote expiration date. UTC date time string in the ISO 8601 format.

subscription

object

Subscription configuration constituting the quote.

subscription.purchase_order

string

Reference to the purchase order.

subscription.invoicing_entity_id

string

ID of the invoicing entity attached to the subscription.

subscription.generate_draft_invoices

default:

false

Generate draft invoices for the subscription. Each invoice will need to be reviewed and validated manually before being sent

subscription.commitment_interval

object

deprecated

Use contract_start contract_end and renew_automatically instead. Interval previously used to represent the commitment period of the subscription.

subscription.renew_automatically

default:

true

Indicates if the subscription should automatically renew.

subscription.renew_for

object

If renew_automatically is enabled, will renew the subscription for the given interval.

subscription.minimum_invoice_fee

number | null

Minimum fee applied to each invoice outside of one time payments.

subscription.starts_at

string

deprecated

Deprecated field, please use contract_start.

subscription.contract_start

string

Subscription contract start date. UTC date time string in the ISO 8601 format.

subscription.contract_end

string

Subscription contract end date. UTC date time string in the ISO 8601 format.

subscription.initial_billing_at

string

Date when the subscription will start being billed. If not specified, it will correspond to the contract_start date. UTC date time string in the ISO 8601 format.

subscription.trial_ends_at

string

End date of the trial period. UTC date time string in the ISO 8601 format.

subscription.trial_delay_first_invoice

default:

false

Delay first invoice to the end of the trial period.

subscription.cancel_at

string

Subscription cancel date. UTC date time string in the ISO 8601 format.

subscription.cancellation_strategy

enum<string>

Strategy used to cancel the subscription. If not specified do_nothing is used.

charge_prorata: Will charge the customer the unpaid amount for the prorated period up to the end of the current period.
charge_custom: Will charge the customer a custom amount.
refund_prorata: Will refund to the customer the overpaid subscription amount using prorated calculations on the cancellation date.
refund_custom: Will refund to the customer a custom amount.
end_of_period: Will cancel the subscription at the end date of the current billing period.
do_nothing: Will only cease the subscription without any additional actions.

Available options:

refund_prorata,

refund_custom,

charge_prorata,

charge_custom,

end_of_period,

do_nothing

subscription.cancellation_amount

number

Custom amount used when cancelling the subscription. Only applies to the charge_custom or the refund_custom cancellation strategy.

subscription.products

object[]

Products that make up the subscription.

subscription.products.id

string

required

Product ID.

subscription.products.name

string

Product name. This will appear on the final invoices.

subscription.products.description

string

Product description. This will appear on the final invoices.

subscription.products.description_display_interval_dates

boolean

default:

false

Indicates if the dates of the interval should be automatically added in the product description on the invoices.

subscription.products.payment_interval

object

Interval on which the product is billed. This interval can be different between products and can differ from the subscription commitment interval.

subscription.products.payment_schedule

enum<string>

Indicates if the product should be billed at the start or the end of the payment interval.

Available options:

start,

end

subscription.products.price

object

Price of the product. If not specified, the matching prices (depending on the currency, interval, etc) of the product defined in the products catalog/plan are used.

subscription.products.prices

object[]

Price of the product. If not specified, the matching prices (depending on the currency, interval, etc) of the product defined in the products catalog/plan are used.

subscription.products.count

number

Number of product units. Only applies to products of type flat_fee or seat.

Required range: x > 1

subscription.products.unit_name

string

Product name. This will appear on the final invoices. Only applies to products of type seat or usage.

subscription.products.min_committed_count

number

Minimum of units committed. If usage is less than this number, then this value will be used. Only applies to products of type usage.

Required range: x > 1

subscription.products.min_amount

number

Minimum amount billed. If the final computed amount from the usage for this product is less than this amount, then this value will be used. Only applies to products of type usage.

subscription.products.max_amount

number

Maximum amount billed. If the final computed amount from the usage for this product is greater than this amount, then this value will be used. Only applies to products of type usage.

subscription.products.metering_interval_type

enum<string>

Indicates on which type of interval the usage should be aggregated.

subscription_commitment: For the usage contained within the subscription commitment period.
payment_interval: For the usage contained within the payment interval of the product.
full_database: For all the usage we ingested for this product, no matter the period. Only applies to products of type usage.

Available options:

subscription_commitment,

payment_interval,

full_database

subscription.products.bill_usage_difference

default:

false

Only bill the usage difference comparing to the previous period (i.e. actual amount minus last invoice amount). Doesn't apply to payment_interval metering interval type. Only applies to products of type usage.

subscription.coupons

object[]

subscription.properties

object

Key/value pairs to store any information you find useful.

subscription.custom_properties

object

A list of key value with the ID or the name of the custom property as the key and the custom property value as value.

Response

201 - application/json

string

required

Quote ID.

customer_id

string

required

ID of the customer.

invoicing_entity_id

string

required

ID of the invoicing entity attached to the quote.

template_id

string | null

required

ID of the quote template.

crm_opportunity_id

string | null

required

ID of the related opportunity/deal in the connected CRM.

number

string

required

Quote sequential number.

comments

string | null

required

Custom comments displayed on the quote.

terms

string | null

required

Custom quotation terms.

collect_payment_details

boolean

required

Collect customer payment method mandate during signature flow or not.

collect_custom_property_ids

string[]

required

IDs of the customer custom properties required to be filled during the signature flow.

attachments

object[]

required

List of documents attached to the quote.

signed_file

object

required

Final signed quote (manually uploaded).

url

string | null

required

URL to access the quote publicly. Only applies to the pending_signature or signed quote.

created_at

string | null

required

UTC date time string in the ISO 8601 format.

automatically_start_subscription

boolean

required

Whether the subscription should be automatically started when the quote is signed.

status

enum<string>

required

Quote status.

draft: The quote is a draft.
pending_approval: The quote is pending manager review and approval.
changes_requested: Some changes have been requested following manager review.
approved: The quote is approved and ready to be sent to the customer.
pending_signature: The quote is awaiting the customer's signature.
signed: The quote is signed and fully finalized.
voided: The quote is voided.

Available options:

draft

subscription_id

string | null

required

ID of the current subscription attached to the quote. The get subscription endpoint (GET /v2/subscriptions/{id}) can be used to retrieve the related details.

amount

number

required

Estimated contract value.

expires_at

string | null

required

Quote expiration date. UTC date time string in the ISO 8601 format.

Was this page helpful?

Get quote Download quote

curl --request POST \
  --url https://api.hyperline.co/v1/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "draft",
  "owner_email": "joe@acme.com",
  "customer_id": "cus_QalW2vTAdkR6IY",
  "invoicing_entity_id": "ive_47484fjdhy5",
  "comments": "Please find the contract and subscription details we discussed.",
  "terms": "By signing this quote, you accept our conditions of use for the use of our products and services.",
  "amount": 20000,
  "collect_payment_details": true,
  "collect_custom_property_ids": [],
  "automatically_start_subscription": true,
  "template_id": "quot_9hNWq4c84Z146W",
  "expires_at": "2024-04-28T14:12:09.293Z",
  "subscription": {
    "purchase_order": "<string>",
    "invoicing_entity_id": "ive_jerrb484RHn",
    "generate_draft_invoices": true,
    "commitment_interval": {
      "period": "years",
      "count": 1
    },
    "renew_automatically": true,
    "renew_for": {
      "period": "years",
      "count": 1
    },
    "minimum_invoice_fee": 250,
    "starts_at": "2024-12-20T16:04:11Z",
    "contract_start": "2024-01-15T00:00:00Z",
    "contract_end": "2025-01-15T00:00:00Z",
    "initial_billing_at": "2024-12-20T16:04:11Z",
    "trial_ends_at": "2024-12-20T16:04:11Z",
    "trial_delay_first_invoice": true,
    "cancel_at": "2024-12-20T16:04:11Z",
    "cancellation_strategy": "refund_prorata",
    "cancellation_amount": 24000,
    "products": [
      {
        "id": "itm_FJKlqUb8COXw55",
        "name": "Product name",
        "description": "A description of the product.",
        "description_display_interval_dates": false,
        "payment_interval": {
          "period": "months",
          "count": 1
        },
        "payment_schedule": "start",
        "price": {
          "type": "fee",
          "amount": 200
        },
        "prices": [
          {
            "type": "volume",
            "from": 0,
            "to": 20,
            "amount": 200,
            "unit_count": 1,
            "on_tier_incomplete": null
          },
          {
            "type": "volume",
            "from": 21,
            "to": null,
            "amount": 150,
            "unit_count": 1,
            "on_tier_incomplete": null
          }
        ],
        "count": 2,
        "unit_name": "user",
        "min_committed_count": 2,
        "min_amount": 123,
        "max_amount": 123,
        "metering_interval_type": "subscription_commitment",
        "bill_usage_difference": true
      }
    ],
    "coupons": [
      {
        "id": "<string>",
        "repeat": "once",
        "expires_at": "2024-12-20T16:04:11Z",
        "apply_at": "2024-12-20T16:04:11Z",
        "product_ids": [
          "<string>"
        ]
      }
    ],
    "properties": {},
    "custom_properties": {}
  }
}'

{
  "id": "quo_hXQCd5y8P3GYXa",
  "customer_id": "cus_QalW2vTAdkR6IY",
  "invoicing_entity_id": "ive_47484fjdhy5",
  "template_id": "quot_9hNWq4c84Z146W",
  "crm_opportunity_id": "<string>",
  "number": "327",
  "comments": "Please find the contract and subscription details we discussed.",
  "terms": "By signing this quote, you accept our conditions of use for the use of our products and services.",
  "collect_payment_details": true,
  "collect_custom_property_ids": [],
  "attachments": [
    {
      "id": "quof_5GYXy8P3QCdaXh",
      "name": "General Conditions of Sale",
      "mimetype": "application/pdf"
    }
  ],
  "signed_file": {
    "id": "<string>",
    "name": "<string>",
    "mimetype": "<string>"
  },
  "url": "https://billing.hyperline.co/quote/quo_hXQCd5y8P3GYXa",
  "created_at": "2024-12-20T16:04:11Z",
  "automatically_start_subscription": true,
  "status": "draft",
  "subscription_id": "sub_B6ClkdqNqVNBgY",
  "amount": 200000,
  "expires_at": "2024-10-13T02:00:00.000Z"
}

API documentation

Integrations

Analytics

Billable events

Companies

Coupons

Custom properties

Customers

Customers > Credits

Customers > Payment methods

Integrations

Invoices

Invoicing entities

OAuth2

Organisations

Payments

Plans

Price configurations

Products

Quotes

Subscriptions

Taxes

Third-party apps

Wallets

Webhooks

Authorizations

Body

Response