/v1/iris/filing-seasonGet IRIS filing season status
Check TY2026 IRS opening expectations, TaxFileAPI live status, and the planned payment method.
Responses
200 | Current launch statusapplication/json · FilingSeasonExample response |
|---|
Explore the IRIS transmission sandbox, test credits, TY2026 Tax Returns preparation, and provider verification contracts. Live TaxFileAPI filing is awaiting activation.
status_url using the same key. Check the record-level errors and retry a request with its original idempotency key.curl -sS --fail-with-body https://www.taxfileapi.com/v1/transmissions \
-H "Authorization: Bearer $TAXFILEAPI_SANDBOX_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: sandbox-quickstart-001' \
-H 'X-TaxFileAPI-Sandbox-Approve: true' \
--data '{"form":"1099-NEC","tax_year":2026,"header":{"payer_ref":"demo-payer"},"records":[{"record_id":"demo-001","fields":{"recipient_ref":"demo-recipient","nonemployee_compensation":"1250.00"}},{"record_id":"demo-002","fields":{"recipient_ref":"demo-recipient","nonemployee_compensation":"870.00"}}],"sandbox_scenario":"accepted"}'
New sandbox accounts start with two test credits. Add test credits if an approved batch returns 402.
Browser-only operations. Sign into the sandbox for key creation, wallet actions and batch approval.
Server calls. Discovery and fixture endpoints are public. Batch submission and status require Authorization: Bearer <sandbox key>. Sandbox keys expire after 24 hours and are not production credentials.
Errors. API errors use error.code and error.message. Field validation can add error.details. The browser approval endpoint returns HTML when the test wallet balance is insufficient.
/v1/iris/filing-seasonCheck TY2026 IRS opening expectations, TaxFileAPI live status, and the planned payment method.
200 | Current launch statusapplication/json · FilingSeasonExample response |
|---|
/v1/iris/formsList supported sandbox form-and-year pairs, upstream input-schema links and account-credit pricing rules.
200 | IRIS catalogapplication/json · IRISCatalog |
|---|
/v1/iris/schemaFetch the input schema for one listed form and tax year. Schema availability is distinct from production eligibility.
tax_year · query · required · 2025, 2026form · query · required · "1042-S", "1097-BTC", "1098", "1098-C", "1098-E", "1098-F", "1098-Q", "1098-T"…200 | Input schemaapplication/json · IRISFormSchema |
|---|---|
404 | Form or year unavailableapplication/json · Error |
503 | Schema temporarily unavailableapplication/json · Error |
/v1/transmissionsSubmit 1–50 synthetic records, up to 24,000 bytes. Use unique demo-prefixed record IDs. 1099-NEC uses nonemployee_compensation as a positive decimal string. Other forms use fixture_ref. Partial acceptance needs at least two records.
Idempotency-Key · header · required · stringX-TaxFileAPI-Sandbox-Approve · header · optional · "true" — Explicit approval for synthetic quickstart calls.application/json · TransmissionInput
{
"form": "1099-NEC",
"tax_year": 2026,
"header": {
"payer_ref": "demo-payer"
},
"records": [
{
"record_id": "demo-001",
"fields": {
"recipient_ref": "demo-recipient",
"nonemployee_compensation": "1250.00"
}
},
{
"record_id": "demo-002",
"fields": {
"recipient_ref": "demo-recipient",
"nonemployee_compensation": "870.00"
}
}
],
"sandbox_scenario": "accepted"
}
200 | Identical retryapplication/json · Transmission |
|---|---|
201 | Batch createdapplication/json · Transmission |
400 | Invalid key or JSONapplication/json · Error |
401 | Invalid bearer keyapplication/json · Error |
402 | Insufficient simulated credits. Add credits and retry with the original key.application/json · CreditError |
409 | Idempotency conflictapplication/json · Error |
413 | Request too largeapplication/json · Error |
415 | Unsupported media typeapplication/json · Error |
422 | Field validation failedapplication/json · Error |
503 | Production or workspace unavailableapplication/json · Error |
/v1/transmissions/{id}Poll with the same sandbox bearer key that created the batch. The delayed fixture spends six seconds queued after approval. The approval URL is null in this response.
id · path · required · string200 | Transmission foundapplication/json · Transmission |
|---|---|
401 | Invalid bearer keyapplication/json · Error |
404 | Transmission not foundapplication/json · Error |
503 | Production or workspace unavailableapplication/json · Error |
/v1/sandbox/keysGenerate a 24-hour key in the signed-in developer console. The response contains the key and an optional webhook secret. Browser POST must be same-origin.
201 | Key issuedapplication/json · SandboxKey |
|---|---|
401 | Sign-in requiredapplication/json · Error |
403 | Same-origin requiredapplication/json · Error |
503 | Sandbox unavailableapplication/json · Error |
/approve/{token}Open the approval_url returned on submission. The link is sensitive and expires with the sandbox key.
token · path · required · string200 | Hosted review pagetext/html · string |
|---|---|
404 | Expired or invalid linkapplication/json · Error |
503 | Sandbox unavailableapplication/json · Error |
/approve/{token}Use the hosted same-origin form while signed in as the wallet owner. A successful transition applies one test credit per record.
token · path · required · stringapplication/x-www-form-urlencoded · object
303 | Redirect to the review page Headers · Location |
|---|---|
400 | Confirmation requiredapplication/json · Error |
402 | Insufficient test credits on the review pagetext/html · string |
403 | Wrong origin or wallet ownerapplication/json · Error |
404 | Expired or invalid linkapplication/json · Error |
409 | Legacy batch requires a fresh sandbox keyapplication/json · Error |
415 | Expected browser form encodingapplication/json · Error |
503 | Sandbox unavailableapplication/json · Error |
/v1/sandbox/creditsRead the signed-in account’s simulated credit wallet. Keys issued to the same account share the wallet.
200 | Balanceapplication/json · SandboxWalletExample response |
|---|---|
401 | Sign-in requiredapplication/json · Error |
503 | Wallet unavailableapplication/json · Error |
/v1/sandbox/credits/topupsAdd up to 2,000 test credits per request from a same-origin signed-in browser. The operation has no Stripe payment.
Idempotency-Key · header · required · string — Reuse the original key for an identical retry. Use a new key when the request changes.application/json · SandboxTopUp
{
"quantity": 100
}
200 | Identical retryapplication/json · SandboxWallet |
|---|---|
201 | Top-up appliedapplication/json · SandboxWallet |
400 | Invalid JSON or requestapplication/json · Error |
401 | Sign-in requiredapplication/json · Error |
403 | Same-origin requiredapplication/json · Error |
409 | Top-up key reused with a different quantityapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
503 | Wallet unavailableapplication/json · Error |
/v1/sandbox/formsDiscover form fixtures for individual simulated IRIS requests.
200 | Grouped fixture catalogapplication/json · SingleFixtureCatalog |
|---|
/v1/sandbox/transmissionsSubmit one IRIS fixture of up to 1,024 bytes. Every call generates a new simulated receipt. No wallet or batch approval is involved.
application/json · SingleFixtureInput
{
"channel": "iris",
"form": "1099-NEC",
"scenario": "accepted"
}
202 | Simulated receiptapplication/json · SingleReceiptHeaders · Location |
|---|---|
400 | Invalid JSON or requestapplication/json · Error |
409 | MeF transmission is in developmentapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
/v1/sandbox/acknowledgments/{receipt_id}Fetch the acknowledgment using the receipt from the simulator. A pending fixture remains pending. Older simulator receipts may identify MeF.
receipt_id · path · required · string200 | Simulated acknowledgmentapplication/json · SingleAcknowledgment |
|---|---|
404 | Invalid receiptapplication/json · Error |
/v1/sandbox/tax-returnsList TY2026 MeF form and fixture options. Production remains disabled.
200 | MeF prep catalogapplication/json · MeFCatalog |
|---|
/v1/sandbox/tax-returnsPrepare a synthetic TY2026 draft preview, up to 2,048 bytes. The missing-information fixture returns a successful response with findings. The result is a simulation.
application/json · MeFFixture
{
"tax_year": 2026,
"form": "1040",
"fixture": "complete"
}
200 | Synthetic draft preview or preparation findingsapplication/json · MeFDraft |
|---|---|
400 | Invalid JSON or requestapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
/v1/provider-applicationsWhen enabled, lists up to 30 applications belonging to the signed-in account and whether review is configured.
200 | Provider applicationsapplication/json · ProviderApplications |
|---|---|
401 | Sign-in requiredapplication/json · Error |
409 | Provider preview is paused or an existing record changedapplication/json · Error |
503 | Verification service unavailableapplication/json · Error |
/v1/provider-applicationsWhen enabled, submits an ERO or Online Provider application for review. Use a secure evidence reference. Returned EFINs are masked.
application/json · ProviderApplicationInput
201 | Application is pending reviewapplication/json · ProviderApplication |
|---|---|
400 | Invalid JSON or requestapplication/json · Error |
401 | Sign-in requiredapplication/json · Error |
403 | Same-origin requiredapplication/json · Error |
409 | Provider preview is paused or an existing record changedapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
429 | Account application limit reachedapplication/json · Error |
503 | Verification service unavailableapplication/json · Error |
/v1/provider-applications/{id}/reviewWhen enabled, an assigned reviewer records a decision after comparing the applicant’s active role and EFIN with IRS evidence. Verified status expires after 90 days.
id · path · required · stringapplication/json · ProviderReview
200 | Decision recordedapplication/json · ProviderApplication |
|---|---|
400 | Invalid JSON or requestapplication/json · Error |
401 | Sign-in requiredapplication/json · Error |
403 | Assigned reviewer or same-origin requiredapplication/json · Error |
404 | Application not foundapplication/json · Error |
409 | Provider preview is paused or an existing record changedapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
503 | Verification service unavailableapplication/json · Error |
/v1/provider-verification/checkWhen enabled, checks that the provider record belongs to the authenticated owner and matches the role and EFIN. Verification must remain active.
application/json · ProviderCheckInput
200 | Active verificationapplication/json · ProviderCheck |
|---|---|
400 | Invalid JSON or requestapplication/json · Error |
403 | Service credential invalid or provider unverifiableapplication/json · Error |
409 | Provider preview is paused or an existing record changedapplication/json · Error |
413 | Request size limit exceededapplication/json · Error |
415 | Content-Type must be application/jsonapplication/json · Error |
422 | Invalid fields or fixtureapplication/json · Error |
503 | Verification service unavailableapplication/json · Error |
Optional outbound sandbox event. An operator configures one HTTPS destination. When enabled, a newly issued sandbox key includes the signing secret.
Parse TaxFileAPI-Signature: t=<unix seconds>,v1=<hex digest>. Use HMAC-SHA256 with the signing secret over the timestamp, one period, and the exact raw UTF-8 body. Compare digests safely, check timestamp freshness, deduplicate by event id, and return a 2xx only after accepting the event.
{
"id": "evt_tx_example",
"type": "transmission.acknowledged",
"data": {
"transmission_id": "tx_example",
"environment": "sandbox",
"status": "accepted"
}
}
The example shows selected fields. The full data object follows the Transmission schema. A later status request can retry delivery after a failure. Use polling for reconciliation.
Open a model to inspect each field, accepted value, and constraint.
{
"type": "object",
"additionalProperties": false,
"properties": {
"form": {
"type": "string",
"enum": [
"1042-S",
"1097-BTC",
"1098",
"1098-C",
"1098-E",
"1098-F",
"1098-Q",
"1098-T",
"1098-VLI",
"1099-A",
"1099-B",
"1099-C",
"1099-CAP",
"1099-DA",
"1099-DIV",
"1099-G",
"1099-INT",
"1099-K",
"1099-LPS",
"1099-LS",
"1099-LTC",
"1099-MISC",
"1099-NEC",
"1099-OID",
"1099-PATR",
"1099-Q",
"1099-QA",
"1099-R",
"1099-S",
"1099-SA",
"1099-SB",
"15397",
"3921",
"3922",
"5498",
"5498-ESA",
"5498-QA",
"5498-SA",
"5498-TA",
"8027",
"8596",
"8809",
"8955-SSA",
"W-2G"
],
"description": "See GET /v1/iris/forms for form-by-year availability."
},
"tax_year": {
"type": "integer",
"enum": [
2025,
2026
]
},
"header": {
"type": "object",
"additionalProperties": false,
"properties": {
"payer_ref": {
"const": "demo-payer"
}
},
"required": [
"payer_ref"
]
},
"records": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"record_id": {
"type": "string",
"pattern": "^demo-[a-z0-9-]{1,40}$"
},
"fields": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"recipient_ref": {
"const": "demo-recipient"
},
"nonemployee_compensation": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,7})\\.[0-9]{2}$"
}
},
"required": [
"recipient_ref",
"nonemployee_compensation"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"fixture_ref": {
"const": "demo-form-record"
}
},
"required": [
"fixture_ref"
]
}
]
}
},
"required": [
"record_id",
"fields"
]
}
},
"sandbox_scenario": {
"enum": [
"accepted",
"rejected",
"partially_accepted",
"delayed"
]
}
},
"required": [
"form",
"tax_year",
"header",
"records",
"sandbox_scenario"
]
}{
"type": "object",
"additionalProperties": false,
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"const": "insufficient_account_credits"
},
"message": {
"type": "string"
},
"credits_required": {
"type": "integer"
},
"transmission_id": {
"type": "string"
},
"approval_url": {
"type": "string"
},
"sandbox_wallet_url": {
"type": "string"
}
},
"required": [
"code",
"message",
"credits_required",
"transmission_id",
"approval_url",
"sandbox_wallet_url"
]
}
},
"required": [
"error"
]
}{
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"record_id": {
"type": [
"string",
"null"
]
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"record_id",
"field",
"message"
]
}{
"type": "object",
"additionalProperties": false,
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Finding"
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}{
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"enum": [
"accepted",
"rejected",
"partially_accepted"
]
},
"simulated": {
"const": true
},
"records": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"record_id": {
"type": "string"
},
"status": {
"enum": [
"accepted",
"rejected"
]
},
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Finding"
}
}
},
"required": [
"record_id",
"status",
"errors"
]
}
}
},
"required": [
"status",
"simulated",
"records"
]
}{
"type": "object",
"additionalProperties": false,
"properties": {
"transmission_id": {
"type": "string"
},
"environment": {
"const": "sandbox"
},
"status": {
"enum": [
"awaiting_approval",
"queued",
"accepted",
"rejected",
"partially_accepted"
]
},
"form": {
"type": "string"
},
"tax_year": {
"type": "integer"
},
"record_count": {
"type": "integer"
},
"price": {
"type": "object",
"additionalProperties": false,
"properties": {
"currency": {
"const": "USD"
},
"amount_cents": {
"const": 0
}
},
"required": [
"currency",
"amount_cents"
]
},
"credits": {
"type": "object",
"additionalProperties": false,
"properties": {
"required": {
"type": "integer"
},
"applied": {
"type": "integer"
},
"simulated": {
"const": true
}
},
"required": [
"required",
"applied",
"simulated"
]
},
"approval_url": {
"type": [
"string",
"null"
]
},
"status_url": {
"type": "string"
},
"receipt_id": {
"type": [
"string",
"null"
]
},
"acknowledgment": {
"anyOf": [
{
"$ref": "#/components/schemas/Acknowledgment"
},
{
"type": "null"
}
]
},
"sent_to_irs": {
"const": false
},
"irs_acceptance_verified": {
"const": false
},
"payment_charged": {
"const": false
}
},
"required": [
"transmission_id",
"environment",
"status",
"form",
"tax_year",
"record_count",
"price",
"credits",
"approval_url",
"status_url",
"receipt_id",
"acknowledgment",
"sent_to_irs",
"irs_acceptance_verified",
"payment_charged"
]
}{
"type": "object",
"properties": {
"channel": {
"const": "iris"
},
"tax_year": {
"type": "integer"
},
"processing_year": {
"type": "integer"
},
"sandbox": {
"type": "object",
"properties": {
"available": {
"type": "boolean"
},
"price_cents": {
"type": "integer"
},
"synthetic_only": {
"type": "boolean"
}
},
"required": [
"available",
"price_cents",
"synthetic_only"
],
"additionalProperties": false
},
"production": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"live_transmission_enabled": {
"type": "boolean"
},
"expected_irs_opening_month": {
"type": "string"
},
"confirmed_irs_opening_at": {
"type": [
"string",
"null"
]
},
"payment_method": {
"type": "string"
}
},
"required": [
"status",
"live_transmission_enabled",
"expected_irs_opening_month",
"confirmed_irs_opening_at",
"payment_method"
],
"additionalProperties": false
},
"irs_source_url": {
"type": "string"
}
},
"required": [
"channel",
"tax_year",
"processing_year",
"sandbox",
"production",
"irs_source_url"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"channel": {
"const": "iris"
},
"filing_season_url": {
"type": "string"
},
"forms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"form": {
"type": "string"
},
"tax_year": {
"type": "integer"
},
"schema_url": {
"type": "string"
},
"sandbox_batch": {
"type": "boolean"
},
"transmission_status": {
"type": "string"
},
"account_credit_pricing": {
"enum": [
"per_record",
"requires_form_specific_pricing"
]
}
},
"required": [
"form",
"tax_year",
"schema_url",
"sandbox_batch",
"transmission_status",
"account_credit_pricing"
],
"additionalProperties": false
}
}
},
"required": [
"channel",
"filing_season_url",
"forms"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"form": {
"type": "string"
},
"tax_year": {
"type": "integer"
},
"header": {
"type": "object"
},
"record": {
"type": "object"
},
"max_records": {
"type": "integer"
},
"submission_group": {
"type": "string"
}
},
"required": [
"form",
"tax_year",
"header",
"record"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"api_key": {
"type": "string"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"webhook_secret": {
"type": [
"string",
"null"
]
}
},
"required": [
"api_key",
"expires_at",
"webhook_secret"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"environment": {
"const": "sandbox"
},
"available": {
"type": "integer"
},
"payment_charged": {
"const": false
}
},
"required": [
"environment",
"available",
"payment_charged"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 2000
}
},
"required": [
"quantity"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"environment": {
"const": "sandbox"
},
"channels": {
"type": "object",
"properties": {
"iris": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"forms": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"forms"
],
"additionalProperties": false
}
}
},
"required": [
"iris"
],
"additionalProperties": false
}
},
"required": [
"environment",
"channels"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"channel": {
"const": "iris"
},
"form": {
"enum": [
"1099-NEC",
"1099-MISC",
"1099-INT",
"1099-DIV",
"1099-K",
"1099-DA",
"1099-A",
"1099-B",
"1099-C",
"1099-CAP",
"1099-G",
"1099-LPS",
"1099-LS",
"1099-LTC",
"1099-OID",
"1099-PATR",
"1099-Q",
"1099-QA",
"1099-R",
"1099-S",
"1099-SA",
"1099-SB",
"1098",
"1098-C",
"1098-E",
"1098-F",
"1098-Q",
"1098-T",
"1098-VLI",
"5498",
"5498-ESA",
"5498-QA",
"5498-SA",
"5498-TA",
"1042-S",
"1097-BTC",
"3921",
"3922",
"8027",
"8596",
"8809",
"8955-SSA",
"15397",
"W-2G"
]
},
"scenario": {
"enum": [
"accepted",
"rejected",
"pending"
]
}
},
"required": [
"channel",
"form",
"scenario"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"receipt_id": {
"type": "string"
},
"acknowledgment_url": {
"type": "string"
},
"environment": {
"const": "sandbox"
},
"status": {
"const": "received"
},
"sent_to_irs": {
"const": false
},
"payment_charged": {
"const": false
}
},
"required": [
"receipt_id",
"acknowledgment_url",
"environment",
"status",
"sent_to_irs",
"payment_charged"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"receipt_id": {
"type": "string"
},
"environment": {
"const": "sandbox"
},
"channel": {
"enum": [
"iris",
"mef"
]
},
"form": {
"type": "string"
},
"status": {
"enum": [
"accepted",
"rejected",
"pending"
]
},
"sent_to_irs": {
"const": false
},
"irs_acceptance_verified": {
"const": false
},
"payment_charged": {
"const": false
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"receipt_id",
"environment",
"channel",
"form",
"status",
"sent_to_irs",
"irs_acceptance_verified",
"payment_charged"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"environment": {
"const": "sandbox"
},
"channel": {
"const": "mef"
},
"tax_year": {
"const": 2026
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"forms": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"label",
"forms"
],
"additionalProperties": false
}
},
"fixtures": {
"type": "array",
"items": {
"enum": [
"complete",
"missing_information"
]
}
},
"production": {
"type": "object",
"properties": {
"enabled": {
"const": false
},
"credential_verification_required": {
"const": true
},
"accepted_provider_roles": {
"type": "array",
"items": {
"enum": [
"ero",
"online_provider"
]
}
}
},
"required": [
"enabled",
"credential_verification_required",
"accepted_provider_roles"
],
"additionalProperties": false
}
},
"required": [
"environment",
"channel",
"tax_year",
"groups",
"fixtures",
"production"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"tax_year": {
"const": 2026
},
"form": {
"enum": [
"1040",
"1040-NR",
"1041",
"2350",
"4868",
"9465",
"1065",
"1120",
"1120-S",
"1120-F",
"1120-POL",
"1042",
"7004",
"990",
"990-EZ",
"990-PF",
"990-T",
"4720",
"5227",
"5330",
"8868",
"8038-CP",
"940",
"941",
"941-X",
"943",
"943-X",
"944",
"944-X",
"945",
"945-X",
"94x-PIN",
"720",
"2290",
"8849",
"1045-IND",
"1045-EST",
"1139",
"56",
"706",
"709",
"8892"
]
},
"fixture": {
"enum": [
"complete",
"missing_information"
]
}
},
"required": [
"tax_year",
"form",
"fixture"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"draft_id": {
"type": "string"
},
"channel": {
"const": "mef"
},
"environment": {
"const": "sandbox"
},
"form": {
"type": "string"
},
"form_family": {
"type": "string"
},
"tax_year": {
"const": 2026
},
"status": {
"enum": [
"prepared",
"needs_information"
]
},
"inputs": {
"type": "object",
"properties": {
"filer_ref": {
"type": [
"string",
"null"
]
},
"tax_year": {
"const": 2026
},
"form": {
"type": "string"
}
},
"required": [
"filer_ref",
"tax_year",
"form"
],
"additionalProperties": false
},
"findings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Finding"
}
},
"simulation": {
"type": "object",
"properties": {
"irs_schema_validated": {
"const": false
},
"return_calculated": {
"const": false
},
"sent_to_irs": {
"const": false
},
"payment_charged": {
"const": false
}
},
"required": [
"irs_schema_validated",
"return_calculated",
"sent_to_irs",
"payment_charged"
],
"additionalProperties": false
}
},
"required": [
"draft_id",
"channel",
"environment",
"form",
"form_family",
"tax_year",
"status",
"inputs",
"findings",
"simulation"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"legal_name": {
"type": "string",
"minLength": 2,
"maxLength": 160
},
"contact_email": {
"type": "string",
"format": "email",
"maxLength": 254
},
"role": {
"enum": [
"ero",
"online_provider"
]
},
"efin": {
"type": "string",
"pattern": "^[0-9]{6}$"
},
"evidence_ref": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.:-]{3,79}$"
}
},
"required": [
"legal_name",
"contact_email",
"role",
"efin",
"evidence_ref"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"contact_email": {
"type": "string"
},
"role": {
"enum": [
"ero",
"online_provider"
]
},
"efin_last_four": {
"type": "string"
},
"status": {
"enum": [
"pending",
"verified",
"expired",
"rejected",
"revoked"
]
},
"submitted_at": {
"type": "string"
},
"verified_until": {
"type": [
"string",
"null"
]
},
"review_reason": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"legal_name",
"contact_email",
"role",
"efin_last_four",
"status",
"submitted_at",
"verified_until",
"review_reason"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"applications": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProviderApplication"
}
},
"review_configured": {
"type": "boolean"
}
},
"required": [
"applications",
"review_configured"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"decision": {
"enum": [
"verified",
"rejected",
"revoked"
]
},
"reason": {
"type": "string",
"minLength": 12,
"maxLength": 400
},
"matched_efin": {
"type": "string"
},
"confirmed_active_role": {
"type": "string"
},
"verified_evidence_ref": {
"type": "string"
},
"matched_legal_name": {
"type": "string"
}
},
"required": [
"decision",
"reason",
"matched_efin",
"confirmed_active_role",
"verified_evidence_ref",
"matched_legal_name"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"provider_id": {
"type": "string",
"pattern": "^prov_[a-f0-9]{32}$"
},
"owner_id": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"role": {
"enum": [
"ero",
"online_provider"
]
},
"efin": {
"type": "string",
"pattern": "^[0-9]{6}$"
}
},
"required": [
"provider_id",
"owner_id",
"role",
"efin"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"provider_id": {
"type": "string"
},
"verified": {
"const": true
},
"verified_until": {
"type": "string"
}
},
"required": [
"provider_id",
"verified",
"verified_until"
],
"additionalProperties": false
}