Get an employment

GET /api/v2/employments/{uuid}

Display an employment record

Headers

Path parameters

uuid integer 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
- 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.
  
  Additional properties are allowed.
- phone_number object
  
  The phone number of the employer.
  
  Additional properties are allowed.
- email_address object
  
  The email address of the employer.
  
  Additional properties are allowed.
- 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".
  
  Additional properties are allowed.
- last_salary_increase object
  
  The last salary increase.
  
  Additional properties are allowed.
- 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.
  
  Additional properties are allowed.
- directors string
  
  The directors of the business.
- shareholding_in_business object
  
  The shareholding in the business.
  
  Additional properties are allowed.
- profit object
  
  The profit of the business.
  
  Additional properties are allowed.
- 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.
  
  Additional properties are allowed.
- income object
  
  Incomes that have been linked to thi employment.
  
  Additional properties are allowed.
- account object
  
  The account for this employment.
  
  Additional properties are allowed.

GET /api/v2/employments/{uuid}

curl \
 -X GET https://api.plannrcrm.com/api/v2/employments/uuid \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"

Response examples (200)

{
  "uuid": "7afb8885-f120-409f-81e2-9e8887219ea9",
  "income": {
    "name": "My Salary",
    "type": "salary",
    "uuid": "8aa74ec6-c79b-4093-aa1b-653c5d1ed267",
    "amount": {
      "amount": {
        "example": "4000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£40.00",
        "description": "Money amount formatted with currency"
      }
    },
    "account": "App\\Http\\Resources\\MinimalAccountResource",
    "end_date": "2025-01-17",
    "frequency": "annually",
    "created_at": "2025-01-17T11:18:33+00:00",
    "employment": "App\\Http\\Resources\\EmploymentResource",
    "is_taxable": true,
    "start_date": "2024-01-17",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "amount_type": "net",
    "shared_owner": "App\\Http\\Resources\\AccountResource",
    "shared_owner_type": "individual"
  },
  "profit": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    }
  },
  "status": "employed",
  "account": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "cdc24ced-1d60-45c9-bc6a-4ec6c8e6d03c",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-01-17T11:18:33+00:00",
    "first_name": "Gareth",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "address": {
    "name": "Work Address",
    "uuid": "221cadde-da55-458c-9fa6-a1c922fa4396",
    "county": "Hampshire",
    "country": "United Kingdom",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "postcode": "PO7 7YH",
    "address_1": "Suite E, 5 The Briars",
    "address_2": "Waterberry Drive",
    "address_3": "The Innovative Centre",
    "address_4": "Waterlooville",
    "town_city": "Waterlooville",
    "created_at": "2025-01-17T11:18:33+00:00",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "move_in_date": "2024-01-17"
  },
  "employer": "Plannr Technologies Ltd",
  "ended_at": "2021-01-17T11:18:33+00:00",
  "directors": "Susan F. Lancaster",
  "job_title": "Senior financial adviser",
  "created_at": "2025-01-17T11:18:33+00:00",
  "occupation": "Financial Adviser",
  "started_at": "2020-01-17T11:18:33+00:00",
  "updated_at": "2025-01-17T11:18:33+00:00",
  "phone_number": {
    "name": "Work number",
    "type": "phone_number",
    "uuid": "32d6e35d-e5a2-451f-a797-b9b220f14618",
    "value": "+443330903630",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "created_at": "2025-01-17T11:18:33+00:00",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "phone_number_meta": {
      "country": "GB",
      "formatted": "0333 090 3630"
    }
  },
  "shared_owner": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "21123701-ab8a-474d-8148-5b70aa504207",
    "email": "gareth@codepotato.co.uk",
    "groups": "App\\Http\\Resources\\GroupResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "last_name": "Thompson",
    "created_at": "2025-01-17T11:18:33+00:00",
    "first_name": "Gareth",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "with_login": true,
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "can_be_deleted": "false",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "next_review_date": "2025-01-17T11:18:33+00:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-01-17T11:18:33+00:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "previous_review_date": "2025-01-17T11:18:33+00:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-01-17T11:18:33+00:00"
  },
  "business_name": "My Business",
  "email_address": {
    "name": "Work number",
    "type": "phone_number",
    "uuid": "24103542-5eb3-41f5-98b6-f8e6ff4b52c7",
    "value": "+443330903630",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "created_at": "2025-01-17T11:18:33+00:00",
    "updated_at": "2025-01-17T11:18:33+00:00",
    "phone_number_meta": {
      "country": "GB",
      "formatted": "0333 090 3630"
    }
  },
  "business_value": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    }
  },
  "occupation_code": "FAC02774",
  "accountant_email": "accountant@email.com",
  "turnover_history": {
    "year": 2020,
    "value": {
      "amount": {
        "example": "4000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£40.00",
        "description": "Money amount formatted with currency"
      }
    }
  },
  "business_year_end": "2020-12-31",
  "is_business_owner": true,
  "shared_owner_type": "individual",
  "accountant_address": "23 Chollerton, Hexham, Northumberland, NE46 4TF",
  "last_salary_increase": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    }
  },
  "accountant_company_name": "My Accountant",
  "shareholding_in_business": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    }
  },
  "accountant_telephone_number": "+441234567890",
  "percentage_of_business_shared": 50
}