E-File Magic

W-9 requests

Import W-9 request rows

Create a W-9 import from rows supplied in the request.

POST
/api/v1/w9/imports/create
Authentication
OAuth 2.0 access token
Required scopes
w9.write
Idempotency key
Required
Rate-limit cost
5 units

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

Response fields

20 fields
content_typeMay be omittedstring | null

Type: string | null.

created_atAlways returnedstring (date-time)

Type: string (date-time).

created_byAlways returnedobject

Type: object.

created_by_user_idMay be omittedstring (uuid) | null

Type: string (uuid) | null.

dispatch_requestedAlways returnedboolean

Type: boolean.

dispatched_countAlways returnedinteger

Minimum: 0.

file_nameAlways returnedstring

Type: string.

issuer_idMay be omittedstring (uuid) | null

Type: string (uuid) | null.

notify_emailMay be omittedstring (email) | null

Type: string (email) | null.

request_count_createdAlways returnedinteger

Minimum: 0.

row_count_processedAlways returnedinteger

Minimum: 0.

row_count_totalAlways returnedinteger

Minimum: 0.

Complete response schema: ApiV1W9ImportSubmission

Structure · HTTP 200
{
  "data": {
    "content_type": "string | null",
    "created_at": "string (date-time)",
    "created_by": "object",
    "created_by_user_id": "string (uuid) | null",
    "dispatch_requested": "boolean",
    "dispatched_count": "integer",
    "file_name": "string",
    "issuer_id": "string (uuid) | null",
    "notify_email": "string (email) | null",
    "request_count_created": "integer",
    "row_count_processed": "integer",
    "row_count_total": "integer",
    "rows_per_chunk": "integer",
    "size_bytes": "integer | null",
    "skipped_count": "integer",
    "source_stage_completed": "boolean",
    "status": "string",
    "submission_id": "string (uuid)",
    "updated_at": "string (date-time)",
    "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.