Send a quote for signature

POST

quotes

{id}

send

curl --request POST \
  --url https://api.alguna.io/quotes/{id}/send \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "signer_email": "ada@acme.com",
  "signer_name": "Ada Lovelace",
  "signer_role": "CFO"
}
'

import requests

url = "https://api.alguna.io/quotes/{id}/send"

payload = {
    "signer_email": "ada@acme.com",
    "signer_name": "Ada Lovelace",
    "signer_role": "CFO"
}
headers = {
    "Alguna-Version": "<alguna-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Alguna-Version': '<alguna-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({signer_email: 'ada@acme.com', signer_name: 'Ada Lovelace', signer_role: 'CFO'})
};

fetch('https://api.alguna.io/quotes/{id}/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "auto_activate": false,
  "contract": {
    "period_type": "fixed",
    "duration_months": 12,
    "end_date": "2027-01-01T00:00:00Z",
    "start_date": "2026-01-01T00:00:00Z"
  },
  "created_at": "2026-08-21T10:00:00Z",
  "currency": "USD",
  "customer_id": "cust_abc123",
  "id": "qt_abc123",
  "kind": "new",
  "name": "Acme Platform 2026",
  "status": "draft",
  "subscription_id": "sub_abc123",
  "updated_at": "2026-08-21T10:00:00Z",
  "expires_at": "2026-09-30T23:59:59Z",
  "signing_url": "https://acme.alguna.io/hs/elt_abc123",
  "withdrawal_reason": "Superseded by revised terms",
  "withdrawn_at": "2026-09-15T09:00:00Z"
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version

enum<string>

required

Available options:

2026-04-01

Idempotency-Key

string

A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.

Maximum string length: 255

Example:

"ik_a1b2c3d4e5f6"

Path Parameters

string

required

Unique identifier for the quote

Body

application/json

signer_email

string<email> | null

Email the signing link is sent to. When omitted no email is sent; share signing_url yourself.

Maximum string length: 255

Example:

"ada@acme.com"

signer_name

string | null

Name of the person expected to sign, recorded on the signature session.

Example:

"Ada Lovelace"

signer_role

string | null

Signer's job title, recorded on the signature session.

Example:

"CFO"

Response

Success

auto_activate

boolean

required

Whether this quote takes effect on its own once signed; otherwise activate it with Activate a Signed Quote

Example:

false

contract

object

required

Term of the subscription this quote documents

Show child attributes

created_at

string<date-time>

required

When the quote was created

Example:

"2026-08-21T10:00:00Z"

currency

string

required

ISO 4217 currency code

Example:

"USD"

customer_id

string

required

Customer ID

Example:

"cust_abc123"

string

required

Quote ID

Example:

"qt_abc123"

kind

enum<string>

required

Quote kind

Available options:

new,

renewal,

amendment

Example:

"new"

name

string

required

Display name of the quote: its own override when one is set, otherwise the name of the subscription it documents

Example:

"Acme Platform 2026"

status

enum<string>

required

Document status

Available options:

draft,

pending_approval,

sent,

signed,

rejected,

withdrawn,

expired

Example:

"draft"

subscription_id

string

required

The subscription this quote creates or amends. Whether the deal is in effect is that subscription's state, not the quote's: read it, or its phases, once the quote is signed.

Example:

"sub_abc123"

updated_at

string<date-time>

required

When the quote was last updated

Example:

"2026-08-21T10:00:00Z"

expires_at

string<date-time> | null

When the signing offer expires; null means it never expires

Example:

"2026-09-30T23:59:59Z"

signing_url

string | null

Hosted page where the customer reviews and signs. Present on a single quote while a customer signature is pending, so a lost link can be recovered; omitted on the list.

Example:

"https://acme.alguna.io/hs/elt_abc123"

withdrawal_reason

string | null

Reason recorded on withdrawal

Example:

"Superseded by revised terms"

withdrawn_at

string<date-time> | null

When the quote was withdrawn, if withdrawn

Example:

"2026-09-15T09:00:00Z"

⌘I

Send a quote for signature

curl --request POST \
  --url https://api.alguna.io/quotes/{id}/send \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "signer_email": "ada@acme.com",
  "signer_name": "Ada Lovelace",
  "signer_role": "CFO"
}
'

import requests

url = "https://api.alguna.io/quotes/{id}/send"

payload = {
    "signer_email": "ada@acme.com",
    "signer_name": "Ada Lovelace",
    "signer_role": "CFO"
}
headers = {
    "Alguna-Version": "<alguna-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Alguna-Version': '<alguna-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({signer_email: 'ada@acme.com', signer_name: 'Ada Lovelace', signer_role: 'CFO'})
};

fetch('https://api.alguna.io/quotes/{id}/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "auto_activate": false,
  "contract": {
    "period_type": "fixed",
    "duration_months": 12,
    "end_date": "2027-01-01T00:00:00Z",
    "start_date": "2026-01-01T00:00:00Z"
  },
  "created_at": "2026-08-21T10:00:00Z",
  "currency": "USD",
  "customer_id": "cust_abc123",
  "id": "qt_abc123",
  "kind": "new",
  "name": "Acme Platform 2026",
  "status": "draft",
  "subscription_id": "sub_abc123",
  "updated_at": "2026-08-21T10:00:00Z",
  "expires_at": "2026-09-30T23:59:59Z",
  "signing_url": "https://acme.alguna.io/hs/elt_abc123",
  "withdrawal_reason": "Superseded by revised terms",
  "withdrawn_at": "2026-09-15T09:00:00Z"
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

{
  "detail": "<string>",
  "status": 123
}

API Reference

Examples

SDKs

API Reference

Webhooks

Send a quote for signature

Authorizations

Headers

Path Parameters

Body

Response