Expedited EIN

By default, the EIN application joins the standard IRS processing queue. Expedited EIN processing is available for an additional fee. If you would like to add expedited processing for your end users, contact our Partnerships team for pricing details. In order to use this functionality, expedited processing must be included in your partner agreement.

You request expedited processing in the same create-company call: one extra field, no separate endpoint. The founder also signs one additional document — Form 8821 — alongside the SS-4. Everything else about the formation flow is unchanged.

Availability

Expedited EIN has two requirements:

Expedited EIN must be part of your partner agreement. The requestedServices field appears in the API reference for every partner, but doola performs the expedited processing only for partners whose agreement includes Expedited EIN. When it does, doola enables the feature for your account.
The founder must be non-US. Expedited processing is only available when no member, executiveMember, or responsibleParty supplies a US tax ID (SSN or ITIN). This is the same determination that produces the SS-4 requirement for non-US founders.

A request that fails either check is rejected in full: no company is created, and the rejection is a 4xx, so your Idempotency-Key is released. Fix the request and retry with the same key.

Sending variant: "Expedite" without Expedited EIN in your partner agreement is rejected with 403 E_FEATURE_NOT_ENABLED, not silently downgraded to standard processing.

Requesting the expedited EIN

Add requestedServices to the create-company request body:

{
  "doolaCustomerId": "31pLCw7sN2aQ9fJkRtY3vXbHmLe",
  "state": "WY",
  "...": "...",
  "requestedServices": [
    { "service": "EinCreation", "variant": "Expedite" }
  ]
}

Field	Values	Meaning
`service`	`EinCreation`	The service to configure. Only the EIN service is configurable today.
`variant`	`Standard`, `Expedite`	`Expedite` requests prioritized EIN processing. `Standard` behaves exactly the same as omitting the entry.

Omitting requestedServices keeps standard processing, so existing integrations are unaffected.

Reading it back

The company’s EinCreation service carries the variant, on both the create response and Get a company:

{
  "services": [
    { "name": "Formation", "status": "InProgress", "variant": "NONE" },
    { "name": "EinCreation", "status": "NotStarted", "variant": "Expedite" },
    { "name": "RegisteredAgent", "status": "NotStarted", "variant": "NONE" }
  ]
}

See Company services for the full service lifecycle.

The Form 8821 signature

Expedited processing relies on one extra authorization from the founder: Form 8821 (Tax Information Authorization), which lets doola retrieve the EIN letter directly from the IRS. An expedited company therefore carries a second signature requirement alongside the SS-4, on both the create response and Get a company:

{
  "signatureRequirements": [
    { "documentType": "SS4", "status": "PENDING" },
    { "documentType": "FORM8821", "status": "PENDING" }
  ]
}

Collect it exactly like the SS-4: request a signing session with documentType: "FORM8821" and present the whitelabeled link to the founder. The signing flow is identical, and the two documents are independent — collect them in parallel or in any order. Three webhook events mirror the SS-4 set: signature_form8821_completed fires the instant the founder signs, document_form8821_uploaded once the signed PDF is stored and downloadable, and signature_form8821_reminder_due (day 1, 3, 7) while the document remains unsigned. See Webhooks.

doola cannot retrieve the EIN letter from the IRS until the Form 8821 is signed, so an unsigned Form 8821 holds up the expedited path just like an unsigned SS-4 holds up the EIN application itself.

What stays the same

Expedited EIN changes how fast the EIN application is processed, not the flow around it:

The SS-4 signature is still required. Every expedited company has a non-US founder, so the founder signs an SS-4 before the IRS issues the EIN, exactly as described in Non-US founders.
Formation itself is not expedited. State filing and registered agent proceed on their usual timelines; the EIN application is prioritized once it can proceed.
The same signals report progress. Track the EinCreation service status, the ein field on the company, and the webhooks below.

Knowing when the EIN is issued

Two webhooks signal EIN issuance, at two distinct moments. They apply to every formation, expedited or not:

Event	Fires when
`company_ein_issued`	doola records the company’s EIN. Fetch the company to read the `ein` field.
`document_einletter_uploaded`	The IRS EIN confirmation letter is stored and ready to download.

See Webhooks for payloads and delivery details.

Errors

Branch on error.code, never on the message.

HTTP	Code	Meaning
403	`E_FEATURE_NOT_ENABLED`	Expedited EIN is not part of your partner agreement. See Availability.
400	`E_EXPEDITED_EIN_NOT_ELIGIBLE`	Someone on the company supplies a US tax ID, so it does not qualify for expedited processing. Retry without `requestedServices` for standard processing.
400	`E_VALIDATION_FAILED`	The `requestedServices` shape is invalid (an unsupported `service` or `variant`). The field detail carries `E_REQUESTED_SERVICES_INVALID` with the concrete reason.

The shape error looks like this:

{
  "payload": null,
  "error": {
    "code": "E_VALIDATION_FAILED",
    "message": "one or more fields are invalid",
    "requestId": "3D2mMaLHsT60sI5qyeHuBlS9TEM",
    "fields": {
      "requestedServices": {
        "code": "E_REQUESTED_SERVICES_INVALID",
        "message": "variant must be one of [Standard, Expedite]; got 'Fast'"
      }
    }
  }
}

See Errors for the response envelope and the global codes any endpoint can return.

Get started

Core concepts

Reference

API reference

Help

Updates

Availability

Requesting the expedited EIN

Reading it back

The Form 8821 signature

What stays the same

Knowing when the EIN is issued

Errors

​Availability

​Requesting the expedited EIN

​Reading it back

​The Form 8821 signature

​What stays the same

​Knowing when the EIN is issued

​Errors

Availability

Requesting the expedited EIN

Reading it back

The Form 8821 signature

What stays the same

Knowing when the EIN is issued

Errors