E-File Magic

W-9 requests

List W-9 requests

Find W-9 requests and track their collection status.

GET
/api/v1/w9/requests/list
Authentication
OAuth 2.0 access token
Required scopes
w9.read
Idempotency key
Not required
Rate-limit cost
2 units

Request fields

8 fields
query.qOptionalstring

Search text used to filter this collection. Maximum characters: 256.

query.statusOptionalstring

Allowed values: "pending_dispatch", "sent", "opened", "otp_verified", "submitted", "converted", "canceled", "expired", "email_failed".

query.issuer_idOptionalstring (uuid)

ID of the sender issuing the W-9 request.

query.dispatch_eligibleOptionalboolean

Type: boolean.

query.sort_byOptionalstring

Field used to order results. Allowed values: "updated_at", "relevance".

query.sort_orderOptionalstring

Ascending or descending result order. Allowed values: "asc", "desc".

query.limitOptionalinteger

Maximum number of results requested for this page. Minimum: 1. Maximum: 100.

query.cursorOptionalstring

Opaque next_cursor from the previous page. Keep the other filters unchanged. Minimum characters: 1. Maximum characters: 2048.

Headers (2)
AuthorizationRequired
OAuth RS256 access token issued for the EFM API resource. Interactive EFM session tokens are rejected.
DPoPConditional / optional
Required when the application, connection, or credential is proof-of-possession bound.
cURL request
curl --request GET 'https://api.efilemagic.com/api/v1/w9/requests/list' \
  --header 'Authorization: Bearer <access-token>' \
  --get \
  --data-urlencode 'limit=25'

Replace placeholders with your own values. Use the API resource origin provided for your environment.