GEgetlago
order_forms

Mark an order form as signed

Changed on

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

Request

Request body

Example request

{
  "order_form": {
    "signed_document": "data:application/pdf;base64,JVBERi0xLjQKJcfs...",
    "execution_mode": "execute_in_lago",
    "execute_at": "2026-07-01T00:00:00Z"
  }
}

Response

Order form marked as signed

Example response

{
  "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"
  }
}

Changes