Attach a service to a company
Orders a product against the company and bills you for it at creation, at your wholesale price. Idempotent - re-attaching the same product returns the existing order and does not bill you twice. Pass Idempotency-Key for safe retries.
Authorizations
Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.
Headers
Date-based API version to run this request against.
"2026-08-13"
Path Parameters
ID of the company.
^cmp_[0-9A-Za-z]{22}$Body
Attach a product to a company. Idempotent - one order per product per company, unless the product's repeat policy allows more: then each instance (a tax year, a state, a bank, an owner, or simply the nth request) is its own order.
The product to order, by key. Must be an active product in your catalog.
1 - 50^[a-z][a-z0-9_]{1,48}$"ein"
Your choice for each of the product's options (key -> value), as listed on GET /products. A required option that is missing, an unknown key, or an unknown value answers 400 invalid_request with one errors[] entry per problem.
The company owner this order is for. Required exactly when the product repeats per owner (repeat: per_shareholder - an ITIN application). Refused on every other product.
^sh_[0-9A-Za-z]{22}$Optionally answer the first form step in the same call - for services whose first step collects input (e.g. an EIN's SS-4 or an operating agreement's details), the order kicks off fully in one request.
100Response
The service order.
One product ordered on a company. Billed to you when created (or at each period end for arrears products). Reversed by a credit if cancelled before fulfilment starts. An active recurring order can be cancelled to stop renewing at the period end.
Entity name.
service_order ^so_[0-9A-Za-z]{22}$"so_0346sFPEvSkJvY8vt14NNw"
The company this order is on.
^cmp_[0-9A-Za-z]{22}$"ein"
Fulfilment status, derived from where Clemta has the order: received until fulfilment starts (a cancellable state), quote_pending while a priced-by-quote product waits for the price and your acceptance (also cancellable - cancelling declines the quote), in_progress while Clemta works, requires_action while the current step waits on a form from you or your client (an open form requirement says which), completed once the final step is reached - terminal, completed_at is set and service_order.completed fires once - and canceled.
received, quote_pending, in_progress, requires_action, completed, canceled The wholesale price you were billed, in the currency's smallest unit (cents).
7900
"usd"
Billing cadence - one_time, or recurring monthly/yearly.
one_time, monthly, yearly The variant choices this order was placed with (option key -> value).
True when fulfilment needs a form from the client (e.g. an ITIN or BOI service). Known once the order reaches fulfilment.
The live fulfilment step (e.g. "Application In Progress", "Signature Request"). Present once the order is being fulfilled.
The form the current step is waiting on, when form_required is true - the fields to submit next via the form endpoint. Present on the single-order view.
The negotiated-price lifecycle on a product priced per order (for example, catch-up bookkeeping). pending until Clemta reviews the work and sets the amount, quoted while the price waits for your accept_quote, accepted once you took it and the charge landed. Nothing is billed before acceptance.
The company owner this order is for (products ordered per owner, e.g. an ITIN).
How a completed order ended, where completion alone does not say - a bank application's approved or declined, a good-standing check's not eligible. Recorded by Clemta. A decline is a delivered service, not a credit. Absent while the work runs and on orders whose completion is the whole answer.
Present when this order was attached by a bundle order (the formation's included services) - it names the bundle product. Included orders bill nothing of their own. A paid option choice bills only the difference.
Pass-through lines this order carried beside unit_amount - the state's own charge and the processing fee, frozen at their order-time amounts. Each appears as its own line on your statement.
When the next period bills (for a product billed in arrears, the end of the running period). Only on recurring orders. Absent once renewals end.
When you requested cancellation. The request awaits a Clemta decision - renewals keep billing until it is approved. You hear the outcome as service_order.renewal_canceled or service_order.renewal_cancel_denied.
When the cancellation was approved. The order stops billing at renewal_ends_at. Fulfilment status is unaffected.
The period end the service runs to after a renewal cancel. An arrears product still bills this period at that moment, then stops.
When the order first reached completed. service_order.completed announces this moment, and it does not change afterward.