The mailing attempt object

🚧
Contractor 1099-NEC mailing
Check does not mail contractor 1099-NEC statements yet. 1099 mailing will be available in the future.

The MailingAttempt Object

Fields non-nullable unless specified.

field	type	description
`id`	ID	ID of the `MailingAttempt`. Begins with `mat_`.
`statement_type`	enum	Type of tax statement that was mailed. One of `employee_tax_statement` or `contractor_tax_statement`.
`statement_id`	ID	ID of the mailed statement. An employee tax statement ID when `statement_type` is `employee_tax_statement`, or a contractor tax statement ID when `statement_type` is `contractor_tax_statement`.
`recipient_address`	object	Name and address the letter was mailed to. See Recipient address.
`status`	enum	Delivery status of the letter. One of `scheduled`, `printed`, `in_transit`, `delivered`, or `cancelled`.
`status_history`	list of objects	Status changes recorded for the letter. See Status history.

Recipient address

field	type	description
`name`	string	Name of the recipient.
`line1`	string	First line of the street address.
`line2`	nullable string	Second line of the street address.
`city`	string	City.
`state`	string	Two-letter state abbreviation.
`postal_code`	string	ZIP code.

Status history

field	type	description
`status`	enum	Status the letter moved to. One of `scheduled`, `printed`, `in_transit`, `delivered`, or `cancelled`.
`status_at`	datetime in UTC	ISO8601 datetime when the status was recorded.

GET /mailing_attempts/mat_123

A mailing attempt for an employee's W-2.

{
  "id": "mat_123",
  "statement_type": "employee_tax_statement",
  "statement_id": "ets_456",
  "recipient_address": {
    "name": "Jane Doe",
    "line1": "123 Main St",
    "line2": "Apt 4",
    "city": "New York",
    "state": "NY",
    "postal_code": "10001"
  },
  "status": "in_transit",
  "status_history": [
    {
      "status": "scheduled",
      "status_at": "2026-01-20T15:00:00Z"
    },
    {
      "status": "printed",
      "status_at": "2026-01-21T12:30:00Z"
    },
    {
      "status": "in_transit",
      "status_at": "2026-01-22T09:15:00Z"
    }
  ]
}

GET /mailing_attempts/mat_789

A mailing attempt for a contractor's 1099-NEC.

{
  "id": "mat_789",
  "statement_type": "contractor_tax_statement",
  "statement_id": "cts_456",
  "recipient_address": {
    "name": "John Smith",
    "line1": "500 Market St",
    "line2": null,
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "status": "delivered",
  "status_history": [
    {
      "status": "scheduled",
      "status_at": "2026-01-20T15:00:00Z"
    },
    {
      "status": "printed",
      "status_at": "2026-01-21T12:30:00Z"
    },
    {
      "status": "in_transit",
      "status_at": "2026-01-22T09:15:00Z"
    },
    {
      "status": "delivered",
      "status_at": "2026-01-26T17:45:00Z"
    }
  ]
}