📎 Supporting documents

Some onboardings need documents that are not part of the company's data.

EndpointUse it to
Upload a document, list documents, delete a documentProvide the IRS EIN letter, business formation documents and, when you capture them, pictures of IDs.
Upload the certificate of authorityShow that a signer who is neither a control person nor an owner may sign for the company.
Create a payroll history upload sessionLet the company's admin upload its payroll history in your product. Recommended.
Get payroll history, upload a payroll history file, delete a payroll history fileProvide the company's payroll history for the year so far yourself, and see Everee's review of it. See Payroll history and going live.
Upload a year-to-date payroll fileThe original payroll history upload. It files the same way.

What every company provides

DocumentKindRule
IRS EIN letterIRS_EIN_LETTERRequired before the signature is requested. A new upload replaces the last.
Business formation documentsBUSINESS_FORMATIONRequired before the signature is requested. You can add several.
Certificate of authoritySee aboveOnly when the signer is neither the control person nor an owner.
Picture IDPICTURE_IDOne for the control person, each owner of 25% or more, and a signer who is neither. See below.

Which of these are required is decided by Everee and can change as its verification improves. Follow readiness.missing and the required flag of each kind in List documents, not a fixed list. A document that is not required is still accepted when you send it. A requirement can also change while a company is in progress; see Requirements can change.

Pictures of IDs

By default Everee's identity provider captures each person's ID when they verify, so you upload nothing. If Everee has set your account up so that you capture them for your customers (journey.documentCapture in the status is PARTNER), upload the front and back of each person's ID (the front only for a passport) with their personRef (control-person, owner-<id> or signer) and side (FRONT or BACK). Until every picture is in, PICTURE_ID appears in readiness.missing. When Everee's identity provider captures them (ALLOY), uploading a picture ID returns 409.

Files are uploaded as multipart/form-data with a file part. The certificate of authority must be a PDF; other documents can be a PDF, PNG or JPEG, up to 25 MB.

Documents Everee asks for during review are sent with the review requests endpoints instead. This includes a document Everee rejected: Everee opens a request for it, with the reason, and you answer it with a replacement.

For when you need the certificate of authority, see Certificate of authority in the collecting-information guide.