Aller au contenu
Constaia
us_w2

Formulaire W-2 (IRS)

Employeur, EIN, salaires et retenues d'un W-2.

Catégorie
Fiscalité
Pays
États-Unis
Champs extraits
15 champs
Coût
1 crédit
us_w2specimen
Année fiscale
EIN de l'employeur
Employer
SSN du salarié
Nom du salarié
Employee address
Salaires, pourboires et autres rémunérations
Federal income tax withheld
Salaires soumis à la sécurité sociale

Constaia extrait l'année fiscale, l'employeur, l'EIN et les montants des cases, vérifie les formats de l'EIN et du SSN et compare le nom du salarié.

Ce qui est contrôlé

  • Identifiants nationaux. Clé de contrôle ou format officiel du numéro (NIR, NIF, CPF, CURP…).us_ein, us_ssn
  • Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.

Champs extraits

  • Année fiscaletax_year
  • EIN de l'employeuremployer_ein
  • Employeremployer
  • SSN du salariéemployee_ssn
  • Nom du salariéemployee_name
  • Employee addressemployee_address
  • Salaires, pourboires et autres rémunérationswages
  • Federal income tax withheldfederal_income_tax_withheld
  • Salaires soumis à la sécurité socialesocial_security_wages
  • Social security tax withheldsocial_security_tax_withheld
  • Salaires soumis à Medicaremedicare_wages
  • Medicare tax withheldmedicare_tax_withheld
  • Étatstate
  • Salaires de l'Étatstate_wages
  • State income taxstate_income_tax

Exemple de requête

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_w2_specimen.pdf" \
  -F 'options={
    "expect": "us_w2",
    "checks": {
      "holder": {
        "full_name": "Jordan Specimen"
      },
      "require_fields": [
        "wages",
        "tax_year"
      ]
    },
    "storage": "none"
  }'

Essayez gratuitement avec une clé ck_test_ et le fichier us_w2_specimen.pdf.

Exemple de réponse

Données fictives. Réponse abrégée.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_w2",
    "label": "Formulaire W-2 (IRS)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_w2"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Formulaire W-2 (IRS)."
      }
    ]
  },
  "fields": {
    "tax_year": {
      "value": 2025,
      "confidence": 0.99,
      "validated": true
    },
    "employee_name": {
      "value": "JORDAN L SPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "employee_ssn": {
      "value": "XXX-XX-6789",
      "confidence": 0.97,
      "validated": null
    },
    "employer_name": {
      "value": "EXAMPLE LOGISTICS INC",
      "confidence": 0.96,
      "validated": null
    },
    "employer_ein": {
      "value": "12-3456789",
      "confidence": 0.99,
      "validated": null
    },
    "wages": {
      "value": 58240.5,
      "confidence": 0.98,
      "validated": null
    },
    "federal_tax_withheld": {
      "value": 6120,
      "confidence": 0.97,
      "validated": null
    },
    "state": {
      "value": "IL",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "ein_format",
      "passed": true,
      "message": "L'EIN a un format valide."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "Le titulaire correspond."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Constaia prouve-t-il que le document est authentique ?

Non. Il contrôle le type, la cohérence des données et vos règles, et signale des indices comme une possible retouche ou une photo d'écran. Cela ne prouve pas l'authenticité.

Une copie du document est-elle conservée ?

Non, sauf si vous le demandez. Avec storage "none" (par défaut), le fichier est supprimé à la fin de l'analyse.

Autres documents

Et pour valoir ce que de droit…

Créez votre compte, copiez la clé de test et validez votre premier document en cinq minutes.