Skip to content
Constaia
us_w9

IRS Form W-9

Name, tax classification, TIN and signature from IRS Form W-9.

Category
Tax
Country
United States
Fields it extracts
11 fields
Cost
1 credit
us_w9specimen
Name
Business name
Federal tax classification
Exempt payee code
Address
Postal code
Social Security number (SSN)
Ein
Signature present

Before you pay a contractor in the US you need their taxpayer identification number (TIN) to file Form 1099. Constaia reads the W-9, checks the format of the SSN or EIN, compares the name and confirms that the form is signed and dated.

  • The format check does not replace the IRS TIN Matching service.

What it checks

  • National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).us_tin, us_ein, us_zip
  • Postal code. Postal code format of the country.
  • Holder. Name, number or date of birth match what you expect.
  • Recency. Issued less than N days ago.

Fields it extracts

  • Namename
  • Business namebusiness_name
  • Federal tax classificationtax_classification
  • Exempt payee codeexempt_payee_code
  • Addressaddress
  • Postal codepostal_code
  • Social Security number (SSN)ssn
  • Einein
  • Signature presentsignature_present
  • Signature datesignature_date
  • Form revisionform_revision

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_w9_specimen.pdf" \
  -F 'options={
    "expect": "us_w9",
    "checks": {
      "require_signature": true,
      "holder": {
        "full_name": "Acme Example Services LLC"
      }
    },
    "storage": "none"
  }'

Try it for free in test mode with the file us_w9_specimen.pdf.

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_w9",
    "label": "IRS Form W-9",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_w9"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: IRS Form W-9."
      }
    ]
  },
  "fields": {
    "form_revision": {
      "value": "Rev. March 2024",
      "confidence": 0.99,
      "validated": true
    },
    "holder_name": {
      "value": "ACME EXAMPLE SERVICES LLC",
      "confidence": 0.98,
      "validated": null
    },
    "tax_classification": {
      "value": "LLC (S corporation)",
      "confidence": 0.97,
      "validated": null
    },
    "tin_type": {
      "value": "EIN",
      "confidence": 0.96,
      "validated": null
    },
    "tin": {
      "value": "12-3456789",
      "confidence": 0.99,
      "validated": null
    },
    "signature_present": {
      "value": true,
      "confidence": 0.98,
      "validated": null
    },
    "signature_date": {
      "value": "2026-09-18",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "ein_format",
      "passed": true,
      "message": "The EIN has a valid format."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    },
    {
      "code": "signature_present",
      "passed": true,
      "message": "It is signed."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove that the document is authentic?

No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.

Is a copy of the document kept?

Only if it needs review: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is deleted as soon as the analysis ends. You can choose never to keep it.

Other documents

And for the record…

Create your free account and validate your first document in five minutes. No card required.