Skip to main content

Standalone Flows

Standalone flows are the most basic flows and are used to create a single service order for our services:

The services you get from the API are the ones allowed for your API user, if you don't see an expected service, please get in touch.

For API examples, start at Service Filings overview.

Certain services (e.g., Foreign Qualification, Registered Agent, State Unemployment Insurance) are fulfilled using a multi-step, API-driven workflow designed to accommodate jurisdiction and entity-specific requirements.

Flow Overview​

  1. Partner collects baseline business and order information (order placed). This is the list of Fields to complete and Cost Breakdown.
  2. Partner submits order via API
  3. Swyft evaluates filing requirements based on jurisdiction and entity type, and other parameters (Validation Stage)
  4. Swyft may return additional required inputs via a webhook Rejection message (Information Request)
  5. Partner collects this information from the Customer and submits via the rejection endpoint Step 4
  6. Swyft completes the filing and returns:
    • status updates
    • filing confirmations
    • registration identifiers

How to Integrate​

Although we request all needed fields for a traditional filing on the first order creation request, Partners should design for a multi-step intake flow.

  • Use the order endpoints to create and (optionally) track orders
  • Receive information requests on your Webhook
  • Reply the information request with more data until all required inputs are satisfied

Important Notes​

  • Requirements vary by jurisdiction and entity type. Dynamic requirements may be surfaced after order submission through the rejections endpoint.
  • Swyft ensures completion of filings, including handling of edge cases and exceptions.

The steps below use the Foreign Qualification as an example. Other standalone products follow the same pattern (place order, complete intake or rejections processing, filing, completion), with product-specific statuses and notifications.

Successful path​

When the filing proceeds without rejection, the order moves from placement through review and In Progress to Complete.

Step 1 — Order placed and information request​

  • (Partner) places the FQ order.
  • (SwyftFilings) completes the new order on our side.
  • (Partner) receives an information request for more information (optional) on the webhook.
  • (SwyftFilings) waits for the webhook response.

Step 2 — Webhook request answered and order under review​

  • (Partner) answers the information request
  • (Partner) receives the “under review” notification
  • (SwyftFilings) sets order status to Under Review.

Step 3 — Application filed with the State Department​

  • (SwyftFilings) submits the application to the State Department.
  • (SwyftFilings) sets order status to In Progress.
  • (Partner) receives the In Progress notification

Step 4 — EIN approved and order complete​

  • (SwyftFilings) receives State Department approval.
  • (SwyftFilings) sets order status to Complete.
  • (Partner) receives the completion notification
  • (Partner) can view the FQ Order Information and evidence material via API.

Path with additional requirements or government rejection​

If the state or federal government entity rejects the filing, the Partner is notified and has the chance to provide what is needed so that SwyftFilings can resubmit. Steps 1–3 match the successful path; the branch below begins after the application is filed.

Steps 1–3 — Same as the successful path​

Follow Step 1 through Step 3 above.

Step 4 — Additional requirements or rejection​

  • (SwyftFilings) identifies additional required information or receives a rejection from the filing authority.
  • (Partner) receives a notification with the specific requirement or reason, for example: There is an issue with your application that requires additional information. [Dynamic reason]. Please respond here. on the Webhook set up for that purpose
  • (SwyftFilings) waits for the Partner’s response.

Step 5 — Partner responds; application resubmitted​

  • (Partner) provides the requested information or corrections (Webhook response).
  • (SwyftFilings) resumes processing (including re-submission if required).

Step 6 — EIN approved and order complete​

  • (SwyftFilings) receives State Department approval.
  • (SwyftFilings) sets order status to Complete.
  • (Partner) receives the same completion notification pattern as in Step 4 of the successful path along side all the filing evidence