E-File Magic

W-9 requests

Get W-9 issuers

Read several W-9 request issuers and identify missing IDs.

POST
/api/v1/w9/issuers/get_many
Authentication
OAuth 2.0 access token
Required scopes
w9.read
Idempotency key
Not required
Rate-limit cost
2 units

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

Response fields

2 fields
itemsAlways returnedarray<object>

Maximum items: 100.

Nested fields (28)

address_line1May be omittedstring | null

Maximum characters: 512.

address_line2May be omittedstring | null

Maximum characters: 512.

arch_bucketAlways returnedstring | null

Maximum characters: 512.

cityMay be omittedstring | null

Maximum characters: 512.

contact_emailMay be omittedstring | null

Maximum characters: 512.

contact_nameMay be omittedstring | null

Maximum characters: 512.

countryMay be omittedstring | null

Maximum characters: 512.

created_atAlways returnedstring (date-time)

Type: string (date-time).

dba_nameMay be omittedstring | null

Maximum characters: 512.

display_nameAlways returnedstring | null

Maximum characters: 512.

entity_type_cdMay be omittedstring | null

Maximum characters: 512.

is_archivedAlways returnedboolean

Type: boolean.

issuer_idAlways returnedstring (uuid)

Type: string (uuid).

legal_nameAlways returnedstring | null

Maximum characters: 512.

name1May be omittedstring | null

Maximum characters: 512.

name2May be omittedstring | null

Maximum characters: 512.

person_first_nmMay be omittedstring | null

Maximum characters: 512.

person_last_nmMay be omittedstring | null

Maximum characters: 512.

person_middle_nmMay be omittedstring | null

Maximum characters: 512.

person_suffix_nmMay be omittedstring | null

Maximum characters: 512.

phoneMay be omittedstring | null

Maximum characters: 512.

postal_codeMay be omittedstring | null

Maximum characters: 512.

source_idMay be omittedstring (uuid) | null

Type: string (uuid) | null.

source_typeAlways returnedstring | null

Maximum characters: 512.

stateMay be omittedstring | null

Maximum characters: 512.

statusAlways returnedstring | null

Maximum characters: 512.

updated_atAlways returnedstring (date-time)

Type: string (date-time).

versionAlways returnedinteger

Minimum: 1.

missingAlways returnedarray<string (uuid)>

Maximum items: 100.

Complete response schema: ApiV1W9IssuerGetManyResponse

Structure · HTTP 200
{
  "data": {
    "items": "array<object>",
    "missing": "array<string (uuid)>"
  },
  "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.