Skip to content
Constaia
us_paystub

US pay stub

Pay period, gross pay, deductions, net pay and year-to-date totals, with the arithmetic checked.

Category
Employment
Country
United States
Fields it extracts
16 fields
Cost
1 credit
us_paystubspecimen
Employer name
Employer address
Employee name
Employee id
Ssn last4
Pay period start
Pay period end
Pay date
Pay frequency

Constaia extracts the period, the pay date and the amounts, checks that gross pay minus deductions equals net pay and that the year-to-date totals are consistent, and verifies that the pay stub is recent and in the applicant's name.

  • Figures that add up are a signal, not proof.

What it checks

  • Holder. Name, number or date of birth match what you expect.
  • Recency. Issued less than N days ago.

Fields it extracts

  • Employer nameemployer_name
  • Employer addressemployer_address
  • Employee nameemployee_name
  • Employee idemployee_id
  • Ssn last4ssn_last4
  • Pay period startpay_period_start
  • Pay period endpay_period_end
  • Pay datepay_date
  • Pay frequencypay_frequency
  • Hourshours
  • Raterate
  • Gross paygross_pay
  • Net paynet_pay
  • Year-to-date grossytd_gross
  • Year-to-date netytd_net
  • Deductionsdeductions

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_paystub_specimen.pdf" \
  -F 'options={
    "expect": "us_paystub",
    "checks": {
      "max_age_days": 45,
      "reference_date": "2026-10-01",
      "holder": {
        "full_name": "Jordan Specimen"
      }
    },
    "storage": "none"
  }'

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

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_paystub",
    "label": "US pay stub",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_paystub"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: US pay stub."
      }
    ]
  },
  "fields": {
    "employee_name": {
      "value": "JORDAN SPECIMEN",
      "confidence": 0.99,
      "validated": true
    },
    "employer_name": {
      "value": "EXAMPLE LOGISTICS INC",
      "confidence": 0.98,
      "validated": null
    },
    "pay_period_start": {
      "value": "2026-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "pay_period_end": {
      "value": "2026-09-15",
      "confidence": 0.96,
      "validated": null
    },
    "pay_date": {
      "value": "2026-09-19",
      "confidence": 0.99,
      "validated": null
    },
    "pay_frequency": {
      "value": "semimonthly",
      "confidence": 0.98,
      "validated": null
    },
    "gross_pay": {
      "value": 2426.69,
      "confidence": 0.97,
      "validated": null
    },
    "deductions_total": {
      "value": 612.4,
      "confidence": 0.96,
      "validated": null
    },
    "net_pay": {
      "value": 1814.29,
      "confidence": 0.99,
      "validated": null
    },
    "ytd_gross": {
      "value": 41253.73,
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "pay_period_math",
      "passed": true,
      "message": "Gross, deductions and net add up."
    },
    {
      "code": "max_age_days",
      "passed": true,
      "message": "The issue date is within the limit."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    }
  ],
  "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.