Search tax form submission rows

get

https://api.wingspan.app/v3/search/tax-form-submission-rows

Query the payer seat's 1099 filing rows: one row per tax form submission, carrying the derived filing status the tax filing screens badge (the tax form's status until the submission is filed, the submission's status after) and the tax form's correction state. Every filter runs inside the Atlas $search pipeline; default sort is updatedAt descending. Rows carry no recipient identity, W-9, or TIN; read the recipient from the payee (payeeAccountId). Account scope is enforced server-side (no filter[accountIds] — target a child account via X-Wingspan-Account).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

object

Pagination query parameters. Serializes as page[size], page[token], page[mode], and page[resultSetId].

sort

object

QueryQL sort namespace for tax form submission rows, sort[field]=asc|desc — exactly one field. updatedAt addresses the row's events.updatedAt; amount addresses the row's 1099 total. Default when omitted: updatedAt descending.

filter

object

QueryQL filter namespace; same serialization and operator rules as /search/payee-rows. x-legacy-filter names the legacy /search/tax-form-submission-row filter each field corresponds to. No free-text searchString and no dynamic paths are accepted on this seat.

Headers

X-Wingspan-Account

string

^(?:[A-Za-z0-9_.]{22}|[a-f0-9]{24})$

Select the Account for an Account-scoped operation. A direct ServiceAccount API key MUST supply this header, and the target must be within the ServiceAccount owner's or Authorization grant's Account boundary. A Person bearer may select an Account on which it has an active Stakeholder, and an Account session may select its bound Account (or a descendant only when the session explicitly includes descendants).

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Tax form submission row search results

400Malformed request syntax

401Unauthenticated

403Forbidden

422Validation error