Vendors

Review and file a returned vendor W-9

Files a PDF/image that arrived on the vendor's tracked W-9 request. Records the original protected attachment, request, tax year, reviewer, and received date; then marks the vendor W-9 received and resolves the request. Outbound or unrelated attachments cannot be filed. This route and the W-9 request route are the only writers of a vendor's w9Status: ordinary vendor create/update cannot mark a W-9 received. The stored tax year is collection provenance, not an annual expiry. Requires manage:contacts and an idempotency-key header.

post/vendors/{id}/w9-file

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/vendors/{id}/w9-file
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Path parameters

idstring uuid required

Vendor (contact) UUID

Request body

requestIdstring uuid required
attachmentIdstring uuid required
taxYearinteger required

Response

Idempotent replay

Changes

No recorded changes to this operation across all 5 revisions of this API.