Folder

Field	Type	Notes
name	String(64)
info	String(64)	Folder description
user_id	BigInteger	Folder owner
company_id	BigInteger	Company that controls the folder
verification_status_id	BigInteger	See verification_status_id
media_id	BigInteger
website_url	String(255)
public_key	String(64)
spk	String(192)	Signed Public Prekey
signature	String(1024)
vat	String(64)	Value-added tax number (i.e. LU123456)

verification_status_id

A folder (and every card type) must be verified by Sita Software. This field represent the status of the verification and can have the following values:

Value	Description
1	Unverified ⚠️
2	Pending Verification ⌛
3	Verified ✅

Create a company folder

A folder has a user_id and can optionally be assigned to a company_id. Folders created from Mobile apps don't have a company_id.

To create a folder and assign it to a company:

Create a company and assign it to the company_id 3.

Please note that you need to have the permission ADD_FOLDER_TO_COMPANY before assigning a folder to a specific company. If you created the company you are the role COMPANY_ADMIN which gives you such permission as part of your role.

Assign a company to an existing folder

To assign a company to an existing folder you must meet the following conditions:

• You are the owner of the folder (folder user_id)

• You have the permissions ADD_FOLDER_TO_COMPANY for the company that you are trying to assign. (If you are a COMPANY_ADMIN you automatically such permission, if you created a company yourself you get the COMPANY_ADMIN role)

Use the following API:

Assign a company to an existing folder