LAGO_URL="https://api.getlago.com"
ORDER_FORM_ID="__ORDER_FORM_ID__"
API_KEY="__YOUR_API_KEY__"
curl --location --request POST "$LAGO_URL/api/v1/order_forms/$ORDER_FORM_ID/mark_as_signed" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"order_form": {
"signed_document": "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
"execution_mode": "execute_in_lago",
"execute_at": "2026-07-01T00:00:00Z"
}
}'
from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import OrderFormMarkAsSigned
client = Client(api_key='__YOUR_API_KEY__')
try:
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
OrderFormMarkAsSigned(
signed_document='data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode='execute_in_lago',
execute_at='2026-07-01T00:00:00Z',
),
)
except LagoApiError as e:
repair_broken_state(e) # do something on error or raise your own exception
require 'lago-ruby-client'
client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
{
signed_document: 'data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode: 'execute_in_lago',
execute_at: '2026-07-01T00:00:00Z',
},
)
await client.orderForms.markOrderFormAsSigned("__ORDER_FORM_ID__", {
order_form: {
signed_document: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
execution_mode: "execute_in_lago",
execute_at: "2026-07-01T00:00:00Z",
},
});
import (
"context"
"fmt"
"time"
lago "github.com/getlago/lago-go-client"
)
func main() {
lagoClient := lago.New().SetApiKey("__YOUR_API_KEY__")
ctx := context.Background()
executeAt := time.Date(2026, time.July, 1, 0, 0, 0, 0, time.UTC)
orderForm, err := lagoClient.OrderForm().MarkAsSigned(ctx, "__ORDER_FORM_ID__", &lago.OrderFormMarkAsSignedInput{
SignedDocument: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
ExecutionMode: lago.OrderExecutionModeExecuteInLago,
ExecuteAt: &executeAt,
})
if err != nil {
// Error is *lago.Error
panic(err)
}
// orderForm is *lago.OrderForm
fmt.Println(orderForm)
}
{
"order_form": {
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"number": "OF-2026-0001",
"status": "generated",
"void_reason": "manual",
"expires_at": "2026-06-30T23:59:59Z",
"signed_at": "2026-04-29T08:59:51Z",
"voided_at": "2026-04-29T08:59:51Z",
"signed_document_url": "https://api.getlago.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMi/OF-2026-0001",
"lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_quote_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_quote_version_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"created_at": "2026-04-29T08:59:51Z",
"updated_at": "2026-04-29T08:59:51Z"
}
}{
"status": 401,
"error": "Unauthorized"
}{
"status": 403,
"error": "Forbidden",
"code": "feature_unavailable"
}{
"status": 404,
"error": "Not Found",
"code": "object_not_found"
}{
"status": 422,
"error": "Unprocessable entity",
"code": "validation_errors",
"error_details": {}
}Order forms
Mark an order form as signed
This endpoint records the customer’s signature on an order form, and creates the order that carries the quoted deal out.
Only a generated order form can be signed, so a 422 is returned once the order form has been signed, has expired or has been voided.
An execute_at landing on or after the day the quoted deal stops being executable is rejected as well, so the order can never be scheduled past the term it bills.
A concurrent write on the same quote is reported as a 422 rather than retried, so a duplicated call can fail while the first one is still in flight.
This is a premium feature.
POST
/
order_forms
/
{lago_id}
/
mark_as_signed
LAGO_URL="https://api.getlago.com"
ORDER_FORM_ID="__ORDER_FORM_ID__"
API_KEY="__YOUR_API_KEY__"
curl --location --request POST "$LAGO_URL/api/v1/order_forms/$ORDER_FORM_ID/mark_as_signed" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"order_form": {
"signed_document": "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
"execution_mode": "execute_in_lago",
"execute_at": "2026-07-01T00:00:00Z"
}
}'
from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import OrderFormMarkAsSigned
client = Client(api_key='__YOUR_API_KEY__')
try:
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
OrderFormMarkAsSigned(
signed_document='data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode='execute_in_lago',
execute_at='2026-07-01T00:00:00Z',
),
)
except LagoApiError as e:
repair_broken_state(e) # do something on error or raise your own exception
require 'lago-ruby-client'
client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
{
signed_document: 'data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode: 'execute_in_lago',
execute_at: '2026-07-01T00:00:00Z',
},
)
await client.orderForms.markOrderFormAsSigned("__ORDER_FORM_ID__", {
order_form: {
signed_document: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
execution_mode: "execute_in_lago",
execute_at: "2026-07-01T00:00:00Z",
},
});
import (
"context"
"fmt"
"time"
lago "github.com/getlago/lago-go-client"
)
func main() {
lagoClient := lago.New().SetApiKey("__YOUR_API_KEY__")
ctx := context.Background()
executeAt := time.Date(2026, time.July, 1, 0, 0, 0, 0, time.UTC)
orderForm, err := lagoClient.OrderForm().MarkAsSigned(ctx, "__ORDER_FORM_ID__", &lago.OrderFormMarkAsSignedInput{
SignedDocument: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
ExecutionMode: lago.OrderExecutionModeExecuteInLago,
ExecuteAt: &executeAt,
})
if err != nil {
// Error is *lago.Error
panic(err)
}
// orderForm is *lago.OrderForm
fmt.Println(orderForm)
}
{
"order_form": {
"lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"number": "OF-2026-0001",
"status": "generated",
"void_reason": "manual",
"expires_at": "2026-06-30T23:59:59Z",
"signed_at": "2026-04-29T08:59:51Z",
"voided_at": "2026-04-29T08:59:51Z",
"signed_document_url": "https://api.getlago.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMi/OF-2026-0001",
"lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_quote_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"lago_quote_version_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
"created_at": "2026-04-29T08:59:51Z",
"updated_at": "2026-04-29T08:59:51Z"
}
}{
"status": 401,
"error": "Unauthorized"
}{
"status": 403,
"error": "Forbidden",
"code": "feature_unavailable"
}{
"status": 404,
"error": "Not Found",
"code": "object_not_found"
}{
"status": 422,
"error": "Unprocessable entity",
"code": "validation_errors",
"error_details": {}
}LAGO_URL="https://api.getlago.com"
ORDER_FORM_ID="__ORDER_FORM_ID__"
API_KEY="__YOUR_API_KEY__"
curl --location --request POST "$LAGO_URL/api/v1/order_forms/$ORDER_FORM_ID/mark_as_signed" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"order_form": {
"signed_document": "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
"execution_mode": "execute_in_lago",
"execute_at": "2026-07-01T00:00:00Z"
}
}'
from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import OrderFormMarkAsSigned
client = Client(api_key='__YOUR_API_KEY__')
try:
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
OrderFormMarkAsSigned(
signed_document='data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode='execute_in_lago',
execute_at='2026-07-01T00:00:00Z',
),
)
except LagoApiError as e:
repair_broken_state(e) # do something on error or raise your own exception
require 'lago-ruby-client'
client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
client.order_forms.mark_as_signed(
'__ORDER_FORM_ID__',
{
signed_document: 'data:application/pdf;base64,JVBERi0xLjQKJcfs...',
execution_mode: 'execute_in_lago',
execute_at: '2026-07-01T00:00:00Z',
},
)
await client.orderForms.markOrderFormAsSigned("__ORDER_FORM_ID__", {
order_form: {
signed_document: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
execution_mode: "execute_in_lago",
execute_at: "2026-07-01T00:00:00Z",
},
});
import (
"context"
"fmt"
"time"
lago "github.com/getlago/lago-go-client"
)
func main() {
lagoClient := lago.New().SetApiKey("__YOUR_API_KEY__")
ctx := context.Background()
executeAt := time.Date(2026, time.July, 1, 0, 0, 0, 0, time.UTC)
orderForm, err := lagoClient.OrderForm().MarkAsSigned(ctx, "__ORDER_FORM_ID__", &lago.OrderFormMarkAsSignedInput{
SignedDocument: "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
ExecutionMode: lago.OrderExecutionModeExecuteInLago,
ExecuteAt: &executeAt,
})
if err != nil {
// Error is *lago.Error
panic(err)
}
// orderForm is *lago.OrderForm
fmt.Println(orderForm)
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique identifier assigned to the order form within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the order form's record within the Lago system.
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Body
application/json
Mark order form as signed payload
Parameters available when marking an order form as signed. Every parameter is optional, so an empty body records the signature without attaching a document, and creates an order that is not scheduled for execution.
Show child attributes
Show child attributes
Response
Order form marked as signed
Show child attributes
Show child attributes