Headers

• X-PLANNR-ACCOUNT-UUID string

Path parameters

• uuid string Required

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • uuid string

    The UUID of the resource.

  • created_at string

    The timestamp of when the resource was created.

  • updated_at string

    The timestamp of when the resource was updated.

  • status string

    The employment status. Available values: employed, self_employed, student, unemployed, house_person, retired and other

  • primary boolean

    Denotes if the employment is the primary employment for the account associated.

  • occupation string

    The occupation name found from the occupation code provided.

  • occupation_code string

    The Origo occupation code.

  • job_title string

    Job title if not suitable occupation code is found.

  • employer string

    The name of the employer.

  • started_at string

    The employment start date.

  • ended_at string

    The employment end date if provided.

  • is_business_owner boolean

    Denotes if the account is the business owner.

  • percentage_of_business_shared integer

    The percentage of business shared.

  • address object

    The address of the employer.

    Hide address attributes Show address attributes object

    • uuid string
    • created_at string
    • updated_at string
    • name string
    • address_1 string
    • address_2 string
    • address_3 string
    • address_4 string
    • town_city string
    • county string
    • postcode string
    • country string
    • move_in_date string
    • accounts object
      Hide accounts attributes Show accounts attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

  • phone_number object

    The phone number of the employer.

    Hide phone_number attributes Show phone_number attributes object

    • uuid string
    • created_at string
    • updated_at string
    • type string
    • name string
    • value string
    • phone_number_meta object
      Hide phone_number_meta attributes Show phone_number_meta attributes object

      • country string
      • formatted string
    • accounts object
      Hide accounts attributes Show accounts attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

  • email_address object

    The email address of the employer.

    Hide email_address attributes Show email_address attributes object

    • uuid string
    • created_at string
    • updated_at string
    • type string
    • name string
    • value string
    • phone_number_meta object
      Hide phone_number_meta attributes Show phone_number_meta attributes object

      • country string
      • formatted string
    • accounts object
      Hide accounts attributes Show accounts attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

  • shared_owner_type string

    Denotes if the employment is shared across the client or belongs to one of the owners of the client. (Only applicable for joint/business/trust clients)

  • shared_owner object

    The owner of the employment. Only provided if the shared_owner_type is "individual".

    Hide shared_owner attributes Show shared_owner attributes object

    • uuid string
    • created_at string
    • updated_at string
    • type string
    • role string
    • first_name string
    • last_name string
    • name string
    • email string
    • photo_url string
    • firm object
      Hide firm attributes Show firm attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • name

        Name of the firm

      • slug

        Slug of the firm

      • address_1

        First line of the address

      • address_2

        Second line of the address

      • town_city

        Town/City

      • county

        County

      • postcode

        Postcode

      • country

        Country

      • regulatory_text

        Regulatory text of the firm.

      • logo

        URL of your firm logo.

      • logo_icon

        URL of your firm logo icon.

      • brand_colours

        Firm branding colours.

      • factfind_pdf_header_background

        Header background colour (hex) for the fact-find snapshot PDF.

      • factfind_pdf_header_text

        Header text colour (hex) for the fact-find snapshot PDF.

      • factfind_pdf_logo

        URL of the logo used on the fact-find snapshot PDF.

      • is_subscribed

        Subscription status.

      • keep_deleted_files_for

        Number of days to keep deleted files for

      • tax

        Tax percent

      • month_end

        Date of the month for the monthly income reconciliation statements to end

      • statement_frequency

        The frequency of the income reconciliation statements

      • billing

        Firm invoice details for billing

      • ip_whitelist

        A list of IP Addresses a firm is allowed to log in from.

      • welcome_paragraph_html

        Custom welcome paragraph html for the branded auth welcome page

      • email_welcome_paragraph_html

        Custom welcome paragraph for the welcome/new user email

      • show_fact_find_illustrations

        Determines if the illustrations/graphics are displayed on the fact find.

      • cc_email_addresses

        Array of email cc addresses.

      • bcc_email_addresses

        Array of email bcc addresses.

      • reply_to_email_address

        Firm reply to email address.

      • mobile_app_support_number

        Firm mobile app support number.

      • mobile_app_support_email

        Firm mobile app support email address.

    • primary_phone_number object
      Hide primary_phone_number attributes Show primary_phone_number attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Contact detail type

      • name

        Contact detail description

      • value

        Contact detail value

      • phone_number_meta

        If the type is a phone number, this additional field will be displayed giving you information about the phone number.

    • primary_email object
      Hide primary_email attributes Show primary_email attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Contact detail type

      • name

        Contact detail description

      • value

        Contact detail value

      • phone_number_meta

        If the type is a phone number, this additional field will be displayed giving you information about the phone number.

    • current_time_entry object
      Hide current_time_entry attributes Show current_time_entry attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • name

        The name of the time entry.

      • description

        The description of the time entry.

      • trackable_type

        The model type that is being tracked. The example given is a client, but it can be a case, firm, circle or task.

      • start_date

        The start time of the time entry.

      • end_date

        The end time of the time entry.

      • is_active

        Determines if the time entry is currently ongoing.

      • total_time_in_minutes

        Total time in minutes.

      • computed_time_elapsed_in_seconds

        Computed time elapsed in seconds.

    • assigned_adviser object
      Hide assigned_adviser attributes Show assigned_adviser attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • assigned_administrator object
      Hide assigned_administrator attributes Show assigned_administrator attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • assigned_paraplanner object
      Hide assigned_paraplanner attributes Show assigned_paraplanner attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • introduced_by object
      Hide introduced_by attributes Show introduced_by attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • business_unit object
      Hide business_unit attributes Show business_unit attributes object

      • uuid

        The UUID of the resource.

      • name

        Name of the business unit.

      • has_alternative_branding

        Whether alternative branding is enabled for this business unit.

      • brand_colours

        Brand colours for this business unit, merged with firm defaults.

      • members_count

        Number of accounts assigned to this business unit

      • groups_count

        Number of groups assigned to this business unit

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

    • groups object
      Hide groups attributes Show groups attributes object

      • uuid

        UUID of the group

      • name

        Name of the group

      • slug

        Slug of the group

      • participants_count

        Number of participants in the group

      • participants

        Participants in this group

      • created_at

        Timestamp of when the group was created

      • updated_at

        Timestamp of when the group was updated

    • tags object
      Hide tags attributes Show tags attributes object

      • uuid

        UUID of the tag

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • name

        The name of the tag

      • slug

        The slug of the tag

      • colour

        The colour of the tag

    • owners object
      Hide owners attributes Show owners attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • first_contact_date string
    • next_review_date string
    • previous_review_date string
    • anniversary_review_date string
    • terms_of_business_at string
    • client_agreement_at string
    • with_login boolean
    • has_joint_account boolean
    • can_be_deleted string
    • joint_account_circle object
      Hide joint_account_circle attributes Show joint_account_circle attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • name

        The Circle name

      • photo_url

        URL for initial avatar image

      • bg_colour

        Hex colour background for avatar

      • has_portal_access

        Whether any member of the circle has portal access

      • portal_access_status

        Aggregated portal access status: active, never_logged_in, or no_portal_access

      • engagement_rating

        Aggregated engagement rating: green, amber, red, or none

      • last_login

        Most recent portal login across all circle members, including who logged in

      • portal_login_count_30d

        Total portal login count across all members in last 30 days

      • portal_login_count_90d

        Total portal login count across all members in last 90 days

      • portal_login_count_365d

        Total portal login count across all members in last 365 days

      • joint_account_uuid

        uuid of joint account where circle created from joint account

      • login_access_level

        The access level in context of an account. Note this field is only returned when using the accounts API. Available values: read and write

      • current_life_stage_uuid

        UUID of the circle's current life stage for expenditure

    • circles object
      Hide circles attributes Show circles attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • name

        The Circle name

      • photo_url

        URL for initial avatar image

      • bg_colour

        Hex colour background for avatar

      • has_portal_access

        Whether any member of the circle has portal access

      • portal_access_status

        Aggregated portal access status: active, never_logged_in, or no_portal_access

      • engagement_rating

        Aggregated engagement rating: green, amber, red, or none

      • last_login

        Most recent portal login across all circle members, including who logged in

      • portal_login_count_30d

        Total portal login count across all members in last 30 days

      • portal_login_count_90d

        Total portal login count across all members in last 90 days

      • portal_login_count_365d

        Total portal login count across all members in last 365 days

      • joint_account_uuid

        uuid of joint account where circle created from joint account

      • login_access_level

        The access level in context of an account. Note this field is only returned when using the accounts API. Available values: read and write

      • current_life_stage_uuid

        UUID of the circle's current life stage for expenditure

    • ownership_percentage integer
    • inactive_at string
    • last_interaction_at string
    • referral_code string
    • is_out_of_office boolean
    • out_of_office_from string
    • out_of_office_until string
    • out_of_office_message string
    • service_level object
      Hide service_level attributes Show service_level attributes object

      • uuid

        The UUID of the resource.

      • name

        The name of the service level.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

    • is_pending_fact_find_account boolean
    • permissions object
      Hide permissions attributes Show permissions attributes object

      • firm:read array[string]
      • network:read array[string]
    • custom_fields object
      Hide custom_fields attributes Show custom_fields attributes object

      • uuid

        The UUID of the custom field

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        The type of custom field

      • name

        The name of the custom field

      • reference

        The reference of the custom field, used when updating the custom field on the model.

      • is_required

        Denotes if the custom field is required

      • value

        The value of the custom field

      • selection_options

        This is the array of available options for the selection box. If the type is "selection" this array will be provided.

      • help_text

        Optional help text to aide the custom field. Will be displayed on Plannr.

    • external_references object
      Hide external_references attributes Show external_references attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • third_party

        The third party provider with the reference.

      • reference

        The third party reference.

  • last_salary_increase string

    The date of the last salary increase.

  • business_name string

    The name of the business.

  • business_year_end string

    The year end of the business.

  • business_value object

    The value of the business.

    Hide business_value attributes Show business_value attributes object

    • amount object
      Hide amount attributes Show amount attributes object

      • example string
      • description string
    • formatted object
      Hide formatted attributes Show formatted attributes object

      • example string
      • description string
    • currency object
      Hide currency attributes Show currency attributes object

      • example string
      • description string
  • directors string

    The directors of the business.

  • shareholding_in_business object

    The shareholding in the business.

    Hide shareholding_in_business attributes Show shareholding_in_business attributes object

    • amount object
      Hide amount attributes Show amount attributes object

      • example string
      • description string
    • formatted object
      Hide formatted attributes Show formatted attributes object

      • example string
      • description string
    • currency object
      Hide currency attributes Show currency attributes object

      • example string
      • description string
  • profit object

    The profit of the business.

    Hide profit attributes Show profit attributes object

    • amount object
      Hide amount attributes Show amount attributes object

      • example string
      • description string
    • formatted object
      Hide formatted attributes Show formatted attributes object

      • example string
      • description string
    • currency object
      Hide currency attributes Show currency attributes object

      • example string
      • description string
  • accountant_company_name string

    The name of the accountant.

  • accountant_email string

    The email of the accountant.

  • accountant_telephone_number string

    The telephone number of the accountant.

  • accountant_address string

    The address of the accountant.

  • turnover_history object

    The turnover history of the income.

    Hide turnover_history attributes Show turnover_history attributes object

    • year integer
    • value object
      Hide value attributes Show value attributes object

      • amount object
        Hide amount attributes Show amount attributes object

        • example string
        • description string
      • formatted object
        Hide formatted attributes Show formatted attributes object

        • example string
        • description string
      • currency object
        Hide currency attributes Show currency attributes object

        • example string
        • description string
  • income object

    Incomes that have been linked to thi employment.

    Hide income attributes Show income attributes object

    • uuid string
    • created_at string
    • updated_at string
    • name string
    • type string
    • type_other string
    • amount object
      Hide amount attributes Show amount attributes object

      • amount object
        Hide amount attributes Show amount attributes object

        • example string
        • description string
      • formatted object
        Hide formatted attributes Show formatted attributes object

        • example string
        • description string
      • currency object
        Hide currency attributes Show currency attributes object

        • example string
        • description string
    • amount_type string
    • start_date string
    • end_date string
    • frequency string
    • is_taxable boolean
    • shared_owner_type string
    • shared_owner object
      Hide shared_owner attributes Show shared_owner attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use primary_email instead). The email of the account.

      • photo_url

        URL for initial avatar image

      • first_contact_date

        First contact date

      • next_review_date

        Next review date

      • previous_review_date

        Previous review date

      • anniversary_review_date

        Anniversary review date

      • terms_of_business_at

        Date the Terms of Business were agreed and signed

      • client_agreement_at

        Date the client agreement was agreed and signed

      • with_login

        Denotes whether the account has a login to Plannr

      • has_joint_account

        Denotes whether this account belongs to a joint account too

      • can_be_deleted

        Denotes if the account can be deleted

      • ownership_percentage

        Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

      • inactive_at

        Inactive from date

      • last_interaction_at

        Last interaction date

      • referral_code

        Unique referral code for the employee account (employees only)

      • is_out_of_office

        Denotes whether the account is currently within an active Out of Office window (employees only)

      • out_of_office_from

        Start of the Out of Office period (employees only). Null when not out of office

      • out_of_office_until

        End of the Out of Office period (employees only). Null when not out of office

      • out_of_office_message

        Message shown to portal users while the account is Out of Office (employees only). Null when not out of office

      • is_pending_fact_find_account

        Denotes whether the account is a provisional account created by a fact find that has not yet been submitted (clients only)

      • permissions

        Permission map where keys are permission names and values are target arrays

    • employment object
      Hide employment attributes Show employment attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • status

        The employment status. Available values: employed, self_employed, student, unemployed, house_person, retired and other

      • occupation

        The occupation name found from the occupation code provided.

      • occupation_code

        @deprecated The Origo occupation code.

      • job_title

        Job title if not suitable occupation code is found.

      • employer

        The name of the employer.

      • started_at

        The employment start date.

      • ended_at

        The employment end date if provided.

      • is_business_owner

        Denotes if the account is the business owner.

      • percentage_of_business_shared

        The percentage of business shared.

      • shared_owner_type

        Denotes if the employment is shared across the client or belongs to one of the owners of the client. (Only applicable for joint/business/trust clients)

      • last_salary_increase

        The date of the last salary increase.

      • business_name

        The name of the business.

      • business_year_end

        The year end of the business.

      • business_value

        The value of the business.

      • directors

        The directors of the business.

      • shareholding_in_business

        The shareholding in the business.

      • profit

        The profit of the business.

      • accountant_company_name

        The name of the accountant.

      • accountant_email

        The email of the accountant.

      • accountant_telephone_number

        The telephone number of the accountant.

      • accountant_address

        The address of the accountant.

      • primary

        Denotes if the employment is the primary employment for the account associated.

    • account object
      Hide account attributes Show account attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • type

        Account type

      • role

        Account role

      • first_name

        First name

      • last_name

        Last name

      • name

        Name

      • email

        (Deprecated - Please use the primary email of the account instead). The email of the account.

      • photo_url

        The photo URL of the client

  • account object

    The account for this employment.

    Hide account attributes Show account attributes object

    • uuid string
    • created_at string
    • updated_at string
    • type string
    • role string
    • first_name string
    • last_name string
    • name string
    • email string
    • photo_url string
    • external_references object
      Hide external_references attributes Show external_references attributes object

      • uuid

        The UUID of the resource.

      • created_at

        The timestamp of when the resource was created.

      • updated_at

        The timestamp of when the resource was updated.

      • third_party

        The third party provider with the reference.

      • reference

        The third party reference.

• 422 application/json

  Validation error

  Hide response attributes Show response attributes object

  • message string Required

    A human-readable description of the error.

  • errors object

    Validation messages keyed by the field that failed.

    Hide errors attribute Show errors attribute object

    • * array[string] Additional properties