E-File Magic

Orders

Submit an order

Purchase the selected services and submit an order for processing.

POST
/api/v1/orders/submit
Authentication
OAuth 2.0 access token
Required scopes
orders.submit
Idempotency key
Required
Rate-limit cost
100 units

On success, data contains the fields below. meta includes api_version and request_id. Keep request_id when reporting a problem.

Response fields

4 fields
funding_kindAlways returnedstring

Allowed values: "deposit", "terms", "vaulted_instrument".

orderAlways returnedobject

Unknown fields are rejected.

Nested fields (4)

invoiceAlways returnedobject

Type: object.

orderAlways returnedobject

Unknown fields are rejected.

Nested fields (33)

balance_due_minorAlways returnedinteger

Minimum: 0.

created_atAlways returnedstring (date-time)

Type: string (date-time).

currencyAlways returned"USD"

Value: "USD".

customer_deposit_applied_minorAlways returnedinteger

Minimum: 0.

customer_deposit_reserved_minorAlways returnedinteger

Minimum: 0.

filer_idAlways returnedstring (uuid)

Type: string (uuid).

from_importAlways returnedboolean

Type: boolean.

fulfillment_statusAlways returnedstring

Type: string.

holdAlways returnedobject

Type: object.

import_run_idMay be omittedstring | null

Type: string | null.

import_sourceMay be omittedstring | null

Type: string | null.

imported_atMay be omittedstring (date-time) | null

Type: string (date-time) | null.

last_errorMay be omittedstring | null

Type: string | null.

order_idAlways returnedstring (uuid)

Type: string (uuid).

payment_due_minorAlways returnedinteger

Minimum: 0.

payment_statusAlways returnedstring

Type: string.

public_order_refMay be omittedstring | null

Type: string | null.

snapshot_chunk_completedAlways returnedinteger

Minimum: 0.

snapshot_chunk_totalAlways returnedinteger

Minimum: 0.

snapshot_copied_recipientsAlways returnedinteger

Minimum: 0.

snapshot_statusAlways returnedstring

Type: string.

snapshot_total_recipientsAlways returnedinteger

Minimum: 0.

source_digestMay be omittedstring | null

Type: string | null.

source_external_idMay be omittedstring | null

Type: string | null.

source_external_refMay be omittedstring | null

Type: string | null.

source_filing_systemMay be omittedstring | null

Type: string | null.

source_platformMay be omittedstring | null

Type: string | null.

statusAlways returnedstring

Type: string.

tax_yearMay be omittedinteger | null

Type: integer | null.

tenant_idAlways returnedstring (uuid)

Type: string (uuid).

total_minorAlways returnedinteger

Minimum: 0.

updated_atAlways returnedstring (date-time)

Type: string (date-time).

versionAlways returnedinteger

Minimum: 1.

order_confirmationAlways returnedobject

Type: object.

servicesAlways returnedarray<object>

Type: array<object>.

payment_statusAlways returnedstring

Type: string.

policy_versionAlways returnedinteger

Minimum: 1.

Complete response schema: ApiV1OrderSubmitResponse

Structure · HTTP 200
{
  "data": {
    "funding_kind": "string",
    "order": "object",
    "payment_status": "string",
    "policy_version": "integer"
  },
  "meta": {
    "api_version": "v1",
    "request_id": "string"
  }
}

Successful response structure. This outline shows field types, not a response to copy. Expand Response fields for nested properties and optional values.