Some onboardings need documents that are not part of the company's data.
| Endpoint | Use it to |
|---|---|
| Upload a document, list documents, delete a document | Provide the IRS EIN letter, business formation documents and, when you capture them, pictures of IDs. |
| Upload the certificate of authority | Show that a signer who is neither a control person nor an owner may sign for the company. |
| Create a payroll history upload session | Let the company's admin upload its payroll history in your product. Recommended. |
| Get payroll history, upload a payroll history file, delete a payroll history file | Provide 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 file | The original payroll history upload. It files the same way. |
What every company provides
| Document | Kind | Rule |
|---|---|---|
| IRS EIN letter | IRS_EIN_LETTER | Required before the signature is requested. A new upload replaces the last. |
| Business formation documents | BUSINESS_FORMATION | Required before the signature is requested. You can add several. |
| Certificate of authority | See above | Only when the signer is neither the control person nor an owner. |
| Picture ID | PICTURE_ID | One 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.