Skip to main content

Company APIs

More about Company API

Deskera - Company Management

/auth/account/merge​

POST​

Summary​

Merge accounts

Description​

API to merge duplicate accounts.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesMergeAccountDto
Responses​
CodeDescriptionSchema
200OK
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/affiliatesignup​

POST​

Summary​

Signup an affiliate user

Description​

Incoming IAM mobile signup request to create affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
affiliateSignupRequestbodyaffiliateSignupRequestYesAffiliateSignupRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/apisid/{apisid}​

GET​

Summary​

APISID API

Description​

APISID API

Parameters​
NameLocated inDescriptionRequiredSchema
apisidpathapisidYesstring
Responses​
CodeDescriptionSchema
200APISID successfulboolean
400APISID failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/checkcontact​

POST​

Summary​

check if Phone number exists in Platform

Description​

API to check if Phone number exists in Platform

Parameters​
NameLocated inDescriptionRequiredSchema
contactCheckRequestbodycontactCheckRequestYesContactCheckRequest
Responses​
CodeDescriptionSchema
200ContactTenantInfo
201Created
401Unauthorized
403Forbidden
404API failed
Security​
Security SchemaScopes
Authorizationglobal

/auth/confirmforgotpassword​

POST​

Summary​

Confirm forgot password

Description​

Confirm forgot password

Parameters​
NameLocated inDescriptionRequiredSchema
confirmForgotPassRequestbodyconfirmForgotPassRequestYesConfirmForgotPassRequest
Responses​
CodeDescription
200User has set new password successfully.
201Created
400User's new password request failed.
401Unauthorized
403Forbidden
404User's new password request failed.
Security​
Security SchemaScopes
Authorizationglobal

/auth/email/verify​

PUT​

Summary​

/email/verify

Description​

Email verification API

Parameters​
NameLocated inDescriptionRequiredSchema
userDtobodyuserDtoYesUserDto
Responses​
CodeDescription
200Email has been verified successfully.
201Created
401Unauthorized
403Forbidden
404The Confirmation link is invalid. Please generate a new confirmation link.
410Email Token has been expired.
Security​
Security SchemaScopes
Authorizationglobal

/auth/forgotpassword​

POST​

Summary​

Forgot password

Description​

Forgot password

Parameters​
NameLocated inDescriptionRequiredSchema
forgotPasswordRequestbodyforgotPasswordRequestYesForgotPasswordRequest
Responses​
CodeDescription
200Confirmation code has been sent successfully.
201Created
400Failed to initiate forgot password confirmation code.
401Unauthorized
403Forbidden
404Failed to initiate forgot password confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

/auth/getnewtokens​

POST​

Summary​

Get new tokens in case existing is expired

Description​

Get new tokens in case existing is expired

Parameters​
NameLocated inDescriptionRequiredSchema
newTokenRequestbodynewTokenRequestYesNewTokenRequest
Responses​
CodeDescriptionSchema
200Confirmation code has been sent successfully.AuthenticationResultType
201Created
400Failed to initiate sign in confirmation code.
401Unauthorized
403Forbidden
404Failed to initiate sign in confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

/auth/getrefreshtoken​

POST​

Summary​

Get new tokens using tenantid in case existing is expired

Description​

Get new tokens using tenantid in case existing is expired

Parameters​
NameLocated inDescriptionRequiredSchema
refreshTokenRequestbodyrefreshTokenRequestYesRefreshTokenRequest
Responses​
CodeDescriptionSchema
200Confirmation code has been sent successfully.AuthenticationResultType
201Created
400Failed to initiate sign in confirmation code.
401Unauthorized
403Forbidden
404Failed to initiate sign in confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

/auth/mobilesignin​

POST​

Summary​

Signin API to receive verification code and session

Description​

Signin API to receive verification code and session

Parameters​
NameLocated inDescriptionRequiredSchema
mobileSignInRequestbodymobileSignInRequestYesMobileSignInRequest
Responses​
CodeDescriptionSchema
200Confirmation code has been sent successfully.string
201Created
400Failed to initiate sign in confirmation code.
401Unauthorized
403Forbidden
404Failed to initiate sign in confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

/auth/mobilesignup​

POST​

Summary​

Signup using contact no

Description​

Signup using contact no

Parameters​
NameLocated inDescriptionRequiredSchema
mobileSignupRequestWithOrgbodymobileSignupRequestWithOrgYesMobileSignupRequestWithOrg
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/mobileverifysignin​

POST​

Summary​

Verify Api to get token against verification code

Description​

Verify Api to get token against verification code

Parameters​
NameLocated inDescriptionRequiredSchema
MobileVerifySignInRequestbodyMobileVerifySignInRequestYesMobileVerifySignInRequest
Responses​
CodeDescriptionSchema
200Confirmation code has been sent successfully.AuthenticationResultType
201Created
400Failed to initiate sign in confirmation code.
401Unauthorized
403Forbidden
404Failed to initiate sign in confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

/auth/sso/verify​

POST​

Summary​

Verify SSO APISID

Description​

API to verify SSO APISID

Parameters​
NameLocated inDescriptionRequiredSchema
ssoVerifyRequestbodyssoVerifyRequestYesSsoVerifyRequest
Responses​
CodeDescriptionSchema
200OKTenantInfo
201Created
401Unauthorized
403Forbidden
404APISID invalid
Security​
Security SchemaScopes
Authorizationglobal

/auth/subscription/cancel​

GET​

Summary​

Cancel subscription

Description​

API to cancel subscription.

Parameters​
NameLocated inDescriptionRequiredSchema
tokenquerytokenYesstring
Responses​
CodeDescription
200Request to cancel subscription successful.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/websignin​

POST​

Summary​

Login API to receive token with username and password

Description​

Login API to receive token with username and password

Parameters​
NameLocated inDescriptionRequiredSchema
webSignInRequestbodywebSignInRequestYesWebSignInRequest
Responses​
CodeDescriptionSchema
200Login done successfully.AuthenticationResultType
201Created
400Failed to login with given credentials.
401Unauthorized
403Forbidden
404Failed to login with given credentials.
Security​
Security SchemaScopes
Authorizationglobal

/auth/websignup​

POST​

Summary​

Signup using contact, email and password

Description​

Signup using contact, email and password

Parameters​
NameLocated inDescriptionRequiredSchema
webSignupRequestbodywebSignupRequestYesWebSignupRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

open-api-controller​

Utility API

/auth/active-users​

GET​

Summary​

Active users count

Description​

API to provide active users count

Responses​
CodeDescriptionSchema
200Active user count has been provided.object
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/password-policy​

GET​

Summary​

Get password policy by username

Description​

API to fetch password policy for a given username.

Parameters​
NameLocated inDescriptionRequiredSchema
usernamequeryusernameYesstring
inviteCodequeryinviteCodeNostring
ignoreOwnerqueryignoreOwnerNoboolean
Responses​
CodeDescriptionSchema
200OKPasswordPolicyDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

email-verification-controller​

User email verification

/auth/email/regenerate​

GET​

Summary​

/regenerate

Description​

Regenerate Email verification API

Parameters​
NameLocated inDescriptionRequiredSchema
emailqueryemailYesstring
Responses​
CodeDescriptionSchema
200Email has been sent successfully.ResponseEntity
400Email verification unsuccessful.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/email/verification​

GET​

Summary​

/verification

Description​

Email verification API

Parameters​
NameLocated inDescriptionRequiredSchema
tokenquerytokenYesstring
userqueryuserYesstring
Responses​
CodeDescriptionSchema
200Email has been verified successfully.string
401Unauthorized
403Forbidden
404The Confirmation link is invalid. Please generate a new confirmation link.
410Email Token has been expired.
Security​
Security SchemaScopes
Authorizationglobal

google-auth-controller​

Auth user from google

/auth/google/gwebsignin​

POST​

Summary​

User SignIn from Google

Description​

API to authenticate and login a user.

Parameters​
NameLocated inDescriptionRequiredSchema
authAppUserSignInRequestbodyauthAppUserSignInRequestYesAuthApplicationCreateRequest
Responses​
CodeDescriptionSchema
200User sign in successfully.AuthenticationResultType
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/auth/google/gwebsignup​

POST​

Summary​

User SignUp from Google

Description​

API to authenticate and create a user.

Parameters​
NameLocated inDescriptionRequiredSchema
authAppUserCreateRequestbodyauthAppUserCreateRequestYesAuthApplicationCreateRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201Authenticate User has been created successfully.UserDto
401Unauthorized
403Forbidden
404Not Found
409User with same username is already exist.
Security​
Security SchemaScopes
Authorizationglobal

token-controller​

Refresh token for social auth user

/auth/token​

POST​

Summary​

Refresh token for social auth user

Description​

API to create a new refresh token for social auth user

Parameters​
NameLocated inDescriptionRequiredSchema
authApplicationCreateRequestbodyauthApplicationCreateRequestYesAuthApplicationCreateRequest
Responses​
CodeDescriptionSchema
200Refresh token created successfully.AuthenticationResultType
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

internal-demo-org-controller​

Internal Demo Org Controller

/internal-demo-org/demo-org​

POST​

Summary​

Create demo organization

Description​

API to create demo organization

Parameters​
NameLocated inDescriptionRequiredSchema
countryquerycountryNostring
tenantRequestbodytenantRequestYesTenantRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal-demo-org/tenantNames​

POST​

Summary​

getAllTenantNames

Description​

List of tenant names for list of tenantids

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdsbodytenantIdsYes[ long ]
Responses​
CodeDescriptionSchema
200Successfully fetched all tenant namesobject
201Created
401Unauthorized
403Forbidden
404Failure fetching tenant names
Security​
Security SchemaScopes
Authorizationglobal

internal-tenant-details-controller​

API for internal components to get Tenant details

/internal/tenant/details/country/{countryCode}​

GET​

Summary​

Get tenant get by country code.

Description​

API to get tenant information by country code.

Parameters​
NameLocated inDescriptionRequiredSchema
countryCodepathcountryCodeYesstring
Responses​
CodeDescriptionSchema
200Tenant information by country code has been fetched successfully.object
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenant/details/{id}​

GET​

Summary​

API for internal components to get Tenant details

Description​

API to get Tenant details without tenant token and only for use internally

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant details fetched successfullyTenantInfo
401Unauthorized
403Forbidden
404Not Found
500Failed to get tenant details
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenant/details/get-all-peppolid​

GET​

Summary​

Get all tenant Peppol ids

Description​

API to get e-invoicing Peppol id details for all tenants.

Responses​
CodeDescriptionSchema
200Tenant information by country code has been fetched successfully.[ TenantEInvoiceResponse ]
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

internal-token-controller​

API to create a HPA token for a given tenant

/internal/tenant/hpa/token​

GET​

Summary​

API to create a HPA token for a given tenant

Description​

Generate a HPA token for a given tenant, but is not updated in cognito

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
userIdqueryuserIdYeslong
Responses​
CodeDescriptionSchema
200HPA token created successfullyAuthenticationResultType
401Unauthorized
403Forbidden
404Not Found
500Failed to create token
Security​
Security SchemaScopes
Authorizationglobal

internal-user-controller​

User Management

/internal/tenants/users/accept-invite​

POST​

Summary​

Accept invitation internally

Description​

Accept invitation by tenantId, inviteCode and email without DB/JPA changes

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesAcceptInvitationRequest
Responses​
CodeDescriptionSchema
200Invitation accepted successfullyUserDto
400Invalid invitation or parameters

/internal/tenants/users/assign/crm_plus​

POST​

Summary​

Add user's roles for crm_plus app

Description​

Add user's roles for crm_plus app

Parameters​
NameLocated inDescriptionRequiredSchema
emailsbodyemailsYes[ string ]
Responses​
CodeDescription
200Users has been added to crm plus successfully.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/change-email​

PATCH​

Summary​

Change user email

Description​

Api to change user email

Parameters​
NameLocated inDescriptionRequiredSchema
emailChangeDtobodyemailChangeDtoYesEmailChangeDto
Responses​
CodeDescriptionSchema
200Encryption SuccessAppUserBasicInfoDto
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/change-name​

PATCH​

Summary​

change name of user

Description​

Api to change name of user

Parameters​
NameLocated inDescriptionRequiredSchema
changeNameDtobodychangeNameDtoYesChangeNameDto
Responses​
CodeDescriptionSchema
200successfully modified the nameAppUserBasicInfoDto
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/decrypt​

POST​

Summary​

Get decrypted text

Description​

Api to get decrypted values of strings

Parameters​
NameLocated inDescriptionRequiredSchema
encryptedStringsbodyencryptedStringsYes[ string ]
Responses​
CodeDescriptionSchema
200Decryption Success[ string ]
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/delete-roles​

DELETE​

Summary​

Delete user roles from cron

Description​

Delete user roles from cron

Responses​
CodeDescription
200User roles cleared successfully
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/domain​

POST​

Summary​

Extract domain from email id

Description​

Api to extract domain from email id

Responses​
CodeDescription
200Domains extracted successfully
201Created
401Failed to extract users
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/encrypt​

GET​

Summary​

run encryption on app user info

Description​

run encryption on app user info

Responses​
CodeDescription
200Encryption Success
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Get encrypted text

Description​

Api to get encrypted values of strings

Parameters​
NameLocated inDescriptionRequiredSchema
plainStringsbodyplainStringsYes[ string ]
Responses​
CodeDescriptionSchema
200Encryption Success[ string ]
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/encrypt-app-invite​

GET​

Summary​

run encryption on app_invite info

Description​

run encryption on app_invite info

Responses​
CodeDescription
200Encryption Success
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/encrypt-bookkeeper-client-invite​

GET​

Summary​

run encryption on bookkeeper_client_invite

Description​

run encryption on bookkeeper_client_invite

Responses​
CodeDescription
200Encryption Success
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/encrypt_tenant​

GET​

Summary​

encrypt tenant in user_tenant_mapping_basic_info

Description​

encrypt tenant in user_tenant_mapping_basic_info

Parameters​
NameLocated inDescriptionRequiredSchema
sizequerysizeNointeger
Responses​
CodeDescription
200encryption of tenant data in user_tenant_mapping_basic_info has been done successfully
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findAllByEmailContainingIgnoreCase/{email}​

GET​

Summary​

Find by email containing ignored case

Description​

Find by email containing ignored case

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
Responses​
CodeDescriptionSchema
200Users found with the given email[ BookkeeperClientInvite ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findAllByEmailContainingIgnoreCaseAndStatusAndIsBookkeeperFalseAndDeletedFalse/{email}/{status}​

GET​

Summary​

Find by email containing ignored case and status

Description​

Find by email containing ignored case and status

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
statuspathstatusYesstring
Responses​
CodeDescriptionSchema
200User found with the given email and status[ BookkeeperClientInvite ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findAllByEmailIgnoreCaseAndUserTenantMappingAndDeletedFalse/{email}{userTenantMapping}​

GET​

Summary​

Find by email ignored case and user tenant mapping

Description​

Find by email ignored case and user tenant mapping

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
userTenantMappingpathuserTenantMappingYesstring
Responses​
CodeDescriptionSchema
200Users found with the given email[ BookkeeperClientInvite ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findByEmailContainingIgnoreCase/{email}​

GET​

Summary​

Find by email containing ignored case

Description​

Find by email containing ignored case

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
Responses​
CodeDescriptionSchema
200User found by email[ User ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findByEmailIgnoreCase/{email}​

GET​

Summary​

Find one by email ignore case

Description​

Find one by email ignore case

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
Responses​
CodeDescriptionSchema
200User found by emailUser
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findByEmailIgnoreCaseAndTenantId/{email}/{tenantId}​

GET​

Summary​

Find by email and tenant id

Description​

Find by email and tenant id

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
tenantIdpathtenantIdYeslong
Responses​
CodeDescriptionSchema
200User found by emailAppInvite
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findByEmailIgnoreCaseAndTenantIdAndDeletedFalse/{email}{tenantId}​

GET​

Summary​

Find by email ignored case and tenant id

Description​

Find by email ignored case and tenant id

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
tenantIdpathtenantIdYeslong
Responses​
CodeDescriptionSchema
200User found with the given email and tenant idBookkeeperClientInvite
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/findByIdAndEmailContainingIgnoreCaseAndDeletedFalse/{id}/{email}​

GET​

Summary​

Find by id and email containing ignored case

Description​

Find by id and email containing ignored case

Parameters​
NameLocated inDescriptionRequiredSchema
emailpathemailYesstring
idpathidYeslong
Responses​
CodeDescriptionSchema
200User found with the given id and emailBookkeeperClientInvite
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/firstname-index​

GET​

Summary​

Api to check & create first name sort index

Description​

Api to check & create first name sort index

Parameters​
NameLocated inDescriptionRequiredSchema
numquerynumYesinteger
Responses​
CodeDescriptionSchema
200first name sort index createdstring
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/get-users​

POST​

Summary​

Get users by tenant id

Description​

Api to get users by tenant id

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdsbodytenantIdsYes[ long ]
Responses​
CodeDescriptionSchema
200Users fetched successfully[ UserShortInfo ]
201Created
401Failed to fetch users
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/getByIamUserIdsBasic​

POST​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
iamUserIdsbodyiamUserIdsYes[ long ]
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
201Created
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/getiamid​

GET​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
userIdqueryuserIdYeslong
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/iam​

POST​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
iamUserIdsbodyiamUserIdsYes[ long ]
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
201Created
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/iam/{id}​

GET​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

Deleted iam user mapping

Description​

Api to ackowledge deleted iam user

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescription
200User deleted
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/ids​

POST​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idsbodyidsYes[ long ]
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.UserDto
201Created
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/index​

POST​

Summary​

Update sort column for users

Description​

Update sort column for users

Parameters​
NameLocated inDescriptionRequiredSchema
erpTenantIdsbodyerpTenantIdsYes[ long ]
Responses​
CodeDescriptionSchema
200No users foundstring
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/migrate-roles-modules​

POST​

Summary​

Migrate the roles and permissions of the user

Description​

Migrate the roles and permissions of the user

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesRefreshRolesModulesByAppNameRequest
Responses​
CodeDescriptionSchema
200User migrated successfullyRefreshRolesModulesResponse
404Failed to migrate roles and modules

/internal/tenants/users/refresh-roles-modules​

POST​

Summary​

Refresh the roles and permissions of the user

Description​

Refresh the roles and permissions of the user

Parameters​
NameLocated inDescriptionRequiredSchema
refreshRolesModulesRequestbodyrefreshRolesModulesRequestYesRefreshRolesModulesRequest
Responses​
CodeDescriptionSchema
200User updated successfullyRefreshRolesModulesResponse
201Created
401Unauthorized
403Forbidden
404Failed to update roles and modules
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/refresh-roles-modules-v2​

POST​

Summary​

Refresh the roles and permissions of the user - V2

Description​

Refresh the roles and permissions of the user - V2

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesRefreshRolesModulesByAppNameRequest
Responses​
CodeDescriptionSchema
200User updated successfullyRefreshRolesModulesResponse
404Failed to update roles and modules

/internal/tenants/users/roles/unassign​

POST​

Summary​

Unassign role from a user

Description​

Unassign role from a user

Parameters​
NameLocated inDescriptionRequiredSchema
unassignUserRoleRequestInternalbodyunassignUserRoleRequestInternalYesUnassignUserRoleRequestInternal
Responses​
CodeDescription
200User role unassigned successfully

/internal/tenants/users/set-contact-email​

PATCH​

Summary​

Change user contact/email

Description​

Api to change user contact/email

Parameters​
NameLocated inDescriptionRequiredSchema
setContactEmailDtobodysetContactEmailDtoYesSetContactEmailDto
Responses​
CodeDescriptionSchema
200Encryption SuccessAppUserBasicInfoDto
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/tenant-delete/{id}​

DELETE​

Summary​

Delete the tenant

Description​

Delete the tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/tenant-reset​

DELETE​

Summary​

Reset the tenant

Description​

Reset the tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/tenantId/{tenantId}/app/{app}/role_group/{roleGroup}​

GET​

Summary​

Get iamUserId for app and roleGroup

Description​

Get iamUserId for app and roleGroup

Parameters​
NameLocated inDescriptionRequiredSchema
apppathappYesstring
roleGrouppathroleGroupYesstring
tenantIdpathtenantIdYeslong
Responses​
CodeDescriptionSchema
200IamUserId for app and roleGroup has been fetched successfully.long
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/internal/tenants/users/user-exists-by-tenant​

GET​

Summary​

Check if email exists for a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdqueryTenant IDYeslong
iamUserIdqueryIam User IDYeslong
Responses​
CodeDescriptionSchema
200OKboolean

/internal/tenants/users/userinfo/{tenantId}​

GET​

Summary​

Search users short info for a tenant

Description​

API to search users short info for a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdpathtenantIdYeslong
searchquerysearchNostring
queryqueryqueryNostring
sortquerysortNostring
sortDirquerysortDirNostring
pagequerypageNoint
limitquerylimitNoint
excludeMfaqueryexcludeMfaNoboolean
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.Page«UserShortRoleInfo»

/internal/tenants/users/utmbi​

GET​

Summary​

insert decrypted data in user_tenant_mapping_basic_info

Description​

insert decrypted data in user_tenant_mapping_basic_info

Parameters​
NameLocated inDescriptionRequiredSchema
sizequerysizeNointeger
Responses​
CodeDescription
200decrypted data in user_tenant_mapping_basic_info has been done successfully
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

role-group-controller​

Role Group Management

/v1/rolegroups​

GET​

Summary​

Get Role Groups

Description​

API to get role groups

Parameters​
NameLocated inDescriptionRequiredSchema
limitquerylimitNointeger
pagequerypageNointeger
queryqueryqueryNostring
searchquerysearchNostring
sortquerysortNostring
sortDirquerysortDirNostring
Responses​
CodeDescriptionSchema
200Role Group information has been fetched successfully.RoleGroupDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Create Role Groups

Description​

API to create role groups

Parameters​
NameLocated inDescriptionRequiredSchema
roleGroupCreateReqbodyroleGroupCreateReqYesRoleGroupCreateRequestDto
Responses​
CodeDescriptionSchema
200OKRoleGroupDto
201Role information has been created successfully.RoleGroupDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

Delete Role Groups

Description​

API to delete role groups

Parameters​
NameLocated inDescriptionRequiredSchema
roleGroupDeleteReqbodyroleGroupDeleteReqYesRoleGroupDeleteRequestDto
Responses​
CodeDescriptionSchema
200Role information has been deleted successfully.RoleGroupDto
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Update Role Groups

Description​

API to update role groups

Parameters​
NameLocated inDescriptionRequiredSchema
roleGroupCreateReqbodyroleGroupCreateReqYesRoleGroupCreateRequestDto
Responses​
CodeDescriptionSchema
200Role information has been updated successfully.RoleGroupDto
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/v1/rolegroups/get/roles​

GET​

Summary​

Get Role Groups

Description​

API to get role groups

Responses​
CodeDescriptionSchema
200Role information has been fetched successfully.UserDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/rolegroups/{appName}​

GET​

Summary​

Get role group by code.

Description​

API to get role group by code.

Parameters​
NameLocated inDescriptionRequiredSchema
appNamepathappNameYesstring
Responses​
CodeDescriptionSchema
200Role information has been fetched successfully.UserDto
401Unauthorized
403Forbidden
404Role group does not exist.
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller​

Tenant APIs

/v1/tenants/**​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfo
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/apps-customization​

GET​

Summary​

Get Apps Customization details

Description​

API to get Apps Customization details

Responses​
CodeDescriptionSchema
200Request to get App Customization details successful.AppsCustomizationResponseDto
401Unauthorized
403Forbidden
404Failed to get App Customization details.
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Save User preferences for App customization

Description​

Save User preferences for App customization

Parameters​
NameLocated inDescriptionRequiredSchema
appsCustomizationRequestDtobodyappsCustomizationRequestDtoYesAppsCustomizationRequestDto
Responses​
CodeDescriptionSchema
200App Customization Preferences has been saved successfully.AppsCustomizationResponseDto
201Created
401Unauthorized
403Forbidden
404Failure in saving app customization
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Update customization setting.

Description​

API to update customization setting of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
appsCustomizationRequestDtobodyappsCustomizationRequestDtoYesAppsCustomizationRequestDto
Responses​
CodeDescriptionSchema
200Customization setting has been updated successfully.TenantInfo
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/bktenantId/{id}​

GET​

Summary​

Get Book Keeper tenant by id.

Description​

API to get book keeper tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Book Keeper Tenant information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404Book Keeper Tenant or User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequest
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfo
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/books/subscription​

GET​

Summary​

Get Books subscription details

Description​

API to get subscription details for a tenant

Responses​
CodeDescriptionSchema
200Request to get subscription details successful.TenantBooksSubscriptionDetails
401Unauthorized
403Forbidden
404Failed to get Books subscription details.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/contact-info​

GET​

Summary​

Get Company's contact info

Description​

API to get Company's contact info

Responses​
CodeDescriptionSchema
200Contact info fetched successfullyTenantInfo
401Unauthorized
403Forbidden
404Contact info not found
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Update Company's contact info

Description​

API to update Company's contact info

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantContact
Responses​
CodeDescriptionSchema
200Contact info updated successfullyTenantInfo
204No Content
401Unauthorized
403Forbidden
404Contact info update failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/demo-organization​

POST​

Summary​

Create demo organization

Description​

API to create demo organization

Parameters​
NameLocated inDescriptionRequiredSchema
countryquerycountryNostring
tenantRequestbodytenantRequestYesTenantRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/get-tenants-by-nature​

GET​

Summary​

Get Tenants by nature.

Description​

Get Tenants by nature.

Parameters​
NameLocated inDescriptionRequiredSchema
naturequerynatureYesstring
tenantIdquerytenantIdNolong
Responses​
CodeDescriptionSchema
200User tenant list fetched successfully[ TenantShortInfo ]
400Get Tenants by nature.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/iamuser​

POST​

Summary​

Add an IAM user to a tenant

Description​

Add an IAM user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantRelRequestbodyuserTenantRelRequestYesUserTenantRelRequest
Responses​
CodeDescriptionSchema
200IAM User added to a tenant successfully!UserDto
201Created
400IAM User addition to tenant failed!
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/iamuser/bulk​

POST​

Summary​

Create user in bulk.

Description​

Api to create users in bulk

Parameters​
NameLocated inDescriptionRequiredSchema
requestsbodyrequestsYes[ UserTenantRelRequest ]
Responses​
CodeDescriptionSchema
200Users created successfully.BulkAddUserResponse
201Created
400Failed to create users.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/iamuser/bulkasync​

POST​

Summary​

Create user in bulk.

Description​

Api to create users in bulk

Parameters​
NameLocated inDescriptionRequiredSchema
requestsbodyrequestsYes[ UserTenantRelRequest ]
Responses​
CodeDescriptionSchema
200Users created successfully.BulkAddUserResponse
201Created
400Failed to create users.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/iamuser/{iamUserId}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
iamUserIdpathiamUserIdYeslong
Responses​
CodeDescriptionSchema
200Tenant User information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404Tenant User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/inviteduser​

POST​

Summary​

Add an IAM user to a tenant

Description​

Add an IAM user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantRelRequestbodyuserTenantRelRequestYesUserTenantRelRequest
Responses​
CodeDescriptionSchema
200IAM User added to a tenant successfully!UserDto
201Created
400IAM User addition to tenant failed!
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/logout​

GET​

Summary​

Log out

Description​

Log out API

Responses​
CodeDescriptionSchema
200Logged out successfullyboolean
400Log out failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/logout2​

GET​

Summary​

Log out

Description​

Log out API

Responses​
CodeDescriptionSchema
200Logged out successfullyboolean
400Log out failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/mobilesignup​

POST​

Summary​

Signup using contact no

Description​

Signup using contact no

Parameters​
NameLocated inDescriptionRequiredSchema
mobileSignupRequestWithOrgbodymobileSignupRequestWithOrgYesMobileSignupRequestWithOrg
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/nexus-states​

POST​

Summary​

Get Tenant Info by id.

Description​

API to get Tenant Info by id.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdsbodytenantIdsYes[ long ]
Responses​
CodeDescriptionSchema
200Tenant Info has been fetched successfully.[ object ]
201Created
401Unauthorized
403Forbidden
404Organization or Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/organisation/country/update​

PATCH​

Summary​

API to country of Tenant from People

Description​

API to country of Tenant from People

Parameters​
NameLocated inDescriptionRequiredSchema
tenantCountryDtobodytenantCountryDtoYesTenantCountryDto
Responses​
CodeDescriptionSchema
200Updated Tenant country and currency successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to update Tenant country and currency from.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/organisationwithoutsetup​

POST​

Summary​

Create organization without setup

Description​

API to create organization without setup

Parameters​
NameLocated inDescriptionRequiredSchema
tenantRequestbodytenantRequestYesTenantRequest
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/organization/settings​

GET​

Summary​

Get Organization settings

Description​

Get Organization settings

Responses​
CodeDescriptionSchema
200Organization settings have been fetched successfully.OrganizationSettings
401Unauthorized
403Forbidden
404Organization not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/organization/settings/get-user-salesperson-setting​

GET​

Summary​

Get Organization settings

Description​

Get Organization settings

Responses​
CodeDescriptionSchema
200Organization settings have been fetched successfully.SalesPersonSettingInfo
401Unauthorized
403Forbidden
404Organization not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/owner​

GET​

Summary​

owner user

Description​

Api to find owner name of user

Responses​
CodeDescriptionSchema
200successfully fetched the nameOwnerInfoDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/roles/iamuser​

POST​

DEPRECATED

Summary​

Add an IAM user to a tenant

Description​

Add an IAM user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantRelCreationRequestbodyuserTenantRelCreationRequestYesUserTenantRelCreationRequest
Responses​
CodeDescriptionSchema
200IAM User added to a tenant successfully!UserDto
201Created
400IAM User addition to tenant failed!
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/roles/module/iamuser​

POST​

Summary​

Add an IAM user to a tenant

Description​

Add an IAM user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantRelCreationRequestbodyuserTenantRelCreationRequestYesUserTenantRelCreationRequest
Responses​
CodeDescriptionSchema
200IAM User added to a tenant successfully!UserDto
201Created
400IAM User addition to tenant failed!
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/setup/status​

GET​

Summary​

Get Organization setup status

Description​

Get Organization setup status

Responses​
CodeDescriptionSchema
200Organization setup information has been fetched successfully.OrganizationSetupStatusResponse
401Unauthorized
403Forbidden
404Organization not found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Save Organization setup status

Description​

Save Organization setup status

Parameters​
NameLocated inDescriptionRequiredSchema
organizationSetupStatusbodyorganizationSetupStatusYesOrganizationSetupStatusResponse
Responses​
CodeDescriptionSchema
200Organization setup information has been saved successfully.ResponseEntity
201Created
401Unauthorized
403Forbidden
404Organization not found
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Update Organization setup status

Description​

Update Organization setup status

Parameters​
NameLocated inDescriptionRequiredSchema
organizationSetupRequestDtobodyorganizationSetupRequestDtoYesOrganizationSetupStatusResponse
Responses​
CodeDescriptionSchema
200Organization setup information has been updated successfully.TenantInfo
204No Content
401Unauthorized
403Forbidden
404Organization not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/tenant/{tenantId}/user/{userId}/switch​

POST​

Summary​

Switch tenant for a loggedin user

Description​

Switch tenant for a loggedin user

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdpathtenantIdYeslong
userIdpathuserIdYeslong
Responses​
CodeDescription
200Tenant switched successfully
201Created
400Failed to switch tenant
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/update-login-info​

PUT​

Summary​

Update IP Address after user signin

Description​

API to update IP Address after user signin

Parameters​
NameLocated inDescriptionRequiredSchema
userbodyuserYesUserLastLoginInfo
Responses​
CodeDescription
200User IP Address updated successfully
201Created
400User IP Address update failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/user/{userId}/tenantinfo​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
userIdpathuserIdYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/user/{userId}/tenants-info​

GET​

Summary​

Get all tenants information for user

Description​

API to get get all tenants information for user.

Parameters​
NameLocated inDescriptionRequiredSchema
userIdpathuserIdYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.[ TenantInfo ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/**/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfobodytenantInfoYesTenantInfo
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfo
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

system-admin-controller​

System Admin Controller

/v1/tenants/**/system/search​

GET​

Summary​

tenantSearch

Parameters​
NameLocated inDescriptionRequiredSchema
limitquerylimitNointeger
pagequerypageNointeger
queryqueryqueryNostring
searchquerysearchNostring
sortquerysortNostring
sortDirquerysortDirNostring
Responses​
CodeDescriptionSchema
200Fetched tenant list.Page«TenantInformation»
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-uae​

UAE specific Tenant APIs

/v1/tenants/ae​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoUAE
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestUAEbodyorgSignUpRequestUAEYesOrgSignUpRequestUAE
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestUAE
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestUAE
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoUAE
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoUAE
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestUAEbodyorgSignUpRequestUAEYesOrgSignUpRequestUAE
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestUAEbodyorgSignUpRequestUAEYesOrgSignUpRequestUAE
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ae/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoUAE
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoUAEbodytenantInfoUAEYesTenantInfoUAE
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoUAE
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-australia​

Australia specific Tenant APIs

/v1/tenants/au​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoAustralia
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestAustraliabodyorgSignUpRequestAustraliaYesOrgSignUpRequestAustralia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestAustralia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestAustralia
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoAustralia
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoAustralia
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestAustraliabodyorgSignUpRequestAustraliaYesOrgSignUpRequestAustralia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestAustralia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/au/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoAustralia
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoAustraliabodytenantInfoAustraliaYesTenantInfoAustralia
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoAustralia
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-belgium​

Belgium specific Tenant APIs

/v1/tenants/be​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoBelgium
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestBelgiumbodyorgSignUpRequestBelgiumYesOrgSignUpRequestBelgium
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestBelgium
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestBelgium
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoBelgium
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoBelgium
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestBelgiumbodyorgSignUpRequestBelgiumYesOrgSignUpRequestBelgium
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestBelgium
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/be/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoBelgium
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoBelgiumbodytenantInfoBelgiumYesTenantInfoBelgium
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoBelgium
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

bookkeeper-controller​

Bookkeeper API

/v1/tenants/bookkeeper​

GET​

Summary​

Get Bookkeepers

Description​

API to get bookkeeper

Parameters​
NameLocated inDescriptionRequiredSchema
limitquerylimitNointeger
pagequerypageNointeger
queryqueryqueryNostring
searchquerysearchNostring
sortquerysortNostring
sortDirquerysortDirNostring
typequerytypeYesstring
Responses​
CodeDescriptionSchema
200Bookkeepers information has been fetched successfully.BookkeeperTeamInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Bookkeeper team user creation

Description​

API to create a user.

Parameters​
NameLocated inDescriptionRequiredSchema
manageClientquerymanageClientNoboolean
userTenantTeamRequestbodyuserTenantTeamRequestYesUserTenantTeamRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper team user updation.

Description​

API to update a bookkeeper team user.

Parameters​
NameLocated inDescriptionRequiredSchema
manageClientquerymanageClientNoboolean
userTenantTeamRequestbodyuserTenantTeamRequestYesUserTenantTeamRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201User email has been updated successfully.UserDto
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/add-existing-user-to-team​

POST​

Summary​

Add existing user to Bookkeeper Team API

Description​

Add existing user to Bookkeeper Team API Note

Parameters​
NameLocated inDescriptionRequiredSchema
userIdqueryuserIdNolong
Responses​
CodeDescription
200OK
201User email has been updated successfully.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/add-team-on-invite​

PUT​

Summary​

Bookkeeper Client Mapping on client's invite.

Description​

API for Bookkeeper Client Mapping on client's invite

Parameters​
NameLocated inDescriptionRequiredSchema
clientInviteIdqueryclientInviteIdNolong
tenantIdquerytenantIdNolong
userIdqueryuserIdNolong
Responses​
CodeDescriptionSchema
200OKBookkeeperTeam
201User email has been updated successfully.BookkeeperTeam
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/client-status​

PUT​

Summary​

Bookkeeper client user updation.

Description​

Toggle bookkeeper manage client status flag

Parameters​
NameLocated inDescriptionRequiredSchema
idqueryidNolong
statusquerystatusYesstring
Responses​
CodeDescriptionSchema
200OKBookkeeperTeam
201User email has been updated successfully.BookkeeperTeam
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/client-tenants​

GET​

Summary​

Get client's tenant mapping list.

Description​

Get client's tenant mapping list.

Responses​
CodeDescriptionSchema
200Client's tenant list fetched successfully[ UserTenantMappingResponse ]
400Failed to get Client's tenant list.
401Unauthorized
403Forbidden
404Client's tenant list not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/client/team-members​

GET​

Summary​

Get list of all team members of the client

Description​

API to get list of all team members of the client.

Parameters​
NameLocated inDescriptionRequiredSchema
clientDefaultUserIdqueryclientDefaultUserIdNolong
clientTenantIdqueryclientTenantIdNolong
Responses​
CodeDescriptionSchema
200Team members of client fetched successfully[ BookkeeperTeamInfo ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/invite​

POST​

Summary​

Invite bulk user to a tenant

Description​

Invite bulk user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
inviteBookKeeperRequestbodyinviteBookKeeperRequestYesInviteBookKeeperRequest
Responses​
CodeDescriptionSchema
200User added to a tenant successfully[ BookkeeperInviteResponse ]
201Created
400Bookkeeper request for send email can't null!
401Unauthorized
403Forbidden
404User does not exist with username/email/phone %s.
500Bookkeeper request for send single email fail!
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/notify​

POST​

Summary​

Notify bookkeeper to upgrade plan for client.

Description​

API to notify bookkeeper to upgrade plan for client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperNotifyRequestbodybookkeeperNotifyRequestYesBookkeeperNotifyRequest
Responses​
CodeDescription
200Bookkeeper notified successfully to upgrade plan for client.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/payment​

GET​

Summary​

Whether client pays or bookkeeper pays for subscription

Description​

API to find whether client pays or bookkeeper pays for subscription

Responses​
CodeDescriptionSchema
200Payment information fetched successfully.BookkeeperClientPayment
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/resend-invite​

POST​

Summary​

Invite bulk user to a tenant

Description​

Invite bulk user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
resendInviteBookkeeperRequestbodyresendInviteBookkeeperRequestYesInviteBookkeeperByIdsRequest
Responses​
CodeDescriptionSchema
200User added to a tenant successfully[ BookkeeperInviteResponse ]
201Created
400User tenant mapping creation failed
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/subscription/cancel​

POST​

Summary​

Cancel subscription

Description​

API to cancel subscription.

Parameters​
NameLocated inDescriptionRequiredSchema
cancelSubscriptionRequestbodycancelSubscriptionRequestYesCancelSubscriptionRequest
Responses​
CodeDescription
200Request to cancel subscription successful.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/team-member/clients​

GET​

Summary​

Get list of all the clients the team member has access

Description​

API to get list of all the clients the team member has access.

Parameters​
NameLocated inDescriptionRequiredSchema
bkTeamIdquerybkTeamIdYeslong
Responses​
CodeDescriptionSchema
200Clients of team member fetched successfully[ BookkeeperTeamInfo ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/team-status​

PUT​

Summary​

Bookkeeper team user updation.

Description​

Toggle bookkeeper manage team status flag

Parameters​
NameLocated inDescriptionRequiredSchema
idqueryidNolong
statusquerystatusYesstring
Responses​
CodeDescriptionSchema
200OKBookkeeperTeam
201User email has been updated successfully.BookkeeperTeam
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/team-user-detail​

GET​

Summary​

Get details of logged in team member

Description​

API to get details of logged in team member

Responses​
CodeDescriptionSchema
200Logged in team member details fetched successfullyBookkeeperTeamInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/transfer-ownership​

PUT​

Summary​

Bookkeeper transfer ownership.

Description​

API to transfer Bookkeeper ownership.

Parameters​
NameLocated inDescriptionRequiredSchema
bkTeamIdquerybkTeamIdNolong
Responses​
CodeDescription
200Bookkeeper ownership transferred successfully.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/bookkeeper/{id}​

DELETE​

Summary​

v1/tenants/bookkeeper

Description​

Delete bookkeeper API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200OKboolean
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-canada​

Canada specific Tenant APIs

/v1/tenants/ca​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoCanada
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestCanadabodyorgSignUpRequestCanadaYesOrgSignUpRequestCanada
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestCanada
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestCanada
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoCanada
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoCanada
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestCanadabodyorgSignUpRequestCanadaYesOrgSignUpRequestCanada
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestCanada
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ca/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoCanada
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoCanadabodytenantInfoCanadaYesTenantInfoCanada
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoCanada
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

bookkeeper-client-controller​

Bookkeeper Client Controller

/v1/tenants/client/bookkeeper​

DELETE​

Summary​

Delete Bookkeeper for Client

Description​

API to delete Bookkeeper for Client

Parameters​
NameLocated inDescriptionRequiredSchema
bkTeamIdquerybkTeamIdNolong
inviteIdqueryinviteIdNolong
Responses​
CodeDescriptionSchema
200Bookkeeper for Client deleted successfullyBookkeeperTeamInfo
204No Content
400Bookkeeper for Client delete failed
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/client/bookkeeper-status​

PUT​

Summary​

Update status of Bookkeeper

Description​

API to update status of Bookkeeper

Parameters​
NameLocated inDescriptionRequiredSchema
bkTeamIdquerybkTeamIdYeslong
statusquerystatusYesstring
Responses​
CodeDescriptionSchema
200Bookkeeper status updated successfullyBookkeeperTeamInfo
201Created
400Bookkeeper status update failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/client/bookkeepers​

GET​

Summary​

Get Bookkeepers of a Client

Description​

API to get Bookkeepers of a Client

Responses​
CodeDescriptionSchema
200Bookkeepers of Client fetched successfully[ BookkeeperTeamInfo ]
400Get Bookkeepers of Client failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/client/invite-bookkeeper​

POST​

Summary​

Invite a bookkeeper to a tenant

Description​

API to invite a bookkeeper to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
inviteBookKeeperRequestbodyinviteBookKeeperRequestYesInviteBookKeeperRequest
Responses​
CodeDescriptionSchema
200Bookkeeper has been invited successfully[ BookkeeperInviteResponse ]
201Created
400Invite a bookkeeper to a tenant failed
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/client/subscription/cancel​

POST​

Summary​

Cancel subscription

Description​

API to cancel subscription.

Parameters​
NameLocated inDescriptionRequiredSchema
cancelSubscriptionRequestbodycancelSubscriptionRequestYesCancelSubscriptionRequest
Responses​
CodeDescription
200Request to cancel subscription successful.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-germany​

Germany specific Tenant APIs

/v1/tenants/de​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoGermany
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestGermanybodyorgSignUpRequestGermanyYesOrgSignUpRequestGermany
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestGermany
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestGermany
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoGermany
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoGermany
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestGermanybodyorgSignUpRequestGermanyYesOrgSignUpRequestGermany
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestGermany
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/de/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoGermany
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoGermanybodytenantInfoGermanyYesTenantInfoGermany
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoGermany
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-indonesia​

Indonesia specific Tenant APIs

/v1/tenants/id​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoIndonesia
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIndonesiabodyorgSignUpRequestIndonesiaYesOrgSignUpRequestIndonesia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIndonesia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIndonesia
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoIndonesia
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIndonesia
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIndonesiabodyorgSignUpRequestIndonesiaYesOrgSignUpRequestIndonesia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestIndonesia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/id/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIndonesia
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
TenantInfoIndonesiabodyTenantInfoIndonesiaYesTenantInfoIndonesia
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoIndonesia
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-israel​

Israel specific Tenant APIs

/v1/tenants/il​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoIsrael
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIsraelbodyorgSignUpRequestIsraelYesOrgSignUpRequestIsrael
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIsrael
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIsrael
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoIsrael
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIsrael
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIsraelbodyorgSignUpRequestIsraelYesOrgSignUpRequestIsrael
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestIsrael
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/il/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIsrael
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoIsraelbodytenantInfoIsraelYesTenantInfoIsrael
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoIsrael
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-india​

India specific Tenant APIs

/v1/tenants/in​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoIndia
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIndiabodyorgSignUpRequestIndiaYesOrgSignUpRequestIndia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIndia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestIndia
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoIndia
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIndia
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestIndiabodyorgSignUpRequestIndiaYesOrgSignUpRequestIndia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestIndia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/in/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIndia
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
TenantInfoIndiabodyTenantInfoIndiaYesTenantInfoIndia
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoIndia
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-malaysia​

Malaysia specific Tenant APIs

/v1/tenants/my​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoMalaysia
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestMalaysiabodyorgSignUpRequestMalaysiaYesOrgSignUpRequestMalaysia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestMalaysia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestMalaysia
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoMalaysia
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoMalaysia
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestMalaysiabodyorgSignUpRequestMalaysiaYesOrgSignUpRequestMalaysia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestMalaysia
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/my/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoMalaysia
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
TenantInfoMalaysiabodyTenantInfoMalaysiaYesTenantInfoMalaysia
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoMalaysia
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-nl​

Netherlands specific Tenant APIs

/v1/tenants/nl​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoNL
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestNLbodyorgSignUpRequestNLYesOrgSignUpRequestNL
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestNL
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestNL
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoNL
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoNL
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestNLbodyorgSignUpRequestNLYesOrgSignUpRequestNL
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestNL
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nl/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoNL
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoNLbodytenantInfoNLYesTenantInfoNL
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoNL
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-nz​

New Zealand specific Tenant APIs

/v1/tenants/nz​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoNZ
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestNZbodyorgSignUpRequestNZYesOrgSignUpRequestNZ
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestNZ
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestNZ
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoNZ
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoNZ
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestNZbodyorgSignUpRequestNZYesOrgSignUpRequestNZ
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestNZ
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/nz/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoNZ
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoNZbodytenantInfoNZYesTenantInfoNZ
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoNZ
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

permission-controller​

Permission Controller

/v1/tenants/permissions​

GET​

Summary​

Get permission of logged in user for selected tenant

Description​

Get permission of user and tenant from auth details

Responses​
CodeDescriptionSchema
200Permission fetchesUserPermissionResponse
401Unauthorized
403Forbidden
404Fetching permission failed
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Assign user permission for apps

Description​

Assign user Permission for apps

Parameters​
NameLocated inDescriptionRequiredSchema
userPermissionReqbodyuserPermissionReqYes[ UserPermissionRequest ]
Responses​
CodeDescriptionSchema
200Permission assigned to user successfully[ UserPermissionResponse ]
201Created
401Unauthorized
403Forbidden
404Assign permission to user failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

Remove user permission for apps

Description​

Remove user Permission for apps

Parameters​
NameLocated inDescriptionRequiredSchema
removePermissionRequestsbodyremovePermissionRequestsYes[ RemovePermissionRequest ]
Responses​
CodeDescription
200User permission removed successfully
204No Content
401Unauthorized
403Forbidden
404Not able to remove user permission
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Add user permission for apps

Description​

Add user Permission for apps

Parameters​
NameLocated inDescriptionRequiredSchema
userPermissionReqbodyuserPermissionReqYes[ UserPermissionRequest ]
Responses​
CodeDescriptionSchema
200Permission added to user successfully[ UserPermissionResponse ]
204No Content
401Unauthorized
403Forbidden
404Adding permission to user failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/permissions/metadata​

POST​

Summary​

Get permission details for apps

Description​

Get permission details (Role Group, Module, Roles) for given apps

Parameters​
NameLocated inDescriptionRequiredSchema
appNamesbodyappNamesYes[ string ]
Responses​
CodeDescriptionSchema
200Module permission fetched successfullyobject
201Created
401Unauthorized
403Forbidden
404Module permission fetch failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/permissions/module​

POST​

Summary​

Get module list for apps

Description​

Get module list details for given apps

Parameters​
NameLocated inDescriptionRequiredSchema
appNamesbodyappNamesYes[ string ]
Responses​
CodeDescriptionSchema
200Module list fetched successfully[ object ]
201Created
401Unauthorized
403Forbidden
404Module list fetch failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/permissions/refresh​

POST​

Summary​

Refresh User Redis Permission

Description​

Refresh User Redis Permission

Responses​
CodeDescriptionSchema
200Permission refreshed successfullyboolean
201Created
401Unauthorized
403Forbidden
404Failed to refresh user permission
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/permissions/users​

POST​

Summary​

Get permission of userIds for selected tenant

Description​

Get permission of given userIds and tenant from auth details

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescriptionSchema
200Permission fetches[ object ]
201Created
401Unauthorized
403Forbidden
404Fetching permission failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-philippines​

Philippines specific Tenant APIs

/v1/tenants/ph​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoIndia
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestPhilippinesbodyorgSignUpRequestPhilippinesYesOrgSignUpRequestPhilippines
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestPhilippines
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestPhilippines
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoPhilippines
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoIndia
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestPhilippinesbodyorgSignUpRequestPhilippinesYesOrgSignUpRequestPhilippines
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestPhilippines
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/ph/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoPhilippines
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
TenantInfoPhilippinesbodyTenantInfoPhilippinesYesTenantInfoPhilippines
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoIndia
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-sa​

Saudi Arabia specific Tenant APIs

/v1/tenants/sa​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoSA
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestSAbodyorgSignUpRequestSAYesOrgSignUpRequestSA
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestSA
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestSA
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoSA
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoSA
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestSAbodyorgSignUpRequestSAYesOrgSignUpRequestSA
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestSAbodyorgSignUpRequestSAYesOrgSignUpRequestSA
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/sa/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoSA
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoSAbodytenantInfoSAYesTenantInfoSA
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoSA
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-controller-uk​

UK specific Tenant APIs

/v1/tenants/uk​

PATCH​

Summary​

Update tenant attributes.

Description​

API to update attributes of existing tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant attributes has been updated successfully.TenantInfoUK
204No Content
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/affiliate/organisation​

POST​

Summary​

Organization Setup by an affiliate user

Description​

API to setup organization by an affiliate user

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestUKbodyorgSignUpRequestUKYesOrgSignUpRequestUK
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup by an affiliate user has been done successfully.SignUpResponse
400Invalid request to organization setup by an affiliate user
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/bookkeeper/client​

POST​

Summary​

Bookkeeper client setup

Description​

API to setup Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestUK
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Bookkeeper client setup successSignUpResponse
400Bookkeeper client setup fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Bookkeeper client update

Description​

API to update Bookkeeper client

Parameters​
NameLocated inDescriptionRequiredSchema
bookkeeperClientRequestbodybookkeeperClientRequestYesBookkeeperClientRequestUK
Responses​
CodeDescriptionSchema
200Bookkeeper client update successTenantInfoUK
201Created
400Bookkeeper client update fail
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/details​

GET​

Summary​

Get tenant details of logged in user.

Description​

API to get tenant information of logged in user.

Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoUK
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/organisation​

POST​

Summary​

Organization Setup

Description​

API to setup organization

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestUKbodyorgSignUpRequestUKYesOrgSignUpRequestUK
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been done successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Complete organization setup

Description​

API to complete organization setup

Parameters​
NameLocated inDescriptionRequiredSchema
orgSignUpRequestbodyorgSignUpRequestYesOrgSignUpRequestUK
Responses​
CodeDescriptionSchema
200OKSignUpResponse
201Organization setup has been completed successfully.SignUpResponse
400Invalid request to organization setup.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/reset​

DELETE​

Summary​

Reset Tenant

Description​

Api to reset Tenant

Responses​
CodeDescriptionSchema
200Tenant reset successfully.SignUpResponse
204No Content
401Unauthorized
403Forbidden
404Failed to reset Tenant.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/users​

POST​

Summary​

API to bulk add users to current tenant

Description​

API to bulk add users to current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users added successfully
201Created
401Unauthorized
403Forbidden
404Users assignment to tenant failed
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to bulk remove users from current tenant

Description​

API to bulk remove users from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdsbodyuserIdsYes[ long ]
Responses​
CodeDescription
200Users removed successfully
204No Content
401Unauthorized
403Forbidden
404Users removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/verify​

POST​

Summary​

Tenant verification

Description​

API to verify a tenant after successful sign up.

Parameters​
NameLocated inDescriptionRequiredSchema
oAuthAccountVerifyRequestbodyoAuthAccountVerifyRequestYesOAuthAccountVerifyRequest
Responses​
CodeDescription
200Tenant has been verified successfully.
201Created
401Unauthorized
403Forbidden
404Either Tenant or Recovery token is no longer valid.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/uk/{id}​

GET​

Summary​

Get tenant by id.

Description​

API to get tenant information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information has been fetched successfully.TenantInfoUK
401Unauthorized
403Forbidden
404Tenant with same name is already registered.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfoUKbodytenantInfoUKYesTenantInfoUK
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfoUK
201Created
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete tenant

Description​

API to delete tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant has been deleted successfullySignUpResponse
204No Content
401Unauthorized
403Forbidden
404Tenant deletion failed
Security​
Security SchemaScopes
Authorizationglobal

tenant-settings-controller​

Organization level Settings

/v1/tenants/{id}/settings​

GET​

Summary​

Get tenant settings by section

Description​

Fetch tenant settings by section API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
sectionquerysectionNostring
Responses​
CodeDescriptionSchema
200Tenant section information fetched successfully.TenantSettings
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/barcode​

POST​

Summary​

Update tenant barcode details

Description​

Save/update tenant barcode details API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantBarcodeSettingDetailsbodytenantBarcodeSettingDetailsYesTenantBarcodeSettingDetails
Responses​
CodeDescriptionSchema
200Tenant barcode details updated successfully.TenantBarcodeSettingDetails
201Created
400Tenant barcode details could not be updated because of insufficient data.
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

API to delete barcode setting from current tenant

Description​

API to delete barcode setting from current tenant

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescription
200Barcode setting removed successfully
204No Content
401Unauthorized
403Forbidden
404Barcode setting removal from tenant failed
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/controlaccount​

POST​

Summary​

Update tenant control account details

Description​

Update Tenant TCS Settings

Parameters​
NameLocated inDescriptionRequiredSchema
controlAccountDetailsbodycontrolAccountDetailsYesTenantControlAccountsDetails
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant control account details updated successfully.TenantControlAccountsDetails
201Created
400Tenant control account details could not be updated because of insufficient data.
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/finance​

POST​

Summary​

Update tenant finance details

Description​

Save/update tenant finance details API

Parameters​
NameLocated inDescriptionRequiredSchema
financeDetailsbodyfinanceDetailsYesTenantFinanceDetails
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant finance details updated successfully.TenantFinanceDetails
201Created
400Tenant finance details could not be updated because of insufficient data.
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/info​

GET​

Summary​

Get tenant basic info

Description​

Fetch tenant details API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Tenant information fetched successfully.TenantDetails
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Tenant details update

Description​

Update tenant details API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
requestbodyrequestYesTenantUpdateRequest
Responses​
CodeDescriptionSchema
200Tenant information updated successfully.TenantDetails
201Created
400Tenant could not be updated because of insufficient data.
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/inventory​

POST​

Summary​

Update tenant inventory details

Description​

Save/update tenant inventory details API

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
inventoryDetailsbodyinventoryDetailsYesTenantInventoryDetails
Responses​
CodeDescriptionSchema
200Tenant inventory details updated successfully.TenantInventoryDetails
201Created
400Tenant inventory details could not be updated because of insufficient data.
401Cannot access information of different tenant.
403Forbidden
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/name​

POST​

Summary​

updateName

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
updateNameRequestbodyupdateNameRequestYesTenantUpdateNameRequest
Responses​
CodeDescriptionSchema
200OKboolean
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/tcs​

GET​

Summary​

Get Tenant TCS Settings List

Description​

Get Tenant TCS Settings List

Responses​
CodeDescriptionSchema
200OK[ object ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Save Tenant TCS Settings

Description​

Save Tenant TCS Settings

Parameters​
NameLocated inDescriptionRequiredSchema
tcsSettingsRequestbodytcsSettingsRequestYesTCSSettingsRequest
Responses​
CodeDescriptionSchema
200OKTCSSettingsResponse
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/tcs/accountCode/{accountCode}​

GET​

Summary​

Get Tenant TCS Settings List

Description​

Get Tenant TCS Settings List by account code

Parameters​
NameLocated inDescriptionRequiredSchema
accountCodepathaccountCodeYesstring
Responses​
CodeDescriptionSchema
200OK[ TCSSettingsResponse ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/tcs/nature​

GET​

Summary​

Get TCS Collection Nature List

Description​

Get TCS Collection Nature List

Responses​
CodeDescriptionSchema
200OK[ object ]
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Create TCS Collection Nature

Description​

Create Tenant TCS Collection Nature

Parameters​
NameLocated inDescriptionRequiredSchema
tcsCollectionNatureRequestbodytcsCollectionNatureRequestYesTCSCollectionNatureRequest
Responses​
CodeDescriptionSchema
200OKTCSCollectionNatureResponse
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/tcs/{tcs_id}​

GET​

Summary​

Get Tenant TCS Settings By Id

Description​

Get Tenant TCS Settings By Id

Parameters​
NameLocated inDescriptionRequiredSchema
tcs_idpathtcs_idYeslong
Responses​
CodeDescriptionSchema
200OKTCSSettingsResponse
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update Tenant TCS Settings

Description​

Update Tenant TCS Settings

Parameters​
NameLocated inDescriptionRequiredSchema
tcsSettingsRequestbodytcsSettingsRequestYesTCSSettingsRequest
tcs_idpathtcs_idYeslong
Responses​
CodeDescriptionSchema
200OKTCSSettingsResponse
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

Delete Tenant TCS Settings

Description​

Delete Tenant TCS Settings

Parameters​
NameLocated inDescriptionRequiredSchema
tcs_idpathtcs_idYeslong
Responses​
CodeDescription
200OK
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/tcs/{tcs_id}/status/{status}​

PATCH​

Summary​

Update Tenant TCS Settings

Description​

Update Tenant TCS Settings

Parameters​
NameLocated inDescriptionRequiredSchema
statuspathstatusYesstring
tcs_idpathtcs_idYeslong
Responses​
CodeDescriptionSchema
200OKboolean
204No Content
401Unauthorized
403Forbidden
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/update​

PATCH​

Summary​

Update tenant information

Description​

API to update a tenant information.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
tenantInfobodytenantInfoYesTenantAttributeRequest
Responses​
CodeDescriptionSchema
200Tenant information has been updated successfully.TenantInfo
204No Content
400Tenant with same name is already registered.
401Unauthorized
403Forbidden
404Tenant does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/updateaccount​

PUT​

Summary​

Update account in Settings By Id

Description​

Update account in Settings By Id

Parameters​
NameLocated inDescriptionRequiredSchema
codesbodycodesYes[ string ]
Responses​
CodeDescription
200Updated account in Settings By Id successfully.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/tenants/{id}/settings/work_order​

POST​

Summary​

Update tenant work order details

Description​

Save/update tenant work order details API

Parameters​
NameLocated inDescriptionRequiredSchema
tenantWorkOrderDetailsbodytenantWorkOrderDetailsYesTenantWorkOrderDetails
Responses​
CodeDescriptionSchema
200Tenant work order details updated successfully.TenantWorkOrderDetails
400Tenant work order details could not be updated because of insufficient data.
401Cannot access information of different tenant.
404Tenant with the id not found.
Security​
Security SchemaScopes
Authorizationglobal

user-controller​

User Management

/v1/users​

GET​

Summary​

Search users.

Description​

API to search existing users.

Parameters​
NameLocated inDescriptionRequiredSchema
limitquerylimitNointeger
pagequerypageNointeger
queryqueryqueryNostring
searchquerysearchNostring
sortquerysortNostring
sortDirquerysortDirNostring
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

DEPRECATED

Summary​

User Creation

Description​

API to create a user.

Parameters​
NameLocated inDescriptionRequiredSchema
appUserCreateRequestbodyappUserCreateRequestYesAppUserCreateRequest
Responses​
CodeDescriptionSchema
200OKUserDto
201User has been created successfully.UserDto
400User with same username is already exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/all​

GET​

Summary​

Search users.

Description​

API to search existing users.

Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserShortInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/basic-info​

GET​

Summary​

Users count by application

Description​

API to Get Users count by application

Parameters​
NameLocated inDescriptionRequiredSchema
appNamequeryappNameNostring
iamUserIdsqueryiamUserIdsNo[ long ]
namequerynameNostring
rolequeryroleNostring
Responses​
CodeDescriptionSchema
200Users count by application is fetchedTenantInfo
401Unauthorized
403Forbidden
404Not able to fetch count by application
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/bulk-invite​

POST​

Summary​

Invite bulk user to a tenant

Description​

Invite bulk user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
inviteBulkUserRequestsbodyinviteBulkUserRequestsYes[ InviteBulkUserRequest ]
Responses​
CodeDescriptionSchema
200User added to a tenant successfully[ UserDto ]
201Created
400User tenant mapping creation failed
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/changepassword​

POST​

Summary​

Change user password

Description​

Change user password

Parameters​
NameLocated inDescriptionRequiredSchema
userChangePasswordRequestbodyuserChangePasswordRequestYesUserChangePasswordRequest
Responses​
CodeDescription
200Password changed successfully.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/email​

PUT​

Summary​

Update logged in mobile user email.

Description​

API to update mobile user email.

Parameters​
NameLocated inDescriptionRequiredSchema
userDtobodyuserDtoYesUserDto
Responses​
CodeDescription
200User email has been updated successfully.
201Created
400User does not exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/exclude​

POST​

Summary​

Fetch users excluding given ids

Description​

API to fetch existing users excluding given ids

Parameters​
NameLocated inDescriptionRequiredSchema
idsbodyidsYes[ long ]
limitquerylimitNointeger
pagequerypageNointeger
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.[ UserShortInfo ]
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/iam/{id}​

PATCH​

Summary​

Update user attributes.

Description​

API to update attributes of existing user.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
userbodyuserYesobject
Responses​
CodeDescriptionSchema
200User attributes has been updated successfully.UserDto
204No Content
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/ids​

POST​

Summary​

Get users by list of ids.

Description​

API to get users details by ids.

Parameters​
NameLocated inDescriptionRequiredSchema
idsbodyidsYes[ long ]
Responses​
CodeDescriptionSchema
200OK[ UserShortInfo ]
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/info​

POST​

Summary​

Get users nfo by list of ids.

Description​

API to get users info by ids.

Parameters​
NameLocated inDescriptionRequiredSchema
idsbodyidsYes[ long ]
Responses​
CodeDescriptionSchema
200OK[ UserShortInfo ]
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/invite​

POST​

Summary​

Invite a user to a tenant

Description​

Invite a user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
inviteUserRequestbodyinviteUserRequestYesInviteUserRequest
Responses​
CodeDescriptionSchema
200User added to a tenant successfullyUserDto
201Created
400User tenant mapping creation failed
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/mfa-disable​

POST​

Summary​

Disable MFA for Users

Description​

Disable MFA for Users

Parameters​
NameLocated inDescriptionRequiredSchema
mfaDisableRequestbodymfaDisableRequestYesMFADisableRequest
Responses​
CodeDescriptionSchema
200Disable MFA for User successfulAppUserResponseInfo
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/registered/contacts​

POST​

Summary​

Returns list of users for a given list of contact numbers

Description​

Returns list of users for a given list of contact numbers

Parameters​
NameLocated inDescriptionRequiredSchema
registeredUserRequestbodyregisteredUserRequestYesRegisteredUserRequest
Responses​
CodeDescriptionSchema
200Registered contacts list fetched successfully[ ContactAndEmail ]
201Created
400Failed to get registered user list
401Unauthorized
403Forbidden
404Registered user list not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/registered/id​

POST​

Summary​

Returns user id for a give email or contact

Description​

Returns user id for a give email or contact

Parameters​
NameLocated inDescriptionRequiredSchema
registeredUserRequestbodyregisteredUserRequestYesRegisteredUserIdRequest
Responses​
CodeDescriptionSchema
200Registered contacts id fetched successfullylong
201Created
400Failed to get registered user detail
401Unauthorized
403Forbidden
404Registered user not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/resetpassword​

POST​

Summary​

Reset user password

Description​

Reset user password

Parameters​
NameLocated inDescriptionRequiredSchema
resetPasswordRequestbodyresetPasswordRequestYesResetPasswordRequest
Responses​
CodeDescription
200Password reset successfully.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/roles​

GET​

Summary​

Get logged-in user roles

Description​

API to get logged-in user roles

Responses​
CodeDescriptionSchema
200Role information has been fetched successfully.UserCache
401Unauthorized
403Forbidden
404User does not exist.
500Fail to get short code roles in all applications
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/roles/assign​

POST​

DEPRECATED

Summary​

Assign Roles For Users

Description​

Assign List of Role for Users

Parameters​
NameLocated inDescriptionRequiredSchema
assignUserRoleRequestbodyassignUserRoleRequestYesAssignUserRoleRequest
Responses​
CodeDescription
200Assign Roles for Users success.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/roles/unassign​

POST​

DEPRECATED

Summary​

Unassign roles for users

Description​

Unassign roles for users

Parameters​
NameLocated inDescriptionRequiredSchema
unAssignUserRoleRequestbodyunAssignUserRoleRequestYesUnAssignUserRoleRequest
Responses​
CodeDescription
200Unassigned roles for users successfully.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/shops​

GET​

Summary​

Validate user access for shops

Description​

API to Validate user access for shops

Parameters​
NameLocated inDescriptionRequiredSchema
userIdqueryuserIdYeslong
Responses​
CodeDescriptionSchema
200User has a shop associated with themstring
401User don't have a shop associated with them
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/switchtenant​

POST​

Summary​

Switch tenant for a loggedin user

Description​

Switch tenant for a loggedin user

Parameters​
NameLocated inDescriptionRequiredSchema
switchTenantRequestbodyswitchTenantRequestYesSwitchTenantRequest
Responses​
CodeDescriptionSchema
200Tenant switched successfullyAuthenticationResultType
201Created
400Failed to switch tenant
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/tenants​

GET​

Summary​

Get user tenant mapping list.

Description​

Get user tenant mapping list.

Responses​
CodeDescriptionSchema
200User tenant list fetched successfully[ UserTenantMappingResponse ]
400Failed to get User's tenant list.
401Unauthorized
403Forbidden
404Tenant list not found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Add/invite a user to a tenant

Description​

Add/invite a user to a tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantMappingrequestbodyuserTenantMappingrequestYesUserTenantRelRequest
Responses​
CodeDescriptionSchema
200User added to a tenant successfullyUserDto
201Created
400User tenant mapping creation failed
401Unauthorized
403Forbidden
404Tenant not found
Security​
Security SchemaScopes
Authorizationglobal

DELETE​

Summary​

Remove user from tenant

Description​

Remove user from tenant

Parameters​
NameLocated inDescriptionRequiredSchema
delUserTenantMapRequestbodydelUserTenantMapRequestYesDelUserTenantMapRequest
Responses​
CodeDescription
200Tenant removed successfully
204No Content
400User tenant mapping deletion failed
401Unauthorized
403Forbidden
404Tenant or User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/tenants-roles​

DELETE​

Summary​

Remove user from tenant

Description​

Remove user from tenant

Parameters​
NameLocated inDescriptionRequiredSchema
delUserTenantMapRequestbodydelUserTenantMapRequestYesDelUserTenantMapRequest
Responses​
CodeDescription
200Tenant removed successfully
204No Content
400User tenant mapping deletion failed
401Unauthorized
403Forbidden
404Tenant or User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/update-invite​

POST​

Summary​

Update Invite status for Bookkeeper Team/Client

Description​

API to update Invite status for Bookkeeper Team/Client

Parameters​
NameLocated inDescriptionRequiredSchema
userbodyuserYesUserShortInfo
Responses​
CodeDescription
200Invite status updated successfully for user.
201Created
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/update/info​

POST​

Summary​

Assign Roles For Users

Description​

Assign List of Role for Users

Parameters​
NameLocated inDescriptionRequiredSchema
userInfoWithRolesbodyuserInfoWithRolesYesUpdateUserInfoWithRoles
Responses​
CodeDescription
200Assign Roles for Users success.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/update/info-role​

POST​

Summary​

Assign Roles For Users

Description​

Assign List of Role for Users

Parameters​
NameLocated inDescriptionRequiredSchema
updateUserInfoModuleRolebodyupdateUserInfoModuleRoleYesUpdateUserInfoModuleRole
Responses​
CodeDescription
200Assign Roles for Users success.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

DEPRECATED

Summary​

Assign Roles For Users

Description​

Assign List of Role for Users

Parameters​
NameLocated inDescriptionRequiredSchema
updateUserInfoModuleRolebodyupdateUserInfoModuleRoleYesUpdateUserInfoModuleRole
Responses​
CodeDescription
200Assign Roles for Users success.
204No Content
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/update/people/info​

POST​

Summary​

Assign Roles For Users

Description​

Assign List of Role for Users

Parameters​
NameLocated inDescriptionRequiredSchema
userInfoWithRolesbodyuserInfoWithRolesYesUpdateUserInfoWithRoles
Responses​
CodeDescription
200Assign Roles for Users success.
201Created
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/user​

GET​

Summary​

Get Users by tenant id.

Description​

API to Get Users by tenant id.

Responses​
CodeDescriptionSchema
200User information has been fetched successfully.TenantInfo
401Unauthorized
403Forbidden
404User not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/user-ip​

GET​

Summary​

Get Ip Address of User

Description​

Api to get Ip Address of User

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
userIdqueryuserIdYeslong
Responses​
CodeDescriptionSchema
200Successfully fetched Ip Addressstring
401Not able to fetch Ip Address
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/user-with-role-across-orgs/{userId}​

GET​

Summary​

Get Admin User with Access to Multiple Orgs

Description​

Fetches a user with the ADMIN role across multiple organizations.

Parameters​
NameLocated inDescriptionRequiredSchema
userIdpathuserIdYeslong
Responses​
CodeDescriptionSchema
200Fetched successfullyUserTenantRoleResponse
400Bad request, invalid userId or role
404User not found or no access to multiple orgs
500Internal server error

/v1/users/userByTenantId/{tenantId}​

GET​

Summary​

Get user record by tenant id

Description​

API to get user record by tenant id.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdpathtenantIdYeslong
Responses​
CodeDescriptionSchema
200OKlong
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/userinfo​

GET​

Summary​

Search users.

Description​

API to search existing users.

Parameters​
NameLocated inDescriptionRequiredSchema
exclude_mfaqueryexclude_mfaNoboolean
limitquerylimitNointeger
pagequerypageNointeger
queryqueryqueryNostring
searchquerysearchNostring
sortquerysortNostring
sortDirquerysortDirNostring
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserShortInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/userinfo/short​

GET​

Summary​

Search users.

Description​

API to search existing users.

Parameters​
NameLocated inDescriptionRequiredSchema
limitquerylimitNointeger
pagequerypageNointeger
sortquerysortNostring
sortDirquerysortDirNostring
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.UserShortInfo
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/users/count​

GET​

Summary​

Users count by application

Description​

API to Get Users count by application

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200Users count by application is fetchedTenantInfo
401Unauthorized
403Forbidden
404Not able to fetch count by application
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/validate​

GET​

Summary​

Validate user access for tenant

Description​

API to Validate user access for tenant

Parameters​
NameLocated inDescriptionRequiredSchema
userIdqueryuserIdYeslong
Responses​
CodeDescription
200Tenant is authorized to access the user
401Tenant is unauthorized to access the user
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/{id}​

GET​

Summary​

Get user by id.

Description​

API to get user information by id.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200User information has been fetched successfully.AppUserResponseInfo
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

PUT​

Summary​

Update logged in mobile user email.

Description​

API to update mobile user email.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
userDtobodyuserDtoYesUserDto
Responses​
CodeDescriptionSchema
200User email has been updated successfully.UserDto
201Created
400User does not exist.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

PATCH​

Summary​

Update user attributes.

Description​

API to update attributes of existing user.

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
userbodyuserYesobject
Responses​
CodeDescriptionSchema
200User attributes has been updated successfully.UserDto
204No Content
401Unauthorized
403Forbidden
404User does not exist.
Security​
Security SchemaScopes
Authorizationglobal

affiliate-controller​

Affiliate User Management

/v1/users/affiliate/add-user​

POST​

Summary​

Add user with roles tenant for an affiliated user

Description​

Add user with roles tenant for an affiliated user

Parameters​
NameLocated inDescriptionRequiredSchema
userTenantMappingRequestbodyuserTenantMappingRequestYesUserTenantRelCreationRequest
Responses​
CodeDescriptionSchema
200User added to tenant with affiliated user successfullyUserDto
201Created
401Unauthorized
403Forbidden
404Affiliate User info not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/affiliate/tenants-apps​

GET​

Summary​

Get all tenant for an affiliated user

Description​

Get all tenant for an affiliated user

Responses​
CodeDescriptionSchema
200Affiliate User information has been fetched successfully.AffiliateTenantInfo
401Unauthorized
403Forbidden
404Affiliate User info not found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/affiliate/tenants-subscription/{id}​

GET​

Summary​

Get a tenant's subscription details for an affiliated user

Description​

Get a tenant's subscription details for an affiliated user

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Affiliate User information has been fetched successfully.TenantSubscription
401Unauthorized
403Forbidden
404Affiliate User info not found
Security​
Security SchemaScopes
Authorizationglobal

user-invitation-controller​

Manage User Invitations

/v1/users/books/invite​

GET​

Summary​

Get all Invites and users for a tenant

Description​

API to get all invites and users

Parameters​
NameLocated inDescriptionRequiredSchema
appNamequeryappNameNostring
Responses​
CodeDescriptionSchema
200Invites and users has been fetched successfully.TenantInviteResponse
401Unauthorized
403Forbidden
404Not Found
500Unable to fetch all invites and users
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Invite a user

Description​

API to invite a new user

Parameters​
NameLocated inDescriptionRequiredSchema
appInviteRequestbodyappInviteRequestYesAppInviteResponse
Responses​
CodeDescriptionSchema
200OKAppInviteResponse
201User has been invited successfully.AppInviteResponse
400User is already part of the organization or invite already sent
401Unauthorized
403Forbidden
404Not Found
500Unable to sent invite to user
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/books/invite/all​

GET​

Summary​

Get all invites for the current user

Description​

API to get all invites for the current user

Responses​
CodeDescriptionSchema
200Invites have been fetched successfully.[ InviteResponse ]
500Unable to fetch invites
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/books/invite/cancel/{id}​

DELETE​

Summary​

Update Invite status

Description​

API to update invite status

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Invitation updated successfully.ResponseEntity
204No Content
400Unable to update invitation
401Unauthorized
403Forbidden
500Unable to update invitation
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/books/invite/code/{code}​

PATCH​

Summary​

Update Invite status

Description​

API to update invite status

Parameters​
NameLocated inDescriptionRequiredSchema
codepathcodeYesstring
Responses​
CodeDescriptionSchema
200Invitation updated successfully.AppInviteResponse
204No Content
400Unable to update invitation
401Unauthorized
403Forbidden
500Unable to update invitation
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/books/invite/reject/{id}​

DELETE​

Summary​

Reject invite

Description​

API to reject invite

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescription
200Invitation updated successfully.
400Unable to update invitation
500Unable to update invitation
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/books/invite/resend/{id}​

PATCH​

Summary​

Update Invite status

Description​

API to update invite status

Parameters​
NameLocated inDescriptionRequiredSchema
idpathidYeslong
Responses​
CodeDescriptionSchema
200Invitation updated successfully.AppInviteResponse
204No Content
400Unable to update invitation
401Unauthorized
403Forbidden
500Unable to update invitation
Security​
Security SchemaScopes
Authorizationglobal

mobile-email-linking-controller​

Mobile user Email link

POST​

Summary​

Mobile user email De-linking.

Description​

API De-link email to mobile user.

Responses​
CodeDescriptionSchema
200Email de-link successfully.string
201Created
400Email de-link unsuccessful
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

POST​

Summary​

Mobile user email linking.

Description​

API link email to mobile user.

Parameters​
NameLocated inDescriptionRequiredSchema
emailbodyemailYesstring
Responses​
CodeDescriptionSchema
200A verification email has been sent successfully.ResponseEntity
201Created
208User email is already linked.ResponseEntity
400A verification email has not been sent successfully.
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/email/regenerate​

POST​

Summary​

Regenerate Email verification API

Description​

Regenerate Email verification API

Responses​
CodeDescriptionSchema
200Email de-link successfully.string
201Created
400Email de-link unsuccessful
401Unauthorized
403Forbidden
404Not Found
Security​
Security SchemaScopes
Authorizationglobal

/v1/users/email/verify​

POST​

Summary​

Mobile user email verification.

Description​

API email verfication for mobile user.

Parameters​
NameLocated inDescriptionRequiredSchema
emailLinkRequestbodyemailLinkRequestYesEmailLinkRequest
Responses​
CodeDescriptionSchema
200Email has been linked successfully.ResponseEntity
201Created
400Email has not been linked successfully.
401Unauthorized
403Forbidden
404Provided confirmation code information is invalid
410The Confirmation code has been expired. Please generate a new confirmation code.
Security​
Security SchemaScopes
Authorizationglobal

admin-controller​

Admin Controller

/admin/users/users/count​

GET​

Summary​

Get user count by application

Description​

API to find out users count in each application for a tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200OK[ AppUserCountTuple ]
404Not Found

/admin/users/all/count​

GET​

Summary​

Get all user counts by application

Description​

API to find out users count (guest and non-guest) in each application for a tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200OK[ AppUserCountResponse ]
404Not Found

/admin/users/non-guest/count​

GET​

Summary​

Get non-guest user count by application

Description​

API to find out non-guest users count in each application for a tenant.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200OK[ NonGuestUserResponseDto ]
404Not Found

/admin/users/tenant-info​

GET​

Summary​

Get tenant info

Description​

API to find out tenant info for a tenant id.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200OKTenantShortInfo

/admin/users/tenant-active-details​

GET​

Summary​

Get tenant active details

Description​

API to find out tenant active details for a tenant id.

Parameters​
NameLocated inDescriptionRequiredSchema
tenantIdquerytenantIdYeslong
Responses​
CodeDescriptionSchema
200OKTenantActiveDetails

/admin/users/add-permission​

POST​

Summary​

Add user permission for apps

Description​

Add user Permission for apps

Parameters​
NameLocated inDescriptionRequiredSchema
userPermissionReqbodyuserPermissionReqYes[ UserPermissionRequest ]
Responses​
CodeDescriptionSchema
200Permission added to user successfully[ UserPermissionResponse ]
404Adding permission to user failed

/admin/users/add-user​

POST​

Summary​

Add user with module permission

Description​

Add user with module permission

Parameters​
NameLocated inDescriptionRequiredSchema
userPermissionReqbodyuserPermissionReqYes[ IamUserWithModuleRolesCreateRequest ]
Responses​
CodeDescriptionSchema
200User added successfullyboolean
404Failed to add users

/admin/users/update-user​

POST​

Summary​

Update user with info role permission

Description​

Update user with info role permission

Parameters​
NameLocated inDescriptionRequiredSchema
iamUserInfoRoleUpdateRequestsbodyiamUserInfoRoleUpdateRequestsYes[ IamUserInfoRoleUpdateRequest ]
Responses​
CodeDescriptionSchema
200User updated successfullyboolean
404Failed to add users

admin-invitation-controller​

Admin Invitation Controller

/admin/books/invite/code/{code}​

GET​

Summary​

Get invitation by code

Description​

API to get invitation info for an invite code.

Parameters​
NameLocated inDescriptionRequiredSchema
codepathcodeYesstring
Responses​
CodeDescriptionSchema
200OKAppInviteResponse

password-policy-controller​

Password Policy API

/v1/tenants/password-policy​

GET​

Summary​

Get password policy for tenant

Description​

Get password policy for tenant

Responses​
CodeDescriptionSchema
200Password policy fetchedPasswordPolicyDto
404Fetching password policy failed

POST​

Summary​

Create/update password policy for tenant

Description​

Create/update password policy for tenant

Parameters​
NameLocated inDescriptionRequiredSchema
requestbodyrequestYesPasswordPolicyDto
Responses​
CodeDescriptionSchema
200Password policy created/updatedPasswordPolicyDto
404Creating/updating password policy failed

/v1/tenants/password-policy/expire-passwords​

POST​

Summary​

Expire password for existing users

Description​

API to expire password for existing users

Responses​
CodeDescription
200Expired password for existing users
404Expiring password for existing users failed

Models​

AcceptInvitationRequest​

NameTypeDescriptionRequired
emailstringEmail address used for invite
Example: "user@example.com"
No
iamUserIdlongIAM User ID of the user accepting invite
Example: 987654321
No
inviteCodestringInvitation Code
Example: "abc-123"
No
tenantIdlongTenant ID
Example: 123
No

Address​

NameTypeDescriptionRequired
address1stringAddress line 1
Example: "218, Robinson Road"
No
address2stringAddress line 2
Example: "Downtown"
No
citystringCity
Example: "C001"
No
contactNamestringcontact name for address
Example: "John Smith"
No
countrystringCountry
Example: "C001"
No
destinationOfSupplystringstate in India
Example: "Maharashtra"
No
placeOfSupplystringstate in India
Example: "Punjab"
No
postalCodestringPostal Code
Example: 123456
No
preferredbooleanIs this a default address?
Example: true
No
statestringState
Example: "CS001"
No

AffiliateSignupRequest​

NameTypeDescriptionRequired
contactstringUser Contact Number
Example: 12345678
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
passwordstringPassword
Example: "**********"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No

AffiliateTenantInfo​

NameTypeDescriptionRequired
applicationInfo[ ApplicationInfo ]No
countrystringNo
currencystringNo
isDemoOrgbooleanNo
namestringNo
tenantIdlongNo

AppInvite​

NameTypeDescriptionRequired
appNamestringNo
createdAtdateTimeNo
createdBylongNo
deletedbooleanNo
emailstringNo
gdprMigratedbooleanNo
idlongNo
inviteCodestringNo
inviteCountintegerNo
inviterTokenstringNo
rolestringNo
statusstringNo
tenantIdlongNo
updatedAtdateTimeNo
updatedBylongNo

AppInviteResponse​

NameTypeDescriptionRequired
appNamestringApplication Name
Example: "ERP"
No
emailstringEmail of the user.
Example: "abc@gmail.com"
No
firstNamestringUser first name
Example: "John"
No
iamUserIdlongIam User Id
Example: 1234
No
idlongInvitation ID
Example: 1
No
inviteCodestringUnique Invitation Code
Example: "3609848a-394a-41c6-817f-c81e362881ed"
No
inviterTokenstringInviter Token
Example: "token"
No
lastNamestringUser last name
Example: "Doe"
No
rolestringAssigned role to the user.
Example: "business"
No
statusstringInvitation Sttaus
Example: "SENT"
No
tenantIdlongTenant Id
Example: 1234
No
userIdlongTenant User Id
Example: 1234
No
userNamestringusername
Example: "john.doe@deskera.com"
No

AppPermissionRequest​

NameTypeDescriptionRequired
appNamestringAPP Name
Example: "ERP"
No
moduleUuids[ string ]List of module UUIDNo
rgShortCodestringRole Group Short Code
Example: "business"
No

AppPermissionResponse​

NameTypeDescriptionRequired
appNamestringAPP Name
Example: "ERP"
No
moduleUuids[ string ]List of module UUIDNo
modules[ ModuleDto ]List of moduleNo
rgShortCodestringRole Group Short Code
Example: "business"
No
roleGroupRoleGroupDtoRole group detailsNo

AppRoleInfo​

NameTypeDescriptionRequired
appNamestringApplication Name
Enum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"
Example: "ERP"
No
rolestringRole
Example: "admin"
No

AppUserBasicInfoDto​

NameTypeDescriptionRequired
contactstringNo
deletedbooleanNo
emailstringNo
firstNamestringNo
lastNamestringNo

AppUserCountResponse​

NameTypeDescriptionRequired
applicationNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
guestCountintegerNo
nonGuestCountintegerNo

AppUserCountTuple​

NameTypeDescriptionRequired
applicationNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
userCountintegerNo

AppUserCreateRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
No
bkPlanDetailsstringSelected plan details if client pays.
Example: "MONTHLY/YEARLY"
No
bkPlanIdstringSelected plan id if client pays.
Example: 1234
No
bookkeeperPaysbooleanbook keeper team pays or client pays
Example: false
No
contactstringUser Contact Number
Example: 12345678
No
createUserInTenantbooleanFlag to control creation of users in tenant
Example: true
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
isBookkeeperbooleanFlag indicate user book keeper
Example: true
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
isGoUserbooleanGo request to add user to ERP
Example: false
No
isPartnerbooleanFlag indicate partner book keeper
Example: true
No
isTeambooleanbook keeper team or client
Example: false
No
isUserNotUpdatedbooleanFlag maintain to identify if user is added through invite flow.
Example: false
No
isWebsitebooleanFlag to indicate signup from website
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
moduleUuids[ string ]List of module UUIDNo
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
passwordstringPassword
Example: "**********"
No
roleGroupstringRole Group
Example: "admin"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No
socialAuthstringNeeded, if user is signing up via social login
Example: "GOOGLE"
No
sourcestringRegistration source DESKERA/SHOPIFY
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "Deskera"
No

AppUserMapping​

NameTypeDescriptionRequired
appNamestringNo
emailstringNo
firstNamestringNo
isGuestbooleanNo
lastNamestringNo
rolestringNo
userIdlongNo

AppUserResponseInfo​

NameTypeDescriptionRequired
address[ Address ]List of Address.No
appUserRoleXrefs[ AppUserRoleInfo ]User RolesNo
authUserIdstringAuth0 User ID
Example: `"auth0
5d70ec986e382a0d12a4ff22"`
contactstringUser Contact
Example: 12345678
No
deletedbooleanDelete Flag
Example: false
No
departmentstringUser Department
Example: "Finance"
No
designationstringUser Designation
Example: "Accountant"
No
emailstringUser email
Example: "jsmith@example.com"
No
firstNamestringUser First Name
Example: "John"
No
genderLookUpCodestringGender
Example: "Mr."
No
iamUserIdlongIam User Id
Example: 1
No
idlongPrimary Key
Example: 1
No
isEmailVerifiedbooleanEmail is verified or not.No
isMFAEnabledbooleanMFA Enable status.No
lastNamestringUser Last Name
Example: "Doe"
No
profileUrlstringUser profile image path.
Example: "http://deskera.com/user/myprofile.png"
No
socialAuthstringsocial auth
Example: "auth"
No
statusstringStatus like Active/ InActive
Example: "active"
No
tenantIdlongTenant Id
Example: 1
No
tenantNamestringTenant Name
Example: "Sample Tenant"
No
userNamestringUser Name
Example: "jsmith@example.com"
No

AppUserRoleInfo​

NameTypeDescriptionRequired
appNamestringApplication Name
Enum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"
Example: "ERP"
No
permissionsRolePermissionInfoRole PermissionsNo
roleGroupstringRole Group
Example: "admin"
No
roleShortCodestringRole Short Code
Example: "console_user_r"
No
tenantIdlongTenant ID
Example: 12
No

AppUserRoleXref​

NameTypeDescriptionRequired
appNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
appUserUserNo
createdAtdateTimeNo
createdBylongNo
deletedbooleanNo
idlongNo
roleRoleNo
roleGroupRoleGroupNo
tenantIdlongNo
updatedAtdateTimeNo
updatedBylongNo
userIdlongNo

AppUserRolesCreateRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
No
moduleUuids[ string ]List of module UUIDNo
roleGroupstringRole Group
Example: "admin"
No

AppUserShortInfo​

NameTypeDescriptionRequired
appUserRoleXrefs[ AppUserRoleInfo ]User RolesNo
contactstringUser Contact
Example: 12345678
No
currencystringTenant Currency
Example: "SGD"
No
deletedbooleanDelete Flag
Example: false
No
emailstringUser email
Example: "jsmith@example.com"
No
firstNamestringUser First Name
Example: "John"
No
genderLookUpCodestringGender
Example: "Mr."
No
idlongPrimary Key
Example: 1
No
lastNamestringUser Last Name
Example: "Doe"
No
profileUrlstringUser profile image path.
Example: "http://deskera.com/user/myprofile.png"
No
statusstringStatus like Active/ InActive
Example: "active"
No
tenantIdlongTenant Id
Example: 1
No
tenantNamestringTenant Name
Example: "name"
No
userNamestringUser Name
Example: "jsmith@example.com"
No
userTenantsobjectUser TenantsNo

ApplicationInfo​

NameTypeDescriptionRequired
appNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
appUserXref[ AppUserMapping ]No

AppsCustomizationRequestDto​

NameTypeDescriptionRequired
applicationstringNo
configobjectNo
customLabelsCustomLabelsNo
hiddenAppsstringNo
hideKredxInfobooleanNo
isResetCustomLabelsbooleanNo
isResetHiddenAppsbooleanNo
onBoardingSettingOnBoardingSettingNo
prefillDocumentDataPrefillDocumentDataNo
userLanguageUserLanguageDtoNo

AppsCustomizationResponseDto​

NameTypeDescriptionRequired
applicationstringNo
configobjectNo
customLabelsCustomLabelsNo
hiddenAppsstringNo
hideKredxInfobooleanNo
onBoardingSettingOnBoardingSettingNo
prefillDocumentDataPrefillDocumentDataNo
tenantIdlongNo
userIdlongNo
userLanguageUserLanguageDtoNo

AssignUserRoleRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
Yes
clientTenantIdlongclient tenantId
Example: 1234
No
iamUserIds[ long ]List of iamUserIds of users
Example: [4,11,12]
No
isClientbooleanIf assign role is for client
Example: false
No
roleGroup[ string ]Role Group short code
Example: ["accounting","business"]
Yes
userIds[ long ]List users assign
Example: [4,11,12]
Yes

AuthApplicationCreateRequest​

NameTypeDescriptionRequired
contactstringContact Number
Example: "contact"
No
idTokenstringGoogle id token
Example: "idToken"
No

AuthenticationResultType​

NameTypeDescriptionRequired
accessTokenstringNo
expiresInintegerNo
idTokenstringNo
newDeviceMetadataNewDeviceMetadataTypeNo
refreshTokenstringNo
tokenTypestringNo

BookkeeperClientInvite​

NameTypeDescriptionRequired
bookkeeperbooleanNo
createdAtdateTimeNo
createdBylongNo
deletedbooleanNo
emailstringNo
gdprMigratedbooleanNo
idlongNo
statusstringEnum: "INVALID", "ACCEPTED", "REJECTED", "ACTIVE", "INACTIVE", "INVITED"No
tenantIdlongNo
updatedAtdateTimeNo
updatedBylongNo
userTenantMappingUserTenantMappingNo

BookkeeperClientPayment​

NameTypeDescriptionRequired
bookkeeperPaysbooleanTrue if bookkeeper pays, False if client pays
Example: true
No

BookkeeperClientRequest​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestAustralia​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestAustraliaorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestBelgium​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestBelgiumorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestCanada​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestCanadaorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestGermany​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestGermanyorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestIndia​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestIndiaorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestIndonesia​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestIndonesiaorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestIsrael​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestIsraelorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestMalaysia​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestMalaysiaorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestNL​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestNLorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestNZ​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestNZorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestPhilippines​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestPhilippinesorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestSA​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestSAorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestUAE​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestUAEorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperClientRequestUK​

NameTypeDescriptionRequired
clientDefaultUserIdlongUserId of default client user.
Example: 1
No
clientTenantIdlongTenant id of client.
Example: 1
No
orgSignUpRequestOrgSignUpRequestUKorganization complete signupNo
teamInfo[ BookkeeperTeamInfo ]List of Bookkeepers to have access to this clientNo
webSignupRequestWebSignupRequestweb signup requestNo

BookkeeperInviteResponse​

NameTypeDescriptionRequired
bookkeeperIdlongbookkeeperId
Example: 1
No
emailstringUser email
Example: "jsmith@example.com"
No
statusstringStatus of invite email
Enum: "FAIL", "SUCCESS"
Example: "FAIL/SUCCESS"
No

BookkeeperNotifyRequest​

NameTypeDescriptionRequired
currencystringCurrency code.
Example: "SGD"
No
periodicitystringMonthly billing or yearly billing: MONTHLY or YEARLY.
Example: "YEARLY"
No
planNamestringName of the plan upgrade requested: START UP, ESSENTIAL or PROFESSIONAL.
Example: "PROFESSIONAL"
No
planRatenumberRate of the plan.
Example: 239
No

BookkeeperTeam​

NameTypeDescriptionRequired
bookkeeperTenantIdlongNo
createdAtdateTimeNo
createdBylongNo
defaultUserbooleanNo
deletedbooleanNo
idlongNo
manageClientbooleanNo
statusstringEnum: "INVALID", "ACCEPTED", "REJECTED", "ACTIVE", "INACTIVE", "INVITED"No
updatedAtdateTimeNo
updatedBylongNo
userTenantMappingUserTenantMappingNo

BookkeeperTeamInfo​

NameTypeDescriptionRequired
bkTeamIdlongNo
bookkeeperPaysbooleanNo
clientTenantIdlongNo
contactstringNo
emailstringNo
firstNamestringNo
fullNamestringNo
idlongNo
inviteIdlongNo
invitedByClientbooleanNo
isDefaultUserbooleanNo
lastNamestringNo
manageClientbooleanNo
organizationNamestringNo
roleGroupsstringNo
roleNamesstringNo
statusstringNo
switchStatusAllowedbooleanNo
tenantIdlongNo
userIdlongNo
userNamestringNo

BulkAddUserResponse​

NameTypeDescriptionRequired
failure[ IAMUserDto ]No
success[ IAMUserDto ]No

Callable«ResponseEntity»​

NameTypeDescriptionRequired
Callable«ResponseEntity»object

CancelSubscriptionRequest​

NameTypeDescriptionRequired
amountnumberAmount
Example: 99
No
clientTenantIdlongTenant id of Client
Example: 1234
No
clientUserIdlongUser id of Client
Example: 5678
No
currencystringCurrency
Example: "usd"
No
intervalstringBilling interval
Example: "monthly"
No
planIdstringPlan Id
Example: "plan_jeXS4RxX"
No
planNamestringPlan Name
Example: "Essential"
No
trialDaysintegerNumber of trial days
Example: 30
No

ChangeNameDto​

NameTypeDescriptionRequired
emailstringemail of user
Example: "ram@gamil.com"
No
firstNamestringmodified first name
Example: "ram"
No
lastNamestringmodified last name
Example: "kumar"
No

ConfirmForgotPassRequest​

NameTypeDescriptionRequired
confirmationCodestringConfirmation code received through SMS
Example: 123456
Yes
passwordstringPassword to signin
Example: "abcd@123"
Yes
userNamestringUsername
Example: "+65-1234-5678"
Yes

ContactAndEmail​

NameTypeDescriptionRequired
contactstringNo
emailstringNo

ContactCheckRequest​

NameTypeDescriptionRequired
contactstringContact number
Example: "+919999999"
Yes

CustomLabels​

NameTypeDescriptionRequired
customLabelPairobjectNo

DelUserTenantMapRequest​

NameTypeDescriptionRequired
userIdlongUser ID
Example: 1
No

EmailChangeDto​

NameTypeDescriptionRequired
newEmailstringNewly added email
Example: "New email"
No
oldEmailstringEmail to be replaced
Example: "Old email"
No

EmailLinkRequest​

NameTypeDescriptionRequired
confirmationCodestringConfirmation code received through Email
Example: 123456
Yes
passwordstringPassword to signin
Example: "abcd@123"
Yes

FlatRatePercentageListUK​

NameTypeDescriptionRequired
applyFromdateTimeApply Date
Example: "01-01-2020"
No
flatRatePercentagenumberFlat Rate Percentage
Example: 7.3
No

ForgotPasswordRequest​

NameTypeDescriptionRequired
userNamestringUsername
Example: "+65-1234-5678"
Yes

IAMUserDto​

NameTypeDescriptionRequired
appNamestringNo
contactstringNo
emailstringNo
firstNamestringNo
fullNamestringNo
idlongNo
lastNamestringNo
messagestringNo
roleGroupstringNo
tenantIdlongNo
usernamestringNo

IamUserInfoRoleUpdateRequest​

NameTypeDescriptionRequired
tenantIdlongTenant ID
Example: 1
No
userIdlongUser ID
Example: 1
No

IamUserWithModuleRolesCreateRequest​

IamUserWithModuleRolesCreateRequest includes all attributes of WebSignupRequest, plus the following attributes.

NameTypeDescriptionRequired
appUserCreateRequestList[ AppUserRolesCreateRequest ]Role in particular app
Example: [{"roleGroup":"admin","appName":"ERP"}]
No
newOwnerEmailstringNew Owner email
Example: "abc@deskera.com"
No
prepaidCodestringPrepaid Code
Example: "PLAN"
No
tenantIdlongTenant ID
Example: 1
No
userIdlongUser ID
Example: 1
No
isInviteUserbooleanIs invited user?
Example: false
No

InviteBookKeeperRequest​

NameTypeDescriptionRequired
emailId[ string ]Bookkeepers emails to be invitedNo

InviteBookkeeperByIdsRequest​

NameTypeDescriptionRequired
bookkeeperIds[ long ]Bookkeeper idNo

InviteBulkUserRequest​

NameTypeDescriptionRequired
appNamestringDeskera Application Name
Example: "ORGANISATION"
Yes
contactstringContact No
Example: "+65 1245678"
Yes
emailstringUser email
Example: "nguyen.tuan_123@deskera.com"
Yes
firstNamestringuser first name
Example: "John"
Yes
lastNamestringUser last name
Example: "Doe"
Yes
roleGroupstringDeskera Roles
Example: "org_admin"
Yes
usernamestringUsername or Email or Contact Number of User
Example: "example@domain.com"
Yes

InviteResponse​

NameTypeDescriptionRequired
appNamestringApplication Name
Example: "ERP"
No
idlongInvitation ID
Example: 1
No
inviteCodestringUnique Invitation Code
Example: "3609848a-394a-41c6-817f-c81e362881ed"
No
inviterEmailstringEmail of the inviter.
Example: "abc@gmail.com"
No
inviterNamestringName of the inviter
Example: "John"
No
orgInvitedTostringOrganisation Name
Example: "Deskera"
No
statusstringInvitation Status
Example: "SENT"
No

InviteUserRequest​

NameTypeDescriptionRequired
appNamestringDeskera Application Name
Example: "ORGANISATION"
Yes
contactstringContact No
Example: "+65 1245678"
Yes
firstNamestringuser first name
Example: "John"
Yes
lastNamestringUser last name
Example: "Doe"
Yes
roleGroupstringDeskera Roles
Example: "org_admin"
Yes
usernamestringUsername or Email or Contact Number of User
Example: "example@domain.com"
Yes

LandedCostCategory​

NameTypeDescriptionRequired
allocationTypestringEnum: "QUANTITY", "VALUE", "WEIGHT", "MANUAL", "CUSTOM_DUTY"No
namestringNo

LandedCostSettings​

NameTypeDescriptionRequired
categoryList[ LandedCostCategory ]No
landedCostbooleanNo

Limit​

NameTypeDescriptionRequired
fixedlongNo
monthlylongNo

MFADisableRequest​

NameTypeDescriptionRequired
userIds[ long ]List of users for whom to disable MFA
Example: [1,2,3]
Yes

Map«string,Limit»​

NameTypeDescriptionRequired
Map«string,Limit»object

Map«string,string»​

NameTypeDescriptionRequired
Map«string,string»object

MergeAccountDto​

NameTypeDescriptionRequired
currentUserIdlongIAM user id of current account
Example: 2
Yes
isMobilebooleanTrue if account being merged is mobile account.
Example: true
Yes
mergedUserIdlongIAM user id of account to be merged
Example: 1
Yes

MobileSignInRequest​

NameTypeDescriptionRequired
phoneNumberstringPhone Number
Example: "+65-1234-5678"
Yes

MobileSignupRequestWithOrg​

NameTypeDescriptionRequired
contactstringUser Contact Number
Example: 12345678
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
lastNamestringUser Last Name
Example: "Doe"
No
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No

MobileVerifySignInRequest​

NameTypeDescriptionRequired
phoneNumberstringPhone number
Example: "+65-1234-5678"
Yes
sessionstringCognito session received on signup
Example: "eyJjdHkiOiJKV1QiLCJlbmMiOiJ.."
Yes
verificationCodestringVerification code received on contact no
Example: 12345
Yes

ModuleDto​

NameTypeDescriptionRequired
accessLevelstringAccess Level
Example: "r"
No
activebooleanIs Module Active?
Example: true
No
appNamestringAPP Name
Example: "ERP"
No
codestringModule Code
Example: "m_erp_product"
No
descriptionstringModule Description
Example: "Invoice Read Permission"
No
groupNamestringModule Group Name
Example: "product"
No
isDefaultbooleanisDefault?
Example: false
No
namestringModule Name
Example: "Invoice"
No
sequencelongModule Group Sequence
Example: 0
No
uuidstringUUID
Example: "1xdz...."
No
visiblebooleancan display module in UI?
Example: false
No

ModuleResponse​

NameTypeDescriptionRequired
groupstringModule Group
Example: "erp_product"
No
modules[ ModuleDto ]Module associated with role groupNo
sequencelongModule Group Sequence
Example: 0
No

NewDeviceMetadataType​

NameTypeDescriptionRequired
deviceGroupKeystringNo
deviceKeystringNo

NewTokenRequest​

NameTypeDescriptionRequired
refreshTokenstringRefresh token
Example: "eyJjdHkiOiJKV1QiLCJlbmMiOiJ.."
Yes
userNamestringUsername
Example: "+65-1234-5678"
Yes

NonGuestUserResponseDto​

NameTypeDescriptionRequired
applications[ string ]Enum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
userCountlongNo
userIdlongNo

OAuthAccountVerifyRequest​

NameTypeDescriptionRequired
deskeraTokenstringDeskera Token
Example: "QWE11232s"
Yes
tenantIdlongTenant Id
Example: 1
Yes
userIdlongUser Id
Example: 101
Yes

OnBoardingSetting​

NameTypeDescriptionRequired
digitalProductsbooleanNo
inventorybooleanNo
servicesbooleanNo
showGettingStartedbooleanNo

OnboardingStatusInfo​

NameTypeDescriptionRequired
abortZeroStateDashboardbooleanAborting zero state dashboard
Example: true
No
accountingMethodstringAccounting method used by user.
Enum: "ACCRUAL", "CASH"
Example: "ACCRUAL"
No
addTaxCheckbooleantrue
Example: true
No
appInstallCheckedbooleantrue
Example: true
No
bankCheckedbooleantrue
Example: true
No
companyAddressCheckedbooleantrue
Example: true
No
contactCheckedbooleantrue
Example: true
No
customFieldsCheckedbooleanIs custom fields option checked.
Example: true
No
designTemplateCheckedbooleanWill user use design template feature
Example: true
No
isComplianceSavedbooleantrue
Example: true
No
multiCurrencyCheckedbooleanHas user enabled multi-currency
Example: true
No
openingBalanceCheckedbooleantrue
Example: true
No
organisationSettingsCheckedbooleanOrganisation settings option checked.
Example: true
No
paymentServiceCheckedbooleanPayment approved by user.
Example: true
No
productCheckedbooleantrue
Example: true
No
setupImportStatusstringOrganization import setup status
Enum: "SKIP", "DONE", "PENDING"
Example: "SKIP"
No
setupInvoiceStatusstringOrganization invoice setup status
Enum: "SKIP", "DONE", "PENDING"
Example: "DONE"
No
sgEInvoiceCheckedbooleanIs SG EInvoice Checked
Example: false
No
updateTaxComplianceCheckbooleantrue
Example: true
No

OrgSignUpRequest​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstNostringOrganization GST Reg No.
Example: "M91234567X"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
nexusstringList of nexus states
Example: "nexusStates"
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
uenNostringOrganization UEN No.
Example: "200312345A"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestAustralia​

NameTypeDescriptionRequired
australianBusinessNostringAustralian Business Number (ABN).
Example: 123456789098765
No
basReportingMethodstringBAS Reporting Method (SIMPLER / FULL)
Enum: "SIMPLER", "FULL"
Example: "SIMPLER"
No
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
taxFileNumberstringTax File Number
Example: 123456789098765
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestBelgium​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
enterpriseNumberBEstringEnterprise Number.
Example: 123456789098765
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatIdentificationNumberBEstringVAT Identification Number
Example: 123456789098765
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestCanada​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
canadianBusinessNostringCanadian Business Number (ABN).
Example: 123456789098765
No
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstNumberstringGST Number
Example: 123456789098765
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestGermany​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
companyRegistrationNumberDEstringCompany Registration Number
Example: 123456789
No
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstNoDEstringTax Number
Example: "NL123456789B01"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatIdentificationNumberDEstringVAT Identification Number
Example: "NL123456789B01"
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestIndia​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
compositionSchemeTypestringThe percent tax payable under the Composition Scheme. Applicable when gstRegistered=true
Enum: "ONE_PERCENT", "TWO_PERCENT", "FIVE_PERCENT", "SIX_PERCENT"
Example: "SIX_PERCENT"
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
enableReverseChargebooleanWhether the Tenant has enabled reverse charge in Sales Transaction. Applicable when gstRegistered=true
Example: true
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
gstRegistrationDatestringThe Date on Which GST was registered. Date Format is dd-mm-yyyy. Applicable when gstRegistered=true
Example: "01-01-2020"
No
gstinstringOrganization GST Reg No. for India
Example: "M91234567X"
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
registeredToCompositionSchemebooleanWhether the Tenant is registered to Composition Scheme. Applicable when gstRegistered=true
Example: true
No
sezOrImportExportbooleanWhether the Tenant is an SEZ or deals with Import/Export. Applicable when gstRegistered=true
Example: true
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
trackDigitalServicesbooleanWhether the Tenant has enables tracking of digital services to overseas customers. Applicable when gstRegistered=true
Example: true
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestIndonesia​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
exciseAccountstringAccount to set for Excise Payable
Example: "AC0001"
No
exciseApplicablebooleanTrue to allow excise flow
Example: true
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
npwpNostringIndonesia specific Organization NPWP No.
Example: "01.542.188.6-046.000"
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestIsrael​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
ilDeductionFileIdstringIsrael specific deduction file id
Example: "deduction file id"
No
ilEngagementTypestringIsrael specific engagement type
Example: "engagement type"
No
ilIncomeTaxNostringIsrael specific income tax no
Example: "income tax no"
No
ilLegalNamestringIsrael specific legal name
Example: "legal name"
No
ilNationalInsuranceNostringIsrael specific national insurance no
Example: "national insurance no"
No
ilParentSubsidiaryNamestringIsrael specific parent subsidiary name
Example: "parent subsidiary name"
No
ilReturnAddress[ Address ]Israel Specific Return AddressNo
ilReturnEmailstringIsrael specific return email
Example: "return email"
No
ilVatCodestringIsrael specific vat code
Example: "vat code"
No
ilVatRegistrationNostringIsrael specific vat registration no
Example: "vat registration no"
No
ilWithholdingTaxAccountstringIsrael specific withholding tax account
Example: "withholding tax account"
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestMalaysia​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
businessRegistrationNostringOrganization Business Reg No. for Malaysia
Example: "B91234567X"
No
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
exemptionbooleanWhether the Exemption is on or off.
Example: true
No
exemptionCerificatebooleanWhether the Exemption Cerificate is availble or not.
Example: true
No
exemptionCriteriastringOrganization Exemption criteria. for Malaysia
Example: "EX1234567X"
No
exemptionNostringOrganization Exemption No. for Malaysia
Example: "EX1234567X"
No
expiryDatestringDate Format code
Example: "01-06-2020"
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
salesTaxRegistrationNostringOrganization Sales Tax Reg No. for Malaysia
Example: "T91234567X"
No
serviceTaxRegistrationNostringOrganization Service Tax Reg No. for Malaysia
Example: "S91234567X"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestNL​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
companyRegistrationNumberNLstringCompany Registration Number
Example: "B91234567X"
No
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatIdentificationNumberNLstringVAT Identification Number
Example: "B91234567X"
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestNZ​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstNoNZstringGST Number
Example: "111-111-111"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
irdNostringIRD Number
Example: "111-111-111"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestPhilippines​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatNoPhilippinesstringOrganization VAT No. for Philippines
Example: "0123456789101"
No
vatPayableAccountPhilippinesstringOrganization VAT Payable account for Philippines
Example: 11212
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestSA​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
exciseAccountSAstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicableSAbooleanTrue to allow excise flow for UAE country
Example: true
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isDesignatedZoneSAbooleanIs your business located in a Designated Zone?
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
outsideContactSAbooleanTrue to allow RCM flow for UAE country
Example: true
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
rcmAccountSAstringAccount to set for RCM
Example: "AC400010"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
registeredForVatSAbooleanRegistered for vat flag
Example: false
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantInfoInSATenantInfoSASaudiLanguageArabic Details
Example: true
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatAccountNumberSAstringVat Account Number
Example: "NL123456789B01"
No
vatReturnFrequencySAstringVAT Return Frequency
Example: "Monthly"
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestUAE​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
exciseAccountstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicablebooleanTrue to allow excise flow for UAE country
Example: true
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isDesignatedZonebooleanIs your business located in a Designated Zone?
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
outsideContactbooleanTrue to allow RCM flow for UAE country
Example: true
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
rcmAccountstringAccount to set for RCM
Example: "AC400010"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatNoUAEstringUAE specific Organization VAT No.
Example: "012-345-678-910"
No
vendorIdstringvendorId
Example: 12345
No

OrgSignUpRequestUK​

NameTypeDescriptionRequired
billingAddressAddressBilling AddressNo
bookBeginningStartDatestringBook Beginning Start Date
Example: "01-04-2019"
Yes
businessRegistrationNoUKstringOrganization Business Reg No. for UK
Example: "B91234567X"
No
completeOrgSetupbooleanWhether to setup complete org or not?
Example: true
No
countryLookupCodestringCountry code
Example: "SG"
Yes
currencyLookUpCodestringBase Currency code
Example: "SGD"
Yes
dateFormatLookUpCodestringDate Format code
Example: "dd-mm-yyyy"
Yes
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
financialStartDatestringFinancial Year Start Date
Example: "01-01-2019"
Yes
flatRatePercentageListUK[ FlatRatePercentageListUK ]Whether the Marketing Tax Digital is on or off.
Example: true
No
fyClosingPeriodEndDatestringClosing Period End date
Example: "01-04-2019"
No
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
industrystringOrg Industry
Example: "Shipping"
No
isBookkeeperbooleanFlag to indicate if organization is book keeper organization
Example: true
No
isPartnerbooleanFlag to indicate if organization is partner book keeper organization
Example: true
No
isShopbooleanFlag to indicate if tenant is linked to a shop
Example: true
No
logoUrlstringCompany Logo URLNo
marketingTaxDigitalUKbooleanWhether the Marketing Tax Digital is on or off.
Example: true
No
multicurrencybooleanFlag to enable multicurrency
Example: true
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
peppolIdstringPeppolId
Example: "0195:SGUEN123456"
No
peppolOptInstringPeppol opt-in flag
Example: false
No
purposestringOrg Main Task
Example: "Accounting"
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
shippingAddressAddressShipping AddressNo
sizestringOrg Size
Example: "10-15"
No
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes
timezoneLookUpCodestringTimezone code
Example: "TZ001"
No
userIdlongUser Id
Example: 1
Yes
vatIdentificationNumberUKstringVAT Number
Example: 123456789098765
No
vatSchemeUKstringVAT Scheme
Example: "Standard scheme"
No
vendorIdstringvendorId
Example: 12345
No

OrganizationSettings​

NameTypeDescriptionRequired
decimalScaleintegerNo
tenantIdlongNo

OrganizationSetupStatusResponse​

NameTypeDescriptionRequired
idlongOrganization ID
Example: 123
No
onboardingStatusInfoOnboardingStatusInfoOnboarding statusNo
orgSetupCompletedbooleanOrganization setup status
Example: true
No
tenantIdlongTenant ID
Example: 123
No

OwnerInfoDto​

NameTypeDescriptionRequired
ownerIamUserIdlongNo
ownerTenantUserIdlongNo

Pageable​

NameTypeDescriptionRequired
offsetlongNo
pageNumberintegerNo
pageSizeintegerNo
pagedbooleanNo
sortSortNo
unpagedbooleanNo

Page«AppUserResponseInfo»​

NameTypeDescriptionRequired
content[ AppUserResponseInfo ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

Page«BookkeeperTeamInfo»​

NameTypeDescriptionRequired
content[ BookkeeperTeamInfo ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

Page«RoleGroupDto»​

NameTypeDescriptionRequired
content[ RoleGroupDto ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

Page«TenantInformation»​

NameTypeDescriptionRequired
content[ TenantInformation ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

Page«UserShortInfo»​

NameTypeDescriptionRequired
content[ UserShortInfo ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

Page«UserShortRoleInfo»​

NameTypeDescriptionRequired
content[ UserShortRoleInfo ]No
emptybooleanNo
firstbooleanNo
lastbooleanNo
numberintegerNo
numberOfElementsintegerNo
pageablePageableNo
sizeintegerNo
sortSortNo
totalElementslongNo
totalPagesintegerNo

PasswordPolicyDto​

NameTypeDescriptionRequired
enabledbooleanNo
expireExistingUsersPasswordbooleanNo
expirePasswordAfterDaysintegerNo
maxLengthintegerNo
minLengthintegerNo
mustIncludeNumbersbooleanNo
mustIncludeSpecialCharsbooleanNo
mustIncludeUpperCaseLettersbooleanNo
restrictLastPasswordsCountintegerNo

PermissionInfoResponse​

NameTypeDescriptionRequired
appNamestringAPPLICATION Name
Example: "ERP"
No
roleGroupDto[ RoleGroupDto ]Roles GroupsNo

PlanInfo​

NameTypeDescriptionRequired
AmountnumberNo
CurrencystringNo
InTrialbooleanNo
IntervalstringNo
NamestringNo
PlanIDstringNo
TrialDaysintegerNo
TrialOverbooleanNo
UpdatedOndateTimeNo

PrefillDocumentData​

NameTypeDescriptionRequired
autoPopulateDatabooleanNo
firstTimePopupbooleanNo

ProductLimit​

NameTypeDescriptionRequired
AddonChargeintegerNo
CodestringNo
ContactCountintegerNo
EmailSendCountintegerNo
EmployeeCountintegerNo
FreeUserCountintegerNo
GuestUserCountintegerNo

PromoCode​

NameTypeDescriptionRequired
codestringNo
expiryDatedateTimeNo
idlongNo
multipleUseAllowedbooleanNo
usedbooleanNo

RefreshRolesModulesByAppNameRequest​

NameTypeDescriptionRequired
allTenantsbooleanTo update for all tenants
Example: true
No
appNames[ string ]App name
Enum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"
Example: "ERP"
Yes
batchSizeintegerBatch size
Example: 10
No
moduleCodes[ string ]Modules to migrate
Example: ["m_erp_quote_view","m_erp_quote_edit"]
No
roleCodes[ string ]Roles to migrate
Example: ["erp_quote_view","erp_quote_edit"]
No
roleGroupIds[ long ]Role group ids to migrate
Example: [2,3,4]
No
startPageintegerStart batch number
Example: 10
No
tenantIds[ long ]List of tenants for which to update
Example: [1,2,4]
No

RefreshRolesModulesRequest​

NameTypeDescriptionRequired
allTenantsbooleanTo update for all tenants
Example: true
No
batchSizeintegerBatch size
Example: 10
No
startPageintegerStart batch number
Example: 10
No
tenantIds[ long ]List of tenants for which to update
Example: [1,2,4]
No

RefreshRolesModulesResponse​

NameTypeDescriptionRequired
foundTenantIds[ long ]List of tenantIds found
Example: [1,2,3]
No
sucessfulTenantIds[ long ]List of successfully refreshed tenants
Example: [1,2,3]
No

RefreshTokenRequest​

NameTypeDescriptionRequired
refreshTokenstringRefresh token
Example: "eyJjdHkiOiJKV1QiLCJlbmMiOiJ.."
Yes
tenantIdlongTenant Id
Example: 123456
Yes
userNamestringUsername
Example: "+65-1234-5678"
Yes

RegisteredUserIdRequest​

NameTypeDescriptionRequired
emailstringEmail Address
Example: "sample@demo.com"
No
phonestringPhone Number
Example: "+6504372324"
No

RegisteredUserRequest​

NameTypeDescriptionRequired
emails[ string ]List of user's contacts emails
Example: ["sample@xyz.abc","demo@abc.xyz"]
Yes
phones[ string ]List of user's contacts phone numbers
Example: ["+6504372324"]
Yes

RemovePermissionRequest​

NameTypeDescriptionRequired
apps[ string ]No
tenantIdlongNo
userIdlongNo

ResetPasswordRequest​

NameTypeDescriptionRequired
userNamestringUsername
Example: "+65-1234-5678"
Yes

ResponseEntity​

NameTypeDescriptionRequired
bodyobjectNo
statusCodestringEnum: "100 CONTINUE", "101 SWITCHING_PROTOCOLS", "102 PROCESSING", "103 CHECKPOINT", "200 OK", "201 CREATED", "202 ACCEPTED", "203 NON_AUTHORITATIVE_INFORMATION", "204 NO_CONTENT", "205 RESET_CONTENT", "206 PARTIAL_CONTENT", "207 MULTI_STATUS", "208 ALREADY_REPORTED", "226 IM_USED", "300 MULTIPLE_CHOICES", "301 MOVED_PERMANENTLY", "302 FOUND", "302 MOVED_TEMPORARILY", "303 SEE_OTHER", "304 NOT_MODIFIED", "305 USE_PROXY", "307 TEMPORARY_REDIRECT", "308 PERMANENT_REDIRECT", "400 BAD_REQUEST", "401 UNAUTHORIZED", "402 PAYMENT_REQUIRED", "403 FORBIDDEN", "404 NOT_FOUND", "405 METHOD_NOT_ALLOWED", "406 NOT_ACCEPTABLE", "407 PROXY_AUTHENTICATION_REQUIRED", "408 REQUEST_TIMEOUT", "409 CONFLICT", "410 GONE", "411 LENGTH_REQUIRED", "412 PRECONDITION_FAILED", "413 PAYLOAD_TOO_LARGE", "413 REQUEST_ENTITY_TOO_LARGE", "414 URI_TOO_LONG", "414 REQUEST_URI_TOO_LONG", "415 UNSUPPORTED_MEDIA_TYPE", "416 REQUESTED_RANGE_NOT_SATISFIABLE", "417 EXPECTATION_FAILED", "418 I_AM_A_TEAPOT", "419 INSUFFICIENT_SPACE_ON_RESOURCE", "420 METHOD_FAILURE", "421 DESTINATION_LOCKED", "422 UNPROCESSABLE_ENTITY", "423 LOCKED", "424 FAILED_DEPENDENCY", "426 UPGRADE_REQUIRED", "428 PRECONDITION_REQUIRED", "429 TOO_MANY_REQUESTS", "431 REQUEST_HEADER_FIELDS_TOO_LARGE", "451 UNAVAILABLE_FOR_LEGAL_REASONS", "500 INTERNAL_SERVER_ERROR", "501 NOT_IMPLEMENTED", "502 BAD_GATEWAY", "503 SERVICE_UNAVAILABLE", "504 GATEWAY_TIMEOUT", "505 HTTP_VERSION_NOT_SUPPORTED", "506 VARIANT_ALSO_NEGOTIATES", "507 INSUFFICIENT_STORAGE", "508 LOOP_DETECTED", "509 BANDWIDTH_LIMIT_EXCEEDED", "510 NOT_EXTENDED", "511 NETWORK_AUTHENTICATION_REQUIRED"No
statusCodeValueintegerNo

Role​

NameTypeDescriptionRequired
appNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
descriptionstringNo
idlongNo
permissionsRolePermissionInfoNo
shortCodestringNo

RoleGroup​

NameTypeDescriptionRequired
activeFlagbooleanNo
adminbooleanNo
appNamestringEnum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"No
guestbooleanNo
idlongNo
namestringNo
shortCodestringNo
systemDefinedbooleanNo
tenantIdlongNo

RoleGroupCreateRequestDto​

NameTypeDescriptionRequired
appNamestringAPP Name
Example: "ERP"
No
isAdminbooleanis admin
Example: false
No
isGuestbooleanis guest
Example: false
No
moduleUuids[ string ]List of module UUIDNo
roleCodestringRole code
Example: "superman"
No
roleNamestringRole Name
Example: "superman"
No

RoleGroupDeleteRequestDto​

NameTypeDescriptionRequired
appNamestringAPP Name
Example: "ERP"
No
roleCodestringRole code
Example: "superman"
No

RoleGroupDto​

NameTypeDescriptionRequired
activeFlagbooleanActive status
Example: true
No
appNamestringAPPLICATION Name
Example: "ERP"
No
guestbooleanIs Guest
Example: true
No
idlongRole group id
Example: 1
No
modules[ ModuleResponse ]Module associated with role groupNo
namestringDescription
Example: "Organization Administrator"
No
rolePermissions[ RoleGroupRoleXref ]Roles PermissionsNo
shortCodestringShort code for role group
Example: "admin"
No
systemDefinedstringSystem defined role group
Example: true
No

RoleGroupRoleXref​

NameTypeDescriptionRequired
idlongNo
optionalbooleanNo
roleRoleNo
roleGroupIdlongNo

RolePermissionInfo​

NameTypeDescriptionRequired
can_deletebooleanCan Delete Access
Example: false
No
can_readbooleanCan Read Access
Example: false
No
can_writebooleanCan Write Access
Example: false
No

RoleShortInfo​

NameTypeDescriptionRequired
appNamestringApplication Name
Enum: "CONSOLE", "ERP", "ORGANISATION", "ATTENDANCE", "EXPENSE", "CRM", "PEOPLE", "CHAT", "ALL", "REPORT_BUILDER", "SHOP", "WORKFLOW_ENGINE", "CRM_PLUS", "MRP"
Example: "ERP"
No
guestbooleanIs Guest
Example: true
No
roleGroupNamestringRole Group
Example: "Auditor"
No
shortCodestringRole Group
Example: "admin"
No

SalesPersonSettingInfo​

NameTypeDescriptionRequired
hasAccessToAllContactsbooleanNo
isOwnerUserbooleanNo

SetContactEmailDto​

NameTypeDescriptionRequired
contactstringcontact to be set
Example: "New contact"
No
emailstringEmail to be set
Example: "new email"
No
isEmailChangeContactbooleanemail or contact to be set
Example: false
No

SetupCompletion​

NameTypeDescriptionRequired
chartOfAccountsbooleanNo
contactsbooleanNo
openingBalancesbooleanNo
productAndServicesbooleanNo

SignUpResponse​

NameTypeDescriptionRequired
authenticationResultTypeAuthenticationResultTypeNo
tenantIdlongTenant ID
Example: 123
No
tenantNamestringTenant name
Example: "Deskera"
No
userIdlongUser Id
Example: "1L"
No

Sort​

NameTypeDescriptionRequired
emptybooleanNo
sortedbooleanNo
unsortedbooleanNo

SsoVerifyRequest​

NameTypeDescriptionRequired
apisidstringAPISID
Example: "eyJjdHkiOiJKV1QiLCJlbmMiOiJ.."
Yes

SwitchTenantRequest​

NameTypeDescriptionRequired
refreshTokenstringRefresh token
Example: "eyJjdHkiOiJKV1QiLCJlbmMiOiJ.."
Yes
skipTenantCallbooleanSkip tenant service switch tenant call.
Example: true
No
tenantIdlongTenant ID
Example: 1
Yes
userNamestringUsername
Example: "+65-1234-5678"
Yes

TCSCollectionNatureRequest​

NameTypeDescriptionRequired
idlongID
Example: 10
No
namestringTax Name
Example: "206C(1H) Sales of Goods"
No

TCSCollectionNatureResponse​

NameTypeDescriptionRequired
idlongID
Example: 10
No
namestringTax Name
Example: "206C(1H) Sales of Goods"
No

TCSSettingsRequest​

NameTypeDescriptionRequired
accountPayablestringAccount Payable
Example: "AC-0001"
No
accountReceivablestringAccount Receivable
Example: "AC-0002"
No
activebooleanActive
Example: true
No
idlongID
Example: 10
No
ratePercentagefloatRate Percentage
Example: 5.3
No
taxNamestringTax Name
Example: "tax-01"
No
tcsCollectionNatureIdlongTCS Nature ID.
Example: 1
No

TCSSettingsResponse​

NameTypeDescriptionRequired
accountPayablestringAccount Payable
Example: "AC-0001"
No
accountReceivablestringAccount Receivable
Example: "AC-0002"
No
activebooleanActive
Example: true
No
idlongID
Example: 10
No
ratePercentagefloatRate Percentage
Example: 5.3
No
taxNamestringTax Name
Example: "tax-01"
No
tcsCollectionNatureIdlongTCS Nature ID.
Example: 1
No

Tenant​

NameTypeDescriptionRequired
activebooleanNo
address1stringNo
address2stringNo
citystringNo
contactsTenantContactNo
countryLookUpCodestringEnum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "UM", "VG", "VI", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "CI", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "XK", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UK", "US", "US1", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"No
createdAtdateTimeNo
createdBylongNo
currencyLookUpCodestringNo
dateFormatLookUpCodestringNo
defaultPaymentTermlongNo
deletedbooleanNo
demoOrgbooleanNo
idlongNo
isBookkeeperbooleanNo
isPartnerbooleanNo
isShopbooleanNo
logoUrlstringNo
namestringNo
orgSetupCompletedbooleanNo
postalCodestringNo
promoCodePromoCodeNo
sourcestringEnum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"No
statestringNo
tenantMetaTenantMetaNo
timezoneLookUpCodestringNo
tokenstringNo
updatedAtdateTimeNo
updatedBylongNo
verifiedbooleanNo

TenantActiveDetails​

NameTypeDescriptionRequired
countryLookUpCodestringNo
deletedbooleanNo
emailstringNo
idlongNo
isBookkeeperbooleanNo
isDemoOrgbooleanNo
namestringNo
ownerUserIdlongNo

TenantAttributeRequest​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
australianBusinessNostringAustralian Business Number (ABN).
Example: 123456789098765
No
basReportingMethodstringBAS Reporting Method (SIMPLER / FULL)
Enum: "SIMPLER", "FULL"
Example: "SIMPLER"
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatedateTimeBook beginning date
Example: "01-01-2020"
No
businessRegistrationNostringbusinessRegistrationNo
Example: "22AAAAAA00"
No
businessRegistrationNoUKstringOrganization Business Reg No. for UK
Example: "B91234567X"
No
canadianBusinessNostringCanadian Business Number (ABN).
Example: 123456789098765
No
cinIndiastringCompany CIN Number
Example: "U12345AA1234AAA123456"
No
companyRegistrationNumberDEstringCompany Registration Number
Example: 123456789
No
companyRegistrationNumberNLstringCompany Registration Number
Example: "B91234567X"
No
complianceEnabledbooleanEnable Compliance
Example: false
No
compositionSchemeTypestringThe percent tax payable under the Composition Scheme. Applicable when gstRegistered=true
Enum: "ONE_PERCENT", "TWO_PERCENT", "FIVE_PERCENT", "SIX_PERCENT"
Example: "SIX_PERCENT"
No
countryLookUpCodestringCountry lookup code for the Company.
Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "UM", "VG", "VI", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "CI", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "XK", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UK", "US", "US1", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
currencyCodesToActivate[ string ]Currency codes to activateNo
currencyLookUpCodestringCurrency lookup code for the Company.
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal scale for amounts for Org
Example: 3
No
defaultPaymentTermlongPayment Term Id
Example: 1
No
enableReverseChargebooleanWhether the Tenant has enabled reverse charge in Sales Transaction. Applicable when gstRegistered=true
Example: true
No
enterpriseNumberBEstringEnterprise Number.
Example: 123456789098765
No
exciseAccountstringAccount to set for Excise Payable
Example: "AC0001"
No
exciseAccountSAstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicablebooleanTrue to allow excise flow
Example: true
No
exciseApplicableSAbooleanTrue to allow excise flow for UAE country
Example: true
No
exemptionbooleanexemption
Example: true
No
exemptionCerificatebooleanWhether the Exemption Cerificate is availble or not.
Example: true
No
exemptionCriteriastringOrganization Exemption criteria. for Malaysia
Example: "EX1234567X"
No
exemptionNostringexemptionNo
Example: "22AAAAAA0"
No
expiryDatedateTimeThe Date on Which SST was registered. Date Format is dd-mm-yyyy. Applicable when sstRegistered=true
Example: "01-01-2020"
No
financialStartDatedateTimeFinancial start date
Example: "01-01-2020"
No
flatRatePercentageListUK[ FlatRatePercentageListUK ]Whether the Marketing Tax Digital is on or off.
Example: true
No
fyClosingPeriodEndDatedateTimeClosing End date
Example: "01-01-2020"
No
gstNostringOrganization GST Reg No.
Example: "GST-00001"
No
gstNoDEstringTax Number
Example: "NL123456789B01"
No
gstNoNZstringGST Number
Example: "111-111-111"
No
gstNumberstringCanada gst number
Example: 123456789098765
No
gstRegisteredbooleanGst is registered
Example: false
No
gstRegistrationDatedateTimeThe Date on Which GST was registered. Date Format is dd-mm-yyyy. Applicable when gstRegistered=true
Example: "01-01-2020"
No
gstinstringOrganization GSTIN No.
Example: "22AAAAAA00000AA21"
No
ilDeductionFileIdstringIsrael specific deduction file id
Example: "deduction file id"
No
ilEngagementTypestringIsrael specific engagement type
Example: "engagement type"
No
ilIncomeTaxNostringIsrael specific income tax no
Example: "income tax no"
No
ilLegalNamestringIsrael specific legal name
Example: "legal name"
No
ilNationalInsuranceNostringIsrael specific national insurance no
Example: "national insurance no"
No
ilParentSubsidiaryNamestringIsrael specific parent subsidiary name
Example: "parent subsidiary name"
No
ilReturnAddress[ Address ]Israel Specific Billing AddressNo
ilReturnEmailstringIsrael specific return email
Example: "return email"
No
ilVatCodestringIsrael specific vat code
Example: "vat code"
No
ilVatRegistrationNostringIsrael specific vat registration no
Example: "vat registration no"
No
ilWithholdingTaxAccountstringIsrael specific withholding tax account
Example: "withholding tax account"
No
implementFIFOForAdvTrackingbooleanNo
indiaEinvoicebooleanNo
indiaGstrbooleanNo
indiaGstrUsernamestringNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
irdNostringIRD Number
Example: "111-111-111"
No
isDesignatedZonebooleanIs your business located in a Designated Zone?
Example: true
No
isDesignatedZoneSAbooleanIs your business located in a Designated Zone?
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: true
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: true
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: true
No
landedCostSettingsLandedCostSettingsLanded Cost Category settingsNo
logoUrlstringCompany Logo URLNo
marketingTaxDigitalUKbooleanWhether the Marketing Tax Digital is on or off.
Example: true
No
multicurrencybooleanEnable multi-currency
Example: true
No
namestringName of the Company.
Example: "Deskera"
No
nexusStatesstringList of nexus states
Example: "AL,TX,CA,FL,MA,NY,AS"
No
npwpNostring15 digit indentification no. for VAT bussiness
Example: 123456789098765
No
numberFormatstringNumber format for amounts for Org
Enum: "us", "in", "fr", "es"
Example: "us"
No
outsideContactbooleanTrue to allow RCM flow for UAE country
Example: true
No
outsideContactSAbooleanTrue to allow RCM flow for UAE country
Example: true
No
panIndiastringCompany PAN Number
Example: "AAAAA1111A"
No
peppolIdstringPeppol Id
Example: "U000:9990::0001"
No
peppolOptInbooleanpeppol Opt In flag
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
rcmAccountstringAccount to set for RCM
Example: "AC400010"
No
rcmAccountSAstringAccount to set for RCM
Example: "AC400010"
No
registeredForVatSAbooleanRegistered for vat flag
Example: false
No
registeredToCompositionSchemebooleanWhether the Tenant is registered to Composition Scheme. Applicable when gstRegistered=true
Example: true
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesTaxRegistrationNostringsalesTaxRegistrationNo
Example: "22AAAAAA"
No
serviceTaxRegistrationNostringserviceTaxRegistrationNo
Example: "22AAAAAA0"
No
sezOrImportExportbooleanEnable Sez for company
Example: true
No
shippingAddresses[ Address ]Shipping addressesNo
tanNumberIndiastringCompany TAN Number
Example: "GSFD2376S"
No
taxFileNumberstringTax File Number
Example: 123456789098765
No
taxNostringOrganization Tax No.
Example: "TAX-00001"
No
tcsEnabledbooleanwhether TCS is enabled or not
Example: false
No
tdsPaymentInterestRateIndianumberTDS Payment Interest Rate for India
Example: "1%"
No
tenantInfoInSATenantInfoSASaudiLanguageArabic Details
Example: true
No
tenantMetaTenantMetaTenant Meta info such as no of Employees, IndustryNo
timezonestringTimezone
Example: "TZ001"
No
trackDigitalServicesbooleanWhether the Tenant has enables tracking of digital services to overseas customers. Applicable when gstRegistered=true
Example: true
No
uenNostringOrganization UEN No.
Example: "UEN-00001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatAccountNumberSAstringVat Account Number
Example: "NL123456789B01"
No
vatIdentificationNumberBEstringVAT Identification Number.
Example: 123456789098765
No
vatIdentificationNumberDEstringVAT Identification Number
Example: "NL123456789B01"
No
vatIdentificationNumberNLstringVAT Identification Number
Example: "B91234567X"
No
vatIdentificationNumberUKstringVAT Number
Example: 123456789098765
No
vatNoPhilippinesstringPhilippines specific Contact VAT No.
Example: "012-345-678-910"
No
vatNoUAEstringUAE specific Organization VAT No.
Example: "012-345-678-910"
No
vatReturnFrequencySAstringVAT Return Frequency
Example: "Monthly"
No
vatSchemeUKstringVAT Scheme
Example: "Standard scheme"
No
vatStatusPhilippinesstringPhilippines specific Contact VAT Status
Example: "Input VAT"
No
vendorIdstringvendorId
Example: 12345
No

TenantBarcodeSettingDetails​

NameTypeDescriptionRequired
activateGeneralBarcodebooleanActivate General Barcode Functionality
Example: true
No
activateGeneralBarcodeSODObooleanActivate General Barcode Functionality for SO/DO
Example: true
No
barcodeLabelHeightlongBarcode Label Height in mm
Example: 12
No
barcodeLeftMarginlongBarcode Left Margin in mm
Example: 10
No
barcodeTopMarginlongBarcode Top Margin in mm
Example: 10
No
barcodeTypestringBarcode Type
Enum: "CODE_128", "CODE_39", "EAN_8", "EAN_13", "UPC_A", "DATAMATRIX"
Example: "CODE_128"
No
batchExpiryDateFontSizelongBatch Expiry Date Font Size
Example: -10
No
batchExpiryDatePrefixstringBatch Expiry Date Prefix
Example: "Saint"
No
batchExpiryDateTranslateXlongBatch Expiry Date Translate X
Example: -40
No
batchExpiryDateTranslateYlongBatch Expiry Date Translate Y
Example: -40
No
batchManufactureDateFontSizelongBatch Manufacture Date Font Size
Example: -10
No
batchManufactureDatePrefixstringBatch Manufacture Date Prefix
Example: "Saint"
No
batchManufactureDateTranslateXlongBatch Manufacture Date Translate X
Example: -40
No
batchManufactureDateTranslateYlongBatch Manufacture Date Translate Y
Example: -40
No
companyNameFontSizelongCompany Name Font Size
Example: -10
No
companyNamePrefixstringCompany Name Prefix
Example: "Saint"
No
companyNameTranslateXlongCompany Name Translate X
Example: -40
No
companyNameTranslateYlongCompany Name Translate Y
Example: -40
No
dpilongDPI in mm
Example: 99
No
generateBarcodeForWorkOrderSettingsbooleanGenerate Barcode for work order
Example: true
No
generateBarcodeWithBatchExpiryDatebooleanGenerate Barcode With Batch Expiry Date
Example: true
No
generateBarcodeWithBatchManufactureDatebooleanGenerate Barcode With Batch Manufacture Date
Example: true
No
generateBarcodeWithPriceTagbooleanGenerate Barcode With Price tag
Example: true
No
generateBarcodeWithProductbooleanGenerate Barcode With Product
Example: true
No
generateBarcodeWithProductCodebooleanGenerate Barcode With Product
Example: true
No
generateBarcodeWithRetailPricebooleanGenerate Barcode With Retail Price
Example: true
No
generateBarcodeWithTenantNamebooleanGenerate Barcode With TenantName
Example: true
No
generateBarcodeforJobcardbooleanGenerate Barcode for Job card
Example: true
No
generateBarcodeforJobcardAlongWithOperatorbooleanGenerate Barcode for Job card along with operator
Example: true
No
heightlongHeight in mm
Example: 12
No
maxRetailPriceFontSizelongMax Retail Price Font Size
Example: -10
No
maxRetailPricePrefixstringMax Retail Price Prefix
Example: "Saint"
No
maxRetailPriceTranslateXlongMax Retail Price Translate X
Example: -40
No
maxRetailPriceTranslateYlongMax Retail Price Translate Y
Example: -40
No
priceFontSizelongPrice Font Size
Example: -10
No
pricePrefixstringPrice Prefix
Example: "Saint"
No
priceTranslateXlongPrice Translate X
Example: -40
No
priceTranslateYlongPrice Translate Y
Example: -40
No
printBatchExpiryDateDirectionstringPrint Batch Expiry Date Direction
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printBatchManufactureDateDirectionstringPrint Batch Manufacture Date Direction
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printCompanyNameTypestringPrint Company Name Type
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printPriceTypestringPrint Price Type
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printProductCodeDirectionstringPrint Product Code Direction
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printProductNameDirectionstringPrint Product Name Direction
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
printRetailPriceDirectionstringPrint Retail Price Direction
Enum: "RIGHT", "LEFT", "TOP", "BOTTOM"
Example: "RIGHT"
No
productCodeFontSizelongProduct Code Font Size
Example: -10
No
productCodePrefixstringProduct Code Prefix
Example: "Saint"
No
productCodeTranslateXlongProduct Code Translate X
Example: -40
No
productCodeTranslateYlongProduct Code Translate Y
Example: -40
No
productNameFontSizelongProduct Name Font Size
Example: -10
No
productNamePrefixstringProduct Name Prefix
Example: "Saint"
No
productNameTranslateXlongProduct Name Translate X
Example: -40
No
productNameTranslateYlongProduct Name Translate Y
Example: -40
No
skuEnablebooleanEKU enable/disable
Example: true
No
skuRenamestringrename SKU field as
Example: "SKU001"
No

TenantBooksSubscriptionDetails​

NameTypeDescriptionRequired
inTrialbooleanIs in trial
Example: true
No
planIdstringPlan Id
Example: "plan_L1Ko5kjP"
No
planNamestringPlan Name
Example: "Essential"
No
statusstringSubscription Status
Example: "active"
No
trialDaysintegerTrial Days
Example: 30
No
trialOverbooleanIs trial over
Example: false
No
updatedOndateTimeUpdatedOn
Example: "2020-07-09T02:13:27.404Z"
No

TenantContact​

NameTypeDescriptionRequired
emailstringEmail
Example: "contact@deskera.com"
No
faxstringFax number
Example: 123454234
No
phonestringPhone number
Example: 12345433
No
websitestringWebsite
Example: "www.deskera.com"
No

TenantControlAccountsDetails​

NameTypeDescriptionRequired
gainLossonForeignExchangeAccountCodestringGain/Loss on Foreign Exchange
Example: "A002"
No
itcReversalAccountCodestringITC reversal
Example: "AC-0000020"
No
roundOffAccountCodestringRound Off (Default) Code
Example: "A002"
No
roundingDifferenceAccountCodestringRounding Difference Code
Example: "A001"
No
salesTaxAccountCodestringSales Tax
Example: "AC-0000020"
No

TenantCountryDto​

NameTypeDescriptionRequired
countryLookUpCodestringCountry code
Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "UM", "VG", "VI", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "CI", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "XK", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UK", "US", "US1", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"
Example: "SG"
Yes
currencyLookUpCodestringCountry currency
Example: "SGD"
Yes

TenantDetails​

NameTypeDescriptionRequired
barcodeSettingsTenantSettingsBarcode SettingsNo
baseCurrencystringBase Currency
Example: "C001"
No
billingAddresses[ Address ]Billing AddressesNo
controlAccountSettingsTenantSettingsControl Account SettingsNo
financeSettingsTenantSettingsFinance SettingsNo
inventorySettingsTenantSettingsInventory SettingsNo
logoUrlstringLogo Url
Example: "http://sjhfksdf.com/logo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringCompany name
Example: "Deskera"
No
setupCompletionSetupCompletionSetup completionNo
shippingAddresses[ Address ]Shipping AddressesNo
timezonestringTimezone
Example: "TZ001"
No

TenantEInvoiceResponse​

NameTypeDescriptionRequired
peppolIdstringPeppolId Of Tenant
Example: "0195:sguen12345"
No
tenantIdlongTenantId Of Tenant
Example: 1
No
userIdlonguserId Of Tenant
Example: 1
No

TenantFinanceDetails​

NameTypeDescriptionRequired
currentYearEarningAccountCodestringcurrent Year Earning Account Code
Example: "A002"
No
financeEndstringFinance End
Example: "12/22"
No
financeStartstringFinance Start
Example: "1/23"
No
payableAccountCodestringPayable Account Code
Example: "A001"
No
receivableAccountCodestringReceivable Account Code
Example: "A002"
No
taxAccountSequenceCodestringTax Account Sequence Code
Example: "AC-0000020"
No

TenantInfo​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
australianBusinessNostringAustralian Business Number (ABN).
Example: 123456789098765
No
avalaraCodestringAvalara Company CodeNo
avalaraIdintegerAvalara Company IDNo
basReportingMethodstringBAS Reporting Method (SIMPLER / FULL)
Enum: "SIMPLER", "FULL"
Example: "SIMPLER"
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
cinIndiastringCompany CIN Number
Example: "U12345AA1234AAA123456"
No
complianceEnabledbooleanWhether the business collects tax or not.No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
gstNostringOrganization GST Reg No.
Example: "GST-00001"
No
gstinstringINDIA GST Reg num
Example: "27XXBCT3518Q1ZW"
No
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
isShopbooleanFlag to indicate if tenant is linked to a shopNo
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
nexusStatesstringAvalara nexus statesNo
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
oldFlowbooleanFlag to indicate if tenant has old flow for IN countriesNo
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
panIndiastringCompany PAN Number
Example: "AAAAA1111A"
No
peppolIdstringPeppol ID for SGNo
peppolOptInbooleanIS Peppol Opt InNo
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tanNumberIndiastringCompany TAN Number
Example: "GSFD2376S"
No
taxFileNumberstringTax File Number
Example: 123456789098765
No
taxNostringOrganization Tax No.
Example: "TAX-00001"
No
tenantCreatedDatestringTenant Created DateNo
tenantInfoInSATenantInfoSASaudiLanguageArabic Details
Example: true
No
timezonestringTimezone
Example: "TZ001"
No
uenNostringOrganization UEN No.
Example: "UEN-00001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
userIdlongUser idNo
vendorIdstringVendor ID for SGNo

TenantInfoAustralia​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
australianBusinessNostringAustralian Business Number (ABN).
Example: 123456789098765
No
basReportingMethodstringBAS Reporting Method (SIMPLER / FULL)
Enum: "SIMPLER", "FULL"
Example: "SIMPLER"
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
taxFileNumberstringTax File Number
Example: 123456789098765
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoBelgium​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
enterpriseNumberBEstringEnterprise Number.
Example: 123456789098765
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatIdentificationNumberBEstringVAT Identification Number
Example: 123456789098765
No

TenantInfoCanada​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
canadianBusinessNostringCanadian Business Number (CBN).
Example: 123456789098765
No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
gstNumberstringGST Number
Example: 123456789098765
No
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoGermany​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
companyRegistrationNumberDEstringCompany Registration Number
Example: 123456789
No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
gstNoDEstringTax Number
Example: "NL123456789B01"
No
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatIdentificationNumberDEstringVAT Identification Number
Example: "NL123456789B01"
No

TenantInfoIndia​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
cinIndiastringCompany CIN Number
Example: "U12345AA1234AAA123456"
No
compositionSchemeTypestringThe percent tax payable under the Composition Scheme. Applicable when gstRegistered=true
Enum: "ONE_PERCENT", "TWO_PERCENT", "FIVE_PERCENT", "SIX_PERCENT"
Example: "SIX_PERCENT"
No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
enableReverseChargebooleanWhether the Tenant has enabled reverse charge in Sales Transaction. Applicable when gstRegistered=true
Example: true
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
gstRegisteredbooleanWhether the business is registered to GST or not.
Example: true
No
gstRegistrationDatedateTimeThe Date on Which GST was registered. Date Format is dd-mm-yyyy. Applicable when gstRegistered=true
Example: "01-01-2020"
No
gstinstringIndia specific Organization GST Reg No.
Example: "GST-00001"
No
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
indiaEinvoicebooleanWhether the eInvoice is applicable or not
Example: true
No
indiaGstrbooleanWhether the gstr is applicable or not
Example: true
No
indiaGstrUsernamestringgstr username
Example: true
No
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
panIndiastringCompany PAN Number
Example: "AAAAA1111A"
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
registeredToCompositionSchemebooleanWhether the Tenant is registered to Composition Scheme. Applicable when gstRegistered=true
Example: true
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
sezOrImportExportbooleanWhether the Tenant is an SEZ or deals with Import/Export. Applicable when gstRegistered=true
Example: true
No
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tanNumberIndiastringCompany TAN Number
Example: "GSFD2376S"
No
tcsEnabledbooleanWhether the TCS is enabled or not.
Example: true
No
tdsPaymentInterestRateIndianumberTDS Payment Interest Rate for India
Example: "1%"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
trackDigitalServicesbooleanWhether the Tenant has enables tracking of digital services to overseas customers. Applicable when gstRegistered=true
Example: true
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoIndonesia​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
exciseAccountstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicablebooleanTrue to allow excise flow for indonesia country
Example: true
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
npwpNostringIndonesia specific Organization NPWP No.
Example: 123456789098765
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoIsrael​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
ilDeductionFileIdstringIsrael specific deduction file id
Example: "deduction file id"
No
ilEngagementTypestringIsrael specific engagement type
Example: "engagement type"
No
ilIncomeTaxNostringIsrael specific income tax no
Example: "income tax no"
No
ilLegalNamestringIsrael specific legal name
Example: "legal name"
No
ilNationalInsuranceNostringIsrael specific national insurance no
Example: "national insurance no"
No
ilParentSubsidiaryNamestringIsrael specific parent subsidiary name
Example: "parent subsidiary name"
No
ilReturnAddress[ Address ]Israel Specific Billing AddressNo
ilReturnEmailstringIsrael specific return email
Example: "return email"
No
ilVatCodestringIsrael specific vat code
Example: "vat code"
No
ilVatRegistrationNostringIsrael specific vat registration no
Example: "vat registration no"
No
ilWithholdingTaxAccountstringIsrael specific withholding tax account
Example: "withholding tax account"
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoMalaysia​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
businessRegistrationNostringOrganization Business Reg No. for Malaysia
Example: "B91234567X"
No
complianceEnabledbooleanWhether the business collects tax or not.No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
exemptionbooleanWhether the Exemption is on or off.
Example: true
No
exemptionCerificatebooleanWhether the Exemption Cerificate is availble or not.
Example: true
No
exemptionCriteriastringOrganization Exemption criteria. for Malaysia
Example: "EX1234567X"
No
exemptionNostringOrganization Exemption No. for Malaysia
Example: "EX1234567X"
No
expiryDatedateTimeThe Date on Which SST was registered. Date Format is dd-mm-yyyy. Applicable when sstRegistered=true
Example: "01-01-2020"
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesTaxRegistrationNostringOrganization Sales Tax Reg No. for Malaysia
Example: "T91234567X"
No
serviceProviderstringService provider priorityNo
serviceTaxRegistrationNostringOrganization Service Tax Reg No. for Malaysia
Example: "S91234567X"
No
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoNL​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
companyRegistrationNumberNLstringCompany Registration Number
Example: "B91234567X"
No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatIdentificationNumberNLstringVAT Identification Number
Example: "B91234567X"
No

TenantInfoNZ​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
gstNoNZstringGST Number
Example: "111-111-111"
No
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
irdNostringIRD Number
Example: "111-111-111"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No

TenantInfoPhilippines​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatNoPhilippinesstringPhilippines specific Organization VAT No.
Example: "012-345-678-910"
No
vatPayableAccountPhilippinesstringPayable Account
Example: "012345678910"
No

TenantInfoSA​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
exciseAccountSAstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicableSAbooleanTrue to allow excise flow for UAE country
Example: true
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isDesignatedZoneSAbooleanIs your business located in a Designated Zone?
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
outsideContactSAbooleanTrue to allow RCM flow for UAE country
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
rcmAccountSAstringAccount to set for RCM
Example: "AC400010"
No
registeredForVatSAbooleanRegistered for vat flag
Example: false
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
tenantInfoInSATenantInfoSASaudiLanguageArabic Details
Example: true
No
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatAccountNumberSAstringVat Account Number
Example: "NL123456789B01"
No
vatReturnFrequencySAstringVAT Return Frequency
Example: "Monthly"
No

TenantInfoSASaudiLanguage​

NameTypeDescriptionRequired
arabicNameSAstringExample: "Name in Saudi Arabic Language"No
billingAddress[ Address ]Billing addresses in Arabic languageNo
shippingAddress[ Address ]Shipping addresses in Arabic languageNo

TenantInfoUAE​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
exciseAccountstringAccount to set for Excise Payable
Example: "AC400010"
No
exciseApplicablebooleanTrue to allow excise flow for UAE country
Example: true
No
financialStartDatestringFinancial Start DateNo
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isDesignatedZonebooleanIs your business located in a Designated Zone?
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
outsideContactbooleanTrue to allow RCM flow for UAE country
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
rcmAccountstringAccount to set for RCM
Example: "AC400010"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatNoUAEstringUAE specific Organization VAT No.
Example: "012-345-678-910"
No

TenantInfoUK​

NameTypeDescriptionRequired
additionalSettingsobjectAdditional org settingsNo
addressAddressAddressNo
allowNegativeInventorybooleanAllow negative inventory
Example: true
No
billingAddresses[ Address ]Billing addressesNo
bookBeginningStartDatestringBook beginning dateNo
businessRegistrationNoUKstringOrganization Business Reg No. for UK
Example: "B91234567X"
No
contactsTenantContactContact informationNo
countrystringCountry Code
Example: "SG"
No
currencystringCurrency
Example: "SGD"
No
dateFormatstringDate format
Example: "DF001"
No
decimalScaleintegerDecimal ScaleNo
defaultPaymentTermlongPayment Term Id
Example: 1
No
financialStartDatestringFinancial Start DateNo
flatRatePercentageListUK[ FlatRatePercentageListUK ]Whether the Marketing Tax Digital is on or off.
Example: true
No
fyClosingPeriodEndDatestringClosing Period End dateNo
idlongTenant id
Example: 1234
No
implementFIFOForAdvTrackingbooleanImplement FIFO for advanced trackingNo
invoiceCreditLimitTypestringInvoice Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
isBookKeeperbooleanFlag to indicate if Organization is Book Keeper
Example: true
No
isDemoOrgbooleanFlag to indicate demo Organization
Example: true
No
isIncludeCurrentInvoicebooleanInclude Current Invoice
Example: false
No
isIncludeCurrentQuotationbooleanInclude Current Quotation
Example: false
No
isIncludeCurrentSalesOrderbooleanInclude Current Sales Order
Example: false
No
landedCostSettingsLandedCostSettingsLanded Cost SettingsNo
logoUrlstringTenant logo
Example: "http://wwww.amazon-s3/tenant/mylogo.png"
No
marketingTaxDigitalUKbooleanWhether the Marketing Tax Digital is on or off.
Example: true
No
multicurrencyEnabledbooleanMulticurrency enabled flagNo
namestringTenant name
Example: "Deskera"
No
numberFormatstringNumber Format
Enum: "us", "in", "fr", "es"
No
orgSetupCompletedbooleanWhether organization setup is completed or not?
Example: true
No
quotationCreditLimitTypestringQuotation Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
salesOrderCreditLimitTypestringSales Order Credit Limit Type
Enum: "IGNORE", "WARN", "BLOCK"
Example: "IGNORE"
No
serviceProviderstringService provider priorityNo
shippingAddresses[ Address ]Shipping addressesNo
sourcestringRegistration source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
No
tenantCreatedDatestringTenant Created DateNo
timezonestringTimezone
Example: "TZ001"
No
useSeparateSequenceFormatbooleanUse separate sequence format
Example: true
No
vatIdentificationNumberUKstringVAT Number
Example: 123456789098765
No
vatSchemeUKstringVAT Scheme
Example: "Standard scheme"
No

TenantInformation​

NameTypeDescriptionRequired
contactTenantContactNo
countryLookupCodestringNo
createdAtstringNo
deletedbooleanNo
demoOrgbooleanNo
idlongNo
isBookkeeperbooleanNo
isPartnerbooleanNo
namestringNo
userUserInformationNo

TenantInventoryDetails​

NameTypeDescriptionRequired
costOfGoodsSoldAccountstringCost of goods sold account
Example: "C001"
No
finishedGoodsInventorystringFinished Goods Account
Example: "ACC-0000029"
No
inventoryAccountstringInventory Account Code
Example: "IA001"
No
inventoryPurchaseAccountstringPurchase Account (Inventory)
Example: "PAI001"
No
inventoryPurchaseReturnAccountstringPurchase Return Account (Inventory)
Example: "PRI001"
No
manufacturingCoststringManufacturing cost Account
Example: "ACC-0000030"
No
nonInventoryPurchaseAccountstringPurchase Account (Non Inventory)
Example: "PANI001"
No
nonInventoryPurchaseReturnAccountstringPurchase Return Account (Non Inventory)
Example: "PRNI001"
No
salesAccountstringSales Account
Example: "SA001"
No
salesReturnAccountstringSales Return Account
Example: "SRA001"
No
stockAdjustmentAccountstringStock adjustment account code
Example: "SA001"
No
wipInventoryAccountstringWIP Inventory Account Code
Example: "IA001"
No

TenantInviteResponse​

NameTypeDescriptionRequired
currentUserCountintegerCurrent User Count
Example: 3
No
invites[ AppInviteResponse ]Invite List
Example: 1
No
planMaxUserCountintegermax user count as per the plan
Example: 3
No
planNamestringPlan subscribed by the tenant
Example: 1
No

TenantMeta​

NameTypeDescriptionRequired
industrystringtype of industry
Example: "Food"
No
noOfEmployeesstringno of employees in company
Example: 25
No

TenantName​

NameTypeDescriptionRequired
dateFormatstringCompany name
Example: "Deskera"
No
idlongPrimary Key
Example: 1
No
namestringCompany name
Example: "Deskera"
No

TenantRequest​

NameTypeDescriptionRequired
isBookkeeperbooleanIf the tenant is bookkeeper
Example: false
No
refreshTokenstringRefresh Token
Example: "refreshToken"
No
sourcestringRegistration Source
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "DESKERA"
No
tenantNamestringTenant name
Example: "Deskera"
Yes

TenantRoleDto​

NameTypeDescriptionRequired
isAdminbooleanNo
orgNamestringNo
roleIdstringNo
roleNamestringNo
tenantIdstringNo

TenantSettings​

NameTypeDescriptionRequired
TenantSettingsobject

TenantShortInfo​

NameTypeDescriptionRequired
currencyLookUpCodestringNo
demoOrgbooleanNo
emailstringNo
idlongNo
isBookkeeperbooleanNo
namestringNo
ownerUserIdlongNo
primaryCurrencyCodestringNo

TenantSubscription​

NameTypeDescriptionRequired
AIOPlanPlanInfoNo
CRMPlanPlanInfoNo
CustomPlanPlanInfoNo
ERPPlanPlanInfoNo
PeoplePlanPlanInfoNo
ProductLimits[ ProductLimit ]No
StatusstringNo

TenantUpdateNameRequest​

NameTypeDescriptionRequired
newNamestringCompany's New Name
Example: "Acme Inc"
Yes

TenantUpdateRequest​

NameTypeDescriptionRequired
billingAddresses[ Address ]Billing AddressesNo
logoUrlstringLogo Url
Example: "http://sjhfksdf.com/logo.png"
No
shippingAddresses[ Address ]Shipping AddressesNo

TenantWorkOrderDetails​

NameTypeDescriptionRequired
defaultTaggedBinTargetWarehouseobjectDefault tagged bin/warehouse target for work ordersNo

UnAssignUserRoleRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
Yes
iamUserIds[ long ]List of iamUserIds of users
Example: [4,11,12]
No
userIds[ long ]List users assign
Example: [1,2,3]
Yes

UnassignUserRoleRequestInternal​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
Yes
iamUserIdlongiamUserId
Example: 12345
Yes
tenantIdlongtenantId
Example: 12345
Yes

UpdateUserInfo​

NameTypeDescriptionRequired
idlongNo
userobjectNo

UpdateUserInfoModuleRole​

NameTypeDescriptionRequired
assignUserRoleRequest[ AppPermissionRequest ]No
tenantIdlongNo
unAssignUserRoleRequestRemovePermissionRequestNo
updateUserInfoUpdateUserInfoNo

UpdateUserInfoWithRoles​

NameTypeDescriptionRequired
assignUserRoleRequest[ AssignUserRoleRequest ]No
unAssignUserRoleRequest[ UnAssignUserRoleRequest ]No
updateUserInfoUpdateUserInfoNo

User​

NameTypeDescriptionRequired
address[ Address ]No
appUserRoleXrefs[ AppUserRoleXref ]No
contactstringNo
createdAtdateTimeNo
createdBylongNo
deletedbooleanNo
departmentstringNo
designationstringNo
domainstringNo
emailstringNo
firebaseIdstringNo
firstNamestringNo
gdprMigratedbooleanNo
genderLookUpCodestringNo
iamUserIdlongNo
idlongNo
idpUserIdstringNo
isBookkeeperbooleanNo
isEmailVerifiedbooleanNo
isPartnerbooleanNo
lastNamestringNo
migratedbooleanNo
passwordstringNo
profileUrlstringNo
statusstringNo
tenantIdlongNo
updatedAtdateTimeNo
updatedBylongNo
userMigratedbooleanNo
userNamestringNo
userTenantMappingList[ UserTenantMapping ]No

UserCache​

NameTypeDescriptionRequired
permissionsobjectUser Permissions
Example: "'ERP':['acc_gr_rwd','account_rwd']"
No
tenantIdlongTenant Primary Key
Example: 1
No
userIdlongUser Primary Key
Example: 1
No
userLimitCacheUserLimitCacheNo

UserChangePasswordRequest​

NameTypeDescriptionRequired
newPasswordstringNew valid password
Example: "test#123"
Yes
oldPasswordstringOld valid password
Example: "test@123"
Yes

UserDto​

NameTypeDescriptionRequired
address[ Address ]List of Address.No
appNamestringApplication name
Example: "ERP"
Yes
authUserIdstringAuth0 User ID
Example: `"auth0
5d70ec986e382a0d12a4ff22"`
authenticationResultTypeAuthenticationResultTypeNo
contactstringUser contact number
Example: 12345678
No
deletedbooleanDelete Flag
Example: false
No
departmentstringUser Department
Example: "Finance"
No
designationstringUser Designation
Example: "Accountant"
No
emailstringUser email
Example: "jsmith@example.com"
No
emailVerifiedbooleanNo
firstNamestringUser First Name
Example: "John"
Yes
fullNamestringNo
genderLookUpCodestringGender
Example: "Mr."
No
iamUserIdlongUser Id in IAM
Example: 2
No
idlongPrimary Key
Example: 1
No
inviteCodestringUnique Invitation Code
Example: "3609848a-394a-41c6-817f-c81e362881ed"
No
isBookkeeperbooleanflag to send email or not
Example: true
No
isGoUserbooleanGo request to update user to ERP
Example: false
No
isInviteUserbooleanFlag to indicate invite user flow
Example: false
No
isPartnerbooleanflag for partner book keeper
Example: true
No
lastNamestringUser Last Name
Example: "Doe"
Yes
peoplePlusbooleanflag to decide whether user is created from People/People+
Example: false
No
profileUrlstringUser profile image path.
Example: "http://deskera.com/user/myprofile.png"
No
roleGroupstringRole Group
Example: "admin"
Yes
shouldSendEmailbooleanflag to send email or not
Example: true
No
statusstringStatus like Active/ InActive
Example: "active"
No
tenantIdlongTenant Id
Example: 1
Yes
userNamestringUsername
Example: "d.6511223344"
No

UserInformation​

NameTypeDescriptionRequired
contactstringNo
createdAtstringNo
emailstringNo
firstNamestringNo
isBookkeeperbooleanNo
isPartnerbooleanNo
lastNamestringNo

UserLanguageDto​

NameTypeDescriptionRequired
languageCodestringNo
languageNamestringNo

UserLastLoginInfo​

NameTypeDescriptionRequired
ipAddressstringNo
userIdlongNo

UserLimitCache​

NameTypeDescriptionRequired
limitsobjectLimits
Example: "'ERP':['contact','[monthly:100,total:1000]]']"
No
tenantIdlongTenant Primary Key
Example: 1
No

UserPermissionRequest​

NameTypeDescriptionRequired
apps[ AppPermissionRequest ]List of app permissionNo
tenantIdlongTenant Id
Example: 2
No
userIdlongUser Id
Example: 2
No

UserPermissionResponse​

NameTypeDescriptionRequired
apps[ AppPermissionResponse ]List of Apps PermissionNo
userIdlongUser Id
Example: 2
No

UserRoleBasicInfo​

NameTypeDescriptionRequired
appRoles[ AppRoleInfo ]appRolesNo
contactstringUser contact number
Example: "+6512345678"
No
emailstringUser email
Example: "jsmith@example.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM user id
Example: 1
No
lastNamestringUser Last Name
Example: "Doe"
No
statusstringStatus like Active/ InActive
Example: "active"
No

UserShortInfo​

NameTypeDescriptionRequired
emailstringNo
firstNamestringNo
iamUserIdlongNo
idlongNo
lastNamestringNo
profileUrlstringNo
userNamestringNo

UserShortRoleInfo​

NameTypeDescriptionRequired
address[ Address ]List of Address.No
authUserIdstringAuth0 User ID
Example: `"auth0
5d70ec986e382a0d12a4ff22"`
contactstringUser Contact
Example: 12345678
No
deletedbooleanDelete Flag
Example: false
No
departmentstringUser Department
Example: "Finance"
No
designationstringUser Designation
Example: "Accountant"
No
emailstringUser email
Example: "jsmith@example.com"
No
firstNamestringUser First Name
Example: "John"
No
genderLookUpCodestringGender
Example: "Mr."
No
iamUserIdlongIam User Id
Example: 1
No
idlongPrimary Key
Example: 1
No
isEmailVerifiedbooleanEmail is verified or not.No
lastNamestringUser Last Name
Example: "Doe"
No
mfaenabledbooleanNo
profileUrlstringUser profile image path.
Example: "http://deskera.com/user/myprofile.png"
No
roleShortInfo[ RoleShortInfo ]No
socialAuthstringsocial auth
Example: "auth"
No
statusstringStatus like Active/ InActive
Example: "active"
No
tenantIdlongTenant Id
Example: 1
No
userNamestringUser Name
Example: "jsmith@example.com"
No

UserTenantMapping​

NameTypeDescriptionRequired
createdAtdateTimeNo
createdBylongNo
deletedbooleanNo
firstNameIndexlongNo
gdprMigrationStatusstringNo
idlongNo
ipAddressstringNo
lastLoginbooleanNo
lastLoginAtdateTimeNo
pickedForProcessingbooleanNo
processedbooleanNo
tenantTenantNo
updatedAtdateTimeNo
updatedBylongNo
userContactstringNo
userFirstNamestringNo
userIdlongNo
userLastNamestringNo

UserTenantMappingResponse​

NameTypeDescriptionRequired
countryLookUpCodestringCountry Lookup Code
Example: "SG"
No
dateFormatstringdate format for tenant
Example: "dd-MM-yyyy"
No
enableSwitchbooleanFlag to enable switch
Example: false
No
idlongPrimary Key
Example: 1
No
isDemoOrgbooleanFlag to indicate if organization is demo organization
Example: false
No
logoUrlstringLogo URL
Example: "Logo URL"
No
memberCountintegerMember Count
Example: 12
No
roleGroups[ string ]User Roles GroupNo
tenantIdlongTenant
Example: 1
No
tenantNamestringTenant Name
Example: "Sample Tenant"
No
userContactstringUser Contact
Example: "+65 12345678"
No
userFirstNamestringUser first name
Example: "John"
No
userIdlongUser ID
Example: 1
No
userLastNamestringUser last name
Example: "Doe"
No

UserTenantRelCreationRequest​

NameTypeDescriptionRequired
appUserCreateRequestList[ AppUserRolesCreateRequest ]Role in particular app
Example: [{"roleGroup":"admin","appName":"ERP"}]
No
bkPlanDetailsstringSelected plan details if client pays.
Example: "MONTHLY/YEARLY"
No
bkPlanIdstringSelected plan id if client pays.
Example: 1234
No
bookkeeperPaysbooleanbook keeper team pays or client pays
Example: false
No
contactstringUser Contact Number
Example: 12345678
No
createUserInTenantbooleanFlag to control creation of users in tenant
Example: true
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
idlongTenant ID
Example: 1
No
inviteUserbooleanNo
isBookkeeperbooleanFlag indicate user book keeper
Example: true
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
isGoUserbooleanGo request to add user to ERP
Example: false
No
isPartnerbooleanFlag indicate partner book keeper
Example: true
No
isTeambooleanbook keeper team or client
Example: false
No
isUserNotUpdatedbooleanFlag maintain to identify if user is added through invite flow.
Example: false
No
isWebsitebooleanFlag to indicate signup from website
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
passwordstringPassword
Example: "**********"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No
socialAuthstringNeeded, if user is signing up via social login
Example: "GOOGLE"
No
sourcestringRegistration source DESKERA/SHOPIFY
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "Deskera"
No
tenantIdlongTenant ID
Example: 1
No

UserTenantRelRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
No
bkPlanDetailsstringSelected plan details if client pays.
Example: "MONTHLY/YEARLY"
No
bkPlanIdstringSelected plan id if client pays.
Example: 1234
No
bookkeeperPaysbooleanbook keeper team pays or client pays
Example: false
No
contactstringUser Contact Number
Example: 12345678
No
createUserInTenantbooleanFlag to control creation of users in tenant
Example: true
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
idlongTenant ID
Example: 1
No
inviteCodestringInvitation Code
Example: "abc-123"
No
inviteUserbooleanNo
isBookkeeperbooleanFlag indicate user book keeper
Example: true
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
isGoUserbooleanGo request to add user to ERP
Example: false
No
isPartnerbooleanFlag indicate partner book keeper
Example: true
No
isTeambooleanbook keeper team or client
Example: false
No
isUserNotUpdatedbooleanFlag maintain to identify if user is added through invite flow.
Example: false
No
isWebsitebooleanFlag to indicate signup from website
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
moduleUuids[ string ]List of module UUIDNo
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
passwordstringPassword
Example: "**********"
No
peoplePlusbooleanrequest origin identifier People or PeoplePlus
Example: true
No
roleGroupstringRole Group
Example: "admin"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No
skipCreationbooleanskipCreation
Example: false
No
socialAuthstringNeeded, if user is signing up via social login
Example: "GOOGLE"
No
sourcestringRegistration source DESKERA/SHOPIFY
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "Deskera"
No
tenantIdlongTenant ID
Example: 1
No

UserTenantRoleResponse​

NameTypeDescriptionRequired
orgs[ TenantRoleDto ]No
userIdlongNo

UserTenantTeamRequest​

NameTypeDescriptionRequired
appNamestringApplication name
Example: "ERP"
No
bkPlanDetailsstringSelected plan details if client pays.
Example: "MONTHLY/YEARLY"
No
bkPlanIdstringSelected plan id if client pays.
Example: 1234
No
bkTeamIdlongNo
bookkeeperPaysbooleanbook keeper team pays or client pays
Example: false
No
bookkeeperTeamInfos[ BookkeeperTeamInfo ]No
contactstringUser Contact Number
Example: 12345678
No
createUserInTenantbooleanFlag to control creation of users in tenant
Example: true
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
idlongTenant ID
Example: 1
No
inviteCodestringInvitation Code
Example: "abc-123"
No
inviteUserbooleanNo
isBookkeeperbooleanFlag indicate user book keeper
Example: true
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
isGoUserbooleanGo request to add user to ERP
Example: false
No
isPartnerbooleanFlag indicate partner book keeper
Example: true
No
isTeambooleanbook keeper team or client
Example: false
No
isUserNotUpdatedbooleanFlag maintain to identify if user is added through invite flow.
Example: false
No
isWebsitebooleanFlag to indicate signup from website
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
moduleUuids[ string ]List of module UUIDNo
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
passwordstringPassword
Example: "**********"
No
peoplePlusbooleanrequest origin identifier People or PeoplePlus
Example: true
No
roleGroupstringRole Group
Example: "admin"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No
skipCreationbooleanskipCreation
Example: false
No
socialAuthstringNeeded, if user is signing up via social login
Example: "GOOGLE"
No
sourcestringRegistration source DESKERA/SHOPIFY
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "Deskera"
No
tenantIdlongTenant ID
Example: 1
No

WebSignInRequest​

NameTypeDescriptionRequired
passwordstringUser password
Example: "abcd@123"
Yes
userNamestringUsername
Example: "+65-1234-5678"
Yes

WebSignupRequest​

NameTypeDescriptionRequired
bkPlanDetailsstringSelected plan details if client pays.
Example: "MONTHLY/YEARLY"
No
bkPlanIdstringSelected plan id if client pays.
Example: 1234
No
bookkeeperPaysbooleanbook keeper team pays or client pays
Example: false
No
contactstringUser Contact Number
Example: 12345678
No
createUserInTenantbooleanFlag to control creation of users in tenant
Example: true
No
emailIdstringEmail
Example: "james@bond.com"
No
firstNamestringUser First Name
Example: "John"
No
iamUserIdlongIAM app_user id
Example: 12
No
isBookkeeperbooleanFlag indicate user book keeper
Example: true
No
isEmailVerifiedbooleanEmail Verification Required
Example: false
No
isGoUserbooleanGo request to add user to ERP
Example: false
No
isPartnerbooleanFlag indicate partner book keeper
Example: true
No
isTeambooleanbook keeper team or client
Example: false
No
isUserNotUpdatedbooleanFlag maintain to identify if user is added through invite flow.
Example: false
No
isWebsitebooleanFlag to indicate signup from website
Example: false
No
lastNamestringUser Last Name
Example: "Doe"
No
organizationNamestringPass organization name if you want to create org without setup
Example: "Deskera"
No
passwordstringPassword
Example: "**********"
No
shouldSendEmailbooleanflag to send email or not
Example: true
No
socialAuthstringNeeded, if user is signing up via social login
Example: "GOOGLE"
No
sourcestringRegistration source DESKERA/SHOPIFY
Enum: "DESKERA", "SHOPIFY", "MOBILE", "MOBILE_GOOGLE", "MOBILE_APPLE", "MOBILE_OTHER", "WEB", "WEB_GOOGLE", "WEB_APPLE", "WEB_OTHER"
Example: "Deskera"
No