diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyResponse.cs b/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyResponse.cs
index 55997ac70f..3bda8c07c4 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyResponse.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyResponse.cs
@@ -60,8 +60,6 @@ public void Then_The_Fields_Are_Mapped(GetVacancyQueryResult source, int ukprn)
             actual.Wage.WageType.Should().Be((WageType)source.Vacancy.WageType);
             actual.Wage.WageUnit.Should().Be((WageUnit)source.Vacancy.WageUnit);
             actual.Wage.WageAdditionalInformation.Should().Be(source.Vacancy.WageText);
-            actual.Wage.WageAmountLowerBound.Should().Be(source.Vacancy.WageAmountLowerBound);
-            actual.Wage.WageAmountUpperBound.Should().Be(source.Vacancy.WageAmountUpperBound);
             actual.Ukprn.Should().Be(ukprn);
             actual.VacancyReference.Should().Be(source.Vacancy.VacancyReference.Replace("VAC", ""));
             actual.ClosingDate.Should().Be(source.Vacancy.ClosingDate.AddDays(1).Subtract(TimeSpan.FromSeconds(1)));
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyWageItem.cs b/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyWageItem.cs
index 1ba29c3a2e..b6abb94e1c 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyWageItem.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api.UnitTests/Models/WhenMappingFromMediatorResponseToGetVacancyWageItem.cs
@@ -16,8 +16,6 @@ public void Then_The_Values_Are_Mapped(GetVacanciesListItem source)
             actual.WageAmount.Should().Be(source.WageAmount);
             actual.WageType.Should().Be((WageType)source.WageType);
             actual.WageAdditionalInformation.Should().Be(source.WageText);
-            actual.WageAmountUpperBound.Should().Be(source.WageAmountUpperBound);
-            actual.WageAmountLowerBound.Should().Be(source.WageAmountLowerBound);
             actual.WorkingWeekDescription.Should().Be(source.WorkingWeek);
         }
     }
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacanciesListResponse.cs b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacanciesListResponse.cs
index a5bb32734d..720391f202 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacanciesListResponse.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacanciesListResponse.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
 using System.Linq;
 using SFA.DAS.Vacancies.Application.Vacancies.Queries;
 using SFA.DAS.Vacancies.InnerApi.Responses;
@@ -27,77 +28,158 @@ public static implicit operator GetVacanciesListResponse(GetVacanciesQueryResult
     }
     public class GetVacanciesListResponseItem
     {
-       public DateTime ClosingDate { get; set; }    
-       public string Description { get; set; }
-       public string EmployerName { get; set; }
-       public decimal HoursPerWeek { get; set; }
-       public bool IsDisabilityConfident { get; set; }
-       public  bool IsNationalVacancy { get; set; }
-       public long NumberOfPositions { get; set; }
-       public DateTime PostedDate { get; set; }
-       public string ProviderName { get; set; }
-       public DateTime StartDate { get; set; }
-       public string Title { get; set; }
-       public int Ukprn { get; set; }
-       public string VacancyReference { get; set; }
-       public string VacancyUrl { get; set; }
+        /// <summary>
+        /// The title for the apprenticeship vacancy. Will be less than or equal to 100 characters.
+        /// </summary>
+        [MaxLength(100)]
+        public string Title { get; set; }
+        /// <summary>
+        /// A short summary of the overall apprenticeship. Will be less than or equal to 350 characters.
+        /// </summary>
+        [MaxLength(350)]
+        public string Description { get; set; }
+        /// <summary>
+        /// The number of apprentices being recruited for the apprenticeship. Will be 1 or higher.
+        /// </summary>
+        public long NumberOfPositions { get; set; }
+        /// <summary>
+        /// The date the apprenticeship was added to Find an apprenticeship.
+        /// </summary>
+        /// <example>2019-08-24T:14:15:22Z</example>
+        public DateTime PostedDate { get; set; }
+        /// <summary>
+        /// The last date people can apply for the apprenticeship. Will always be more than 2 weeks after the posted date.
+        /// </summary>
+        /// <example>2019-08-24T:14:15:22Z</example>
+        public DateTime ClosingDate { get; set; }    
+        /// <summary>
+        /// The date the company plans for the apprenticeship to start.
+        /// </summary>
+        /// <example>2019-08-24T:14:15:22Z</example>
+        public DateTime StartDate { get; set; }
+        public GetVacancyWageItem Wage { get; set; }
+        /// <summary>
+        /// The total number of hours per week. This includes both work and training.
+        /// </summary>
+        public decimal HoursPerWeek { get; set; }
+        /// <summary>
+        /// How long the apprenticeship will be. Will be in months, written as a string of text.
+        /// </summary>
+        /// <example>21 months</example>
+        public string ExpectedDuration { get ; set ; }
+        public GetVacancyAddressItem Address { get; set; }
+        public VacancyLocation Location { get; set; }
+        /// <summary>
+        /// If you provide a `lat` and `lon` for a location when using `GET list of vacancies` or `GET vacancy by reference number`, this will be the distance between the apprenticeship and your defined location. Will be in miles.
+        /// </summary>
+        public decimal? Distance { get ; set ; }
+        /// <summary>
+        /// The name of the company the apprentice will work at.
+        /// </summary>
+        public string EmployerName { get; set; }
+        /// <summary>
+        /// The web address for the company the apprentice will work at.
+        /// </summary>
+        public string EmployerWebsiteUrl { get ; set ; }
+        /// <summary>
+        /// A named contact a person can use to ask questions about the apprenticeship before applying. This contact can be from either the employer or training provider.
+        /// </summary>
+        public string EmployerContactName { get ; set ; }
+        /// <summary>
+        /// A phone number a person can use to ask questions about the apprenticeship before applying. This contact can be from either the employer or training provider.
+        /// </summary>
+        public string EmployerContactPhone { get ; set ; }
+        /// <summary>
+        /// An email address a person can use to ask questions about the apprenticeship before applying. This contact can be from either the employer or training provider.
+        /// </summary>
+        public string EmployerContactEmail { get ; set ; }
+        public GetVacancyCourseItem Course { get; set; }
+        /// <summary>
+        /// Whether an apprenticeship is ‘intermediate’ (level 2), ‘advanced’ (level 3), ‘higher’ (level 4 to 5) or ‘degree’ (level 6 or 7).
+        /// </summary>
+        public string ApprenticeshipLevel { get ; set ; }
+        /// <summary>
+        /// The name of the apprenticeship’s training provider.
+        /// </summary>
+        public string ProviderName { get; set; }
+        /// <summary>
+        /// The UK provider reference number (UKRPN) for the apprenticeship’s training provider.
+        /// </summary>
+        public int Ukprn { get; set; }
+        /// <summary>
+        /// Says whether the employer is part of the Department for Work and Pension’s Disability Confident scheme.
+        /// </summary>
+        public bool IsDisabilityConfident { get; set; }
+        /// <summary>
+        /// The address for the apprenticeship’s vacancy on Find an apprenticeship.
+        /// </summary>
+        public string VacancyUrl { get; set; }
+        /// <summary>
+        /// The unique reference code for the vacancy on Find an apprenticeship.
+        /// </summary>
+        public string VacancyReference { get; set; }
+        public  bool IsNationalVacancy { get; set; }
 
-       public GetVacancyCourseItem Course { get; set; }
-       public GetVacancyWageItem Wage { get; set; }
-       public VacancyLocation Location { get; set; }
-       public GetVacancyAddressItem Address { get; set; }
-       public decimal? Distance { get ; set ; }
-
-       public string EmployerContactPhone { get ; set ; }
-       public string EmployerContactName { get ; set ; }
-       public string EmployerContactEmail { get ; set ; }
-       public string EmployerWebsiteUrl { get ; set ; }
-       public string ApprenticeshipLevel { get ; set ; }
-       public string ExpectedDuration { get ; set ; }
-
-       public static implicit operator GetVacanciesListResponseItem(GetVacanciesListItem source)
-       {
-           return new GetVacanciesListResponseItem
-           {
-               ClosingDate = source.ClosingDate.AddDays(1).Subtract(TimeSpan.FromSeconds(1)),
-               Description = source.Description,
-               EmployerName = source.IsEmployerAnonymous ? source.AnonymousEmployerName : source.EmployerName,
-               HoursPerWeek = source.HoursPerWeek,
-               IsDisabilityConfident = source.IsDisabilityConfident,
-               IsNationalVacancy = source.VacancyLocationType != null && source.VacancyLocationType.Equals("National", StringComparison.CurrentCultureIgnoreCase),
-               NumberOfPositions = source.NumberOfPositions,
-               PostedDate = source.PostedDate,
-               ProviderName = source.ProviderName,
-               StartDate = source.StartDate,
-               Title = source.Title,
-               Ukprn = int.Parse(source.Ukprn),
-               VacancyReference = source.VacancyReference.Replace("VAC",""),
-               VacancyUrl = source.VacancyUrl,
-               Course = source,
-               Wage = source,
-               Distance = source.Distance,
-               Address = source,
-               EmployerWebsiteUrl = source.EmployerWebsiteUrl,
-               EmployerContactEmail = source.EmployerContactEmail,
-               EmployerContactName = source.EmployerContactName,
-               EmployerContactPhone = source.EmployerContactPhone,
-               ApprenticeshipLevel = source.ApprenticeshipLevel,
-               ExpectedDuration = source.ExpectedDuration,
-               Location = new VacancyLocation
-               {
-                   Lat = source.Location.Lat,
-                   Lon = source.Location.Lon
-               }
-           };
-       }
+        
+        
+        public static implicit operator GetVacanciesListResponseItem(GetVacanciesListItem source)
+        {
+            return new GetVacanciesListResponseItem
+            {
+                ClosingDate = source.ClosingDate.AddDays(1).Subtract(TimeSpan.FromSeconds(1)),
+                Description = source.Description,
+                EmployerName = source.IsEmployerAnonymous ? source.AnonymousEmployerName : source.EmployerName,
+                HoursPerWeek = source.HoursPerWeek,
+                IsDisabilityConfident = source.IsDisabilityConfident,
+                IsNationalVacancy = source.VacancyLocationType != null && source.VacancyLocationType.Equals("National", StringComparison.CurrentCultureIgnoreCase),
+                NumberOfPositions = source.NumberOfPositions,
+                PostedDate = source.PostedDate,
+                ProviderName = source.ProviderName,
+                StartDate = source.StartDate,
+                Title = source.Title,
+                Ukprn = int.Parse(source.Ukprn),
+                VacancyReference = source.VacancyReference.Replace("VAC",""),
+                VacancyUrl = source.VacancyUrl,
+                Course = source,
+                Wage = source,
+                Distance = source.Distance,
+                Address = source,
+                EmployerWebsiteUrl = source.EmployerWebsiteUrl,
+                EmployerContactEmail = source.EmployerContactEmail,
+                EmployerContactName = source.EmployerContactName,
+                EmployerContactPhone = source.EmployerContactPhone,
+                ApprenticeshipLevel = source.ApprenticeshipLevel,
+                ExpectedDuration = source.ExpectedDuration,
+                Location = new VacancyLocation
+                {
+                    Lat = source.Location.Lat,
+                    Lon = source.Location.Lon
+                }
+            };
+        }
     }
 
     public class VacancyLocation
     {
+        /// <summary>
+        /// The latitude of the address where the apprentice will work.
+        /// </summary>
+        /// <example>51.500729</example>
         public double? Lat { get; set; }
+        /// <summary>
+        /// The longitude of the address where the apprentice will work.
+        /// </summary>
+        /// <example>-0.124625</example>
         public double? Lon { get; set; }
     }
 
+    /// <summary>
+    /// Will be either:
+    /// <ul><li>ApprenticeshipMinimum which is the National Minimum Wage for apprentices.</li>
+    /// <li>NationalMinimum which is the National Minimum Wage.</li>
+    /// <li>Custom which is a set salary set by the company.</li>
+    /// <li>CompetitiveSalary does not set an exact wage and shows the word ‘Competitive’.</li></ul>
+    /// </summary>
     public enum WageType
     {
         ApprenticeshipMinimum = 2,
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyAddressItem.cs b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyAddressItem.cs
index 43c243143a..4d565c0804 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyAddressItem.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyAddressItem.cs
@@ -4,10 +4,25 @@ namespace SFA.DAS.Vacancies.Api.Models
 {
     public class GetVacancyAddressItem
     {
+        /// <summary>
+        /// First line of the address where the apprentice will work.
+        /// </summary>
         public string AddressLine1 { get; set; }
+        /// <summary>
+        /// Second line of the address where the apprentice will work.
+        /// </summary>
         public string AddressLine2 { get; set; }
+        /// <summary>
+        /// Third line of the address where the apprentice will work.
+        /// </summary>
         public string AddressLine3 { get; set; }
+        /// <summary>
+        /// Fourth line of the address where the apprentice will work.
+        /// </summary>
         public string AddressLine4 { get; set; }
+        /// <summary>
+        /// Postcode of the address where the apprentice will work.
+        /// </summary>
         public string Postcode { get; set; }
 
         public static implicit operator GetVacancyAddressItem(GetVacanciesListItem source)
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyCourseItem.cs b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyCourseItem.cs
index 2b13eb07fe..0f11cc9a0e 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyCourseItem.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyCourseItem.cs
@@ -4,9 +4,24 @@ namespace SFA.DAS.Vacancies.Api.Models
 {
     public class GetVacancyCourseItem
     {
+        /// <summary>
+        /// The code from the learning aim reference service (LARS) for the apprenticeship’s training course (almost known as a ‘standard’). Use `GET list of courses` to see all courses and their LARS codes.
+        /// </summary>
         public int LarsCode { get; set; }
+        /// <summary>
+        /// The title of the apprenticeship training course and its level.
+        /// </summary>
+        /// <example>Furniture restorer (level 3)</example>
         public string Title { get; set; }
+        /// <summary>
+        /// What level the apprenticeship training course is.
+        /// </summary>
+        /// <example>3</example>
         public int Level { get; set; }
+        /// <summary>
+        /// Which route the apprenticeship training course is part of, using the routes from the Institute for Apprenticeships and Technical Education (IfATE). On Find an apprenticeship, we call these categories.
+        /// </summary>
+        /// <example>Creative and design</example>
         public string Route { get; set; }
         public static implicit operator GetVacancyCourseItem (GetVacanciesListItem source)
         {
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyResponse.cs b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyResponse.cs
index c13944bc5d..40ac366dda 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyResponse.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyResponse.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
 using System.Linq;
 using SFA.DAS.Vacancies.Application.Vacancies.Queries;
 
@@ -7,15 +8,28 @@ namespace SFA.DAS.Vacancies.Api.Models
 {
     public class GetVacancyResponse : GetVacanciesListResponseItem
     {
+        /// <summary>
+        /// A description of the company the apprentice will work at. Will be less than or equal to 4000 characters.
+        /// </summary>
+        [MaxLength(4000)]
+        public string EmployerDescription { get; set; }
+        /// <summary>
+        /// The apprenticeship’s training plan, including where and when training will take place.
+        /// </summary>
         public string TrainingDescription { get ; set ; }
-        public string FullDescription { get ; set ; }
+        /// <summary>
+        /// Additional information about the training, such as details about the provider.
+        /// </summary>
+        public string AdditionalTrainingDescription { get; set; }
+        /// <summary>
+        /// What progress or outcome the apprentice can expect at the end of the apprenticeship.
+        /// </summary>
         public string OutcomeDescription { get ; set ; }
-        public string EmployerDescription { get; set; }
+        public string FullDescription { get ; set ; }
         public List<string> Skills { get ; set ; }
         public List<GetVacancyQualification> Qualifications { get ; set ; }
         public string ThingsToConsider { get; set; }
         public string CompanyBenefitsInformation { get; set; }
-        public string AdditionalTrainingDescription { get; set; }
 
         public static implicit operator GetVacancyResponse(GetVacancyQueryResult source)
         {
diff --git a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyWageItem.cs b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyWageItem.cs
index 73ea5615f7..d43a114b2e 100644
--- a/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyWageItem.cs
+++ b/src/Vacancies/SFA.DAS.Vacancies.Api/Models/GetVacancyWageItem.cs
@@ -1,16 +1,26 @@
 using SFA.DAS.Vacancies.InnerApi.Responses;
+using System.ComponentModel.DataAnnotations;
 
 namespace SFA.DAS.Vacancies.Api.Models
 {
     public class GetVacancyWageItem
     {
+        public WageType WageType { get; set; }
+        /// <summary>
+        /// If `wageType` is `Custom`, this will be the set annual wage for the apprenticeship.
+        /// </summary>
         public decimal? WageAmount { get; set; }
-        public decimal? WageAmountLowerBound { get; set; }
-        public decimal? WageAmountUpperBound { get; set; }
+        public WageUnit WageUnit { get; set; }
+        /// <summary>
+        /// Additional information about pay, such as when the apprentice might get a pay rise. Will be less than or equal to 250 characters.
+        /// </summary>
+        [MaxLength(250)]
         public string WageAdditionalInformation { get; set; }
-        public WageType WageType { get; set; }
+        /// <summary>
+        /// Information about the working schedule, such as daily working hours. Will be less than or equal to 250 characters.
+        /// </summary>
+        [MaxLength(250)]
         public string WorkingWeekDescription { get; set; }
-        public WageUnit WageUnit { get; set; }
 
         public static implicit operator GetVacancyWageItem(GetVacanciesListItem source)
         {
@@ -20,8 +30,6 @@ public static implicit operator GetVacancyWageItem(GetVacanciesListItem source)
                 WageType = source.WageType == 0 ? WageType.Custom : (WageType)source.WageType,
                 WageAdditionalInformation = source.WageText,
                 WorkingWeekDescription = source.WorkingWeek,
-                WageAmountLowerBound = source.WageAmountLowerBound,
-                WageAmountUpperBound = source.WageAmountUpperBound,
                 WageUnit = (WageUnit)source.WageUnit
             };
         }
diff --git a/src/VacanciesManage/SFA.DAS.VacanciesManage.Api/Models/CreateVacancyRequest.cs b/src/VacanciesManage/SFA.DAS.VacanciesManage.Api/Models/CreateVacancyRequest.cs
index e1c10089e8..75d4c8caef 100644
--- a/src/VacanciesManage/SFA.DAS.VacanciesManage.Api/Models/CreateVacancyRequest.cs
+++ b/src/VacanciesManage/SFA.DAS.VacanciesManage.Api/Models/CreateVacancyRequest.cs
@@ -52,133 +52,159 @@ public static implicit operator PostVacancyRequestData(CreateVacancyRequest sour
         }
 
         /// <summary>
-        /// Contact details to be used if the ESFA needs to get in touch about your advert.
+        /// The title for the apprenticeship vacancy on Find an apprenticeship. Must include: <b>apprentice</b> or <b>apprenticeship</b>.
         /// </summary>
-        [JsonPropertyName("submitterContactDetails")]
+        /// <example>Library assistant apprenticeship</example>
+        [JsonPropertyName("title")]
         [Required]
-        public SubmitterContactDetails SubmitterContactDetails { get ; set ; }
+        [MaxLength(100)]
+        public string Title { get ; set ; }
 
         /// <summary>
-        /// The Training Provider and Account Legal Entity where the vacancy is. If creating as a training provider the UKPRN will not be editable.
+        /// The number of apprentices being recruited for the apprenticeship.
         /// </summary>
-        [JsonPropertyName("contractingParties")]
+        [JsonPropertyName("numberOfPositions")]
         [Required]
-        public ContractingParties ContractingParties { get ; set ; }
+        public int NumberOfPositions { get; set; }
 
         /// <summary>
-        /// The name of the vacancy or job role being advertised. Must contain the word apprentice or apprenticeship and be less than 100 characters.
+        /// The last date people can apply for the apprenticeship. Must be at least 2 weeks in the future.
         /// </summary>
-        /// <example>Apprenticeship in Advanced Baking</example>
-        [JsonPropertyName("title")]
+        /// <example>2019-08-24T:14:15:22Z</example>
+        [JsonPropertyName("closingDate")]
         [Required]
-        public string Title { get ; set ; }
+        public DateTime ClosingDate { get; set; }
 
         /// <summary>
-        /// What activities and duties will the apprentice be undertaking during the apprenticeship. Must not exceed 4000 characters
+        /// The planned date for the apprenticeship’s start. We suggest using a date 2 weeks after the closing date.
         /// </summary>
-        [JsonPropertyName("description")]
+        /// <example>2019-08-24T:14:15:22Z</example>
+        [JsonPropertyName("startDate")]
         [Required]
-        public string Description { get ; set ; }
+        public DateTime StartDate { get; set; }
 
         /// <summary>
-        /// The LARS code associated with the Standard you wish to create the advert for. This can be found from `GET referencedata/courses`
+        /// The Training Provider and Account Legal Entity where the vacancy is. If creating as a training provider the UKPRN will not be editable.
         /// </summary>
-        /// <example>119</example>
-        [JsonPropertyName("standardLarsCode")]
+        [JsonPropertyName("contractingParties")]
         [Required]
-        public string ProgrammeId { get ; set ; }
+        public ContractingParties ContractingParties { get ; set ; }
+
+        [JsonPropertyName("wage")]
+        [Required]
+        public CreateVacancyWage Wage { get; set; }
         /// <summary>
-        /// If `EmployerNameOption` is set to `TradingName` then will be used and Trading name in the application updated. If it is set to `Anonymous` then will be used for the anonymous employer name. If it is set to `RegisteredName` then the Account Legal Entity name will be used. Must not exceed 100 characters
+        /// Where the apprenticeship will be based, this could be a different location to the organisation address. Use the place the apprentice will spend most of their time.
         /// </summary>
-        [JsonPropertyName("alternativeEmployerName")]
-        public string EmployerName { get ; set ; }
+        [JsonPropertyName("address")]
+        public CreateVacancyAddress Address { get; set; }
         /// <summary>
-        /// A short description of the apprenticeship. Must not exceed 350 characters
+        /// A short summary of the overall apprenticeship. This appears at the top of the vacancy on Find an apprenticeship.
         /// </summary>
         [JsonPropertyName("shortDescription")]
+        [MaxLength(350)]
         [Required]
         public string ShortDescription { get ; set ; }
         /// <summary>
-        /// The number of apprentices that will be recruited into the role. Add as a numerical value, must be at least 1.
+        /// What the apprentice will do at work. We suggest including day-to-day duties. Must include at least 3 bullet points (written in HTML).
         /// </summary>
-        [JsonPropertyName("numberOfPositions")]
+        /// <example>Your daily tasks could include: <ul><li> working within a team to deliver a menu of high-quality food each service</li> <li> prepare food in a way that meets food hygiene standards</li> <li> storing food correctly</li> </ul></example>
+        [JsonPropertyName("description")]
+        [MaxLength(4000)]
         [Required]
-        public int NumberOfPositions { get ; set ; }
+        public string Description { get ; set ; }
         /// <summary>
-        /// What an apprentice can expect in terms of career progression after the apprenticeship ends. You may want to mention specific routes they could take once qualified. Must not exceed 4000 characters
+        /// What progression or outcome the apprentice can expect at the end of the apprenticeship.
         /// </summary>
         [JsonPropertyName("outcomeDescription")]
+        [MaxLength(4000)]
         [Required]
         public string OutcomeDescription { get ; set ; }
         /// <summary>
-        /// The last date for receiving new applications. This must be before  the start date of the apprenticeship. Must be a valid date. Closing date for applications cannot be today or earlier.
+        /// Where and when an apprentice’s training will take place. Don’t include any other information about the training here.
+        /// If you submit an advert without providing this field, we’ll display a message on Find an apprenticeship saying that the training schedule hasn’t been agreed yet.
         /// </summary>
-        [JsonPropertyName("closingDate")]
+        /// <example>One day per week, in-person at college</example>
+        [JsonPropertyName("trainingDescription")]
+        [MaxLength(4000)]
         [Required]
-        public DateTime ClosingDate { get ; set ; }
+        public string TrainingDescription { get ; set ; }
         /// <summary>
-        /// The planned start date of the apprenticeship. This must be after the closing date. Must be a valid date. Possible apprenticeship start date can't be today or earlier. We advise using a date more than two weeks from now.
+        /// Further information about an apprentice’s training, such as details about the training provider or how the course will be structured.
         /// </summary>
-        [JsonPropertyName("startDate")]
+        /// <example>You’ll have an apprenticeship advisor who will support you through your apprenticeship.</example>
+        [JsonPropertyName("additionalTrainingDescription")]
+        [MaxLength(4000)]
+        public string AdditionalTrainingDescription { get; set; }
+        /// <summary>
+        /// The code from the learning aim reference service (LARS) for the apprenticeship’s training course (also known as a ‘standard’). See all codes using `GET referencedata/courses`.
+        /// </summary>
+        /// <example>119</example>
+        [JsonPropertyName("standardLarsCode")]
         [Required]
-        public DateTime StartDate { get ; set ; }
+        public string ProgrammeId { get ; set ; }
+        /// <summary>
+        /// Select if you do not wish your company name to be listed on the advert. This could mean fewer people view your advert.
+        /// </summary>
+        [JsonPropertyName("employerNameOption")]
+        public EmployerNameOption EmployerNameOption { get ; set ; }
         /// <summary>
-        /// A brief description about the employer. Must not exceed 4000 characters 
+        /// When `employerNameOption` is set to `tradingName`, use this field to set the company’s name yourself with the correct formatting.
         /// </summary>
+        [JsonPropertyName("alternativeEmployerName")]
+        [MaxLength(100)]
+        public string EmployerName { get ; set ; }
+        /// <summary>
+        /// When `employerNameOption` is set to `anonymousName`, give a brief description of the company to help people understand what they do.
+        /// </summary>
+        /// <example>Car manufacturer or clothes retailer</example>
         [JsonPropertyName("employerDescription")]
+        [MaxLength (100)]
         [Required]
         public string EmployerDescription { get ; set ; }
         /// <summary>
-        /// The training the apprentice will undertake and the qualification they will get at the end of the apprenticeship. Add any certifications and levels of qualifications. Must not exceed 4000 characters. 
+        /// When `employerNameOption` is set to `anonymousName`, tell us why you need to hide the company's name.
+        /// This will not appear on Find an apprenticeship but is needed for our quality assurance team to approve your vacancy.
         /// </summary>
-        [JsonPropertyName("trainingDescription")]
-        [Required]
-        public string TrainingDescription { get ; set ; }
+        [JsonPropertyName("anonymousReason")]
+        [MaxLength(200)]
+        public string AnonymousReason { get ; set ; }
         /// <summary>
-        /// Further information about an apprentice’s training, such as details about the training provider or how the course will be structured. Must not exceed 4000 characters.
+        /// The web address for the employer’s website.
         /// </summary>
-        [JsonPropertyName("additionalTrainingDescription")]
-        public string AdditionalTrainingDescription { get; set; }
+        [JsonPropertyName("employerWebsiteUrl")]
+        public string EmployerWebsiteUrl { get; set; }
         /// <summary>
-        /// Where the apprenticeship will be based, this could be a different location to the organisation address. Use the place the apprentice will spend most of their time.
+        /// Are you registered as a Disability Confident employer?
         /// </summary>
-        [JsonPropertyName("address")]
-        public CreateVacancyAddress Address { get; set; }
-        [JsonPropertyName("wage")]
+        [JsonPropertyName("disabilityConfident")]
         [Required]
-        public CreateVacancyWage Wage { get; set; }
+        public CreateVacancyDisabilityConfident DisabilityConfident { get ; set ; }
+
+        [JsonPropertyName("submitterContactDetails")]
+        [Required]
+        public SubmitterContactDetails SubmitterContactDetails { get ; set ; }
+
         /// <summary>
-        /// Add the desired skills and personal qualities you’d like the applicant to have in order for you to consider them. There is a selection available from `GET referencedata/skills` or you can add your own. You must include at least one desired skill
+        /// Skills and qualities an apprentice should have for this apprenticeship. We’ll show this on the vacancy.
+        /// If `applicationMethod` is `ThroughFindAnApprenticeship`, we’ll also ask applicants for examples of when they’ve used these skills.
+        /// Use `GET referencedata/skills` to see our default selection of skills or add your own.
         /// </summary>
         [JsonPropertyName("skills")]
         [Required]
         public List<string> Skills { get ; set ; }
         /// <summary>
-        /// Select if you do not wish your company name to be listed on the advert. This could mean fewer people view your advert.
-        /// </summary>
-        [JsonPropertyName("employerNameOption")]
-        public EmployerNameOption EmployerNameOption { get ; set ; }
-        /// <summary>
-        /// Provide the reason why the organisation would like to remain anonymous if chosen for <see cref="EmployerNameOption"/>. The reason must not be more than 4000 characters
-        /// </summary>
-        [JsonPropertyName("anonymousReason")]
-        public string AnonymousReason { get ; set ; }
-        /// <summary>
         /// Qualifications obtained from `GET referendata/qualifications`. You must supply at least one qualification required.
         /// </summary>
         [JsonPropertyName("qualifications")]
         [Required]
         public List<CreateVacancyQualification> Qualifications { get; set; }
         /// <summary>
-        /// Information for applicants about how their applications will be managed externally.
+        /// Other requirements for the applicant, such as needing a Disclosure and Barring Service (DBS) check.
         /// </summary>
-        [JsonPropertyName("applicationInstructions")]
-        public string ApplicationInstructions { get ; set ; }
-        /// <summary>
-        /// If they are being managed externally, add the web address of the employer/agency managing the applications.
-        /// </summary>
-        [JsonPropertyName("applicationUrl")]
-        public string ApplicationUrl { get ; set ; }
+        [JsonPropertyName("thingsToConsider")]
+        [MaxLength(4000)]
+        public string ThingsToConsider { get ; set ; }
         /// <summary>
         /// Select how the applications will be managed. This is either through Find an apprenticeship or an external site. If external `ApplicationUrl` must be set 
         /// </summary>
@@ -186,36 +212,34 @@ public static implicit operator PostVacancyRequestData(CreateVacancyRequest sour
         [Required]
         public CreateVacancyApplicationMethod ApplicationMethod { get ; set ; }
         /// <summary>
-        /// Are you registered as a Disability Confident employer?
+        /// If `applicationMethod` is `throughExternalSite`, you can give some information about the application process.
         /// </summary>
-        [JsonPropertyName("disabilityConfident")]
-        [Required]
-        public CreateVacancyDisabilityConfident DisabilityConfident { get ; set ; }
-        /// <summary>
-        /// Any other information the applicant should be aware of. Must not exceed 4000 characters 
-        /// </summary>
-        [JsonPropertyName("thingsToConsider")]
-        public string ThingsToConsider { get ; set ; }
+        [JsonPropertyName("applicationInstructions")]
+        public string ApplicationInstructions { get ; set ; }
         /// <summary>
-        /// You can choose to display website for your organisation. Website address must be a valid URL.
+        /// If `applicationMethod` is `throughExternalSite`, provide the web address for your application website.
         /// </summary>
-        [JsonPropertyName("employerWebsiteUrl")]
-        public string EmployerWebsiteUrl { get; set; }
-
+        [JsonPropertyName("applicationUrl")]
+        public string ApplicationUrl { get ; set ; }
         /// <summary>
-        /// Add an extra question to the advert’s application form on Find an apprenticeship. Must include a question mark. Must not exceed 250 characters.
+        /// If `applicationMethod` is `throughFindAnApprenticeship`, you can add questions for us to add to the application form.
+        /// Note that we automatically ask all applicants ‘What are your skills and strengths?’ and ‘What interests you about this apprenticeship?’
         /// </summary>
         /// <example>Do you have a driving licence?</example>
         [JsonPropertyName("additionalQuestion1")]
+        [MaxLength(250)]
+        [RegularExpression(@"^\w(.*)\w\?(\s\w(.*)\w[\.\?])*$", ErrorMessage = "Must include '?'")]
         public string AdditionalQuestion1 { get; set; }
-
         /// <summary>
-        /// Adds another extra question to the advert’s application form on Find an apprenticeship. Must include a question mark. Must not exceed 250 characters.
+        /// If `applicationMethod` is `throughFindAnApprenticeship`, add another question to the application form.
         /// </summary>
-        /// <example>What interests you about this industry?</example>
+        /// <example>What is your interest in this industry?</example>
         [JsonPropertyName("additionalQuestion2")]
+        [MaxLength(250)]
+        [RegularExpression(@"^\w(.*)\w\?(\s\w(.*)\w[\.\?])*$", ErrorMessage = "Must include '?'")]
         public string AdditionalQuestion2 { get; set; }
 
+
         public static PostVacancyUserData Map(SubmitterContactDetails submitterContactDetails, ContractingParties contractingParties)
         {
             return new PostVacancyUserData
@@ -245,28 +269,28 @@ public static implicit operator PostVacancyAddressData(CreateVacancyAddress sour
             };
         }
         /// <summary>
-        /// Address line 1
+        /// First line of the address where the apprentice will work.
         /// </summary>
         [JsonPropertyName("addressLine1")]
         [Required]
         public string AddressLine1 { get; set; }
         /// <summary>
-        /// Address line 2
+        /// Second line of the address where the apprentice will work.
         /// </summary>
         [JsonPropertyName("addressLine2")]
         public string AddressLine2 { get; set; }
         /// <summary>
-        /// Address line 3
+        /// Third line of the address where the apprentice will work.
         /// </summary>
         [JsonPropertyName("addressLine3")]
         public string AddressLine3 { get; set; }
         /// <summary>
-        /// Address line 4
+        /// Fourth line of the address where the apprentice will work.
         /// </summary>
         [JsonPropertyName("addressLine4")]
         public string AddressLine4 { get; set; }
         /// <summary>
-        /// Postcode
+        /// Postcode of the address where the apprentice will work.
         /// </summary>
         [JsonPropertyName("postcode")]
         [Required]
@@ -293,50 +317,57 @@ public static implicit operator PostCreateVacancyWageData(CreateVacancyWage sour
                 CompanyBenefitsInformation = source.CompanyBenefitsInformation,
             };
         }
+
+        [JsonPropertyName("wageType")]
+        [Required]
+        public WageType WageType { get; set; }
+
         /// <summary>
-        /// Extra information about pay. 250 character limit
+        /// If `WageType` is `FixedWage`, enter the yearly amount the apprentice will earn.
+        /// </summary>
+        /// <example>25000</example>
+        [JsonPropertyName("fixedWageYearlyAmount")]
+        public decimal? FixedWageYearlyAmount { get ; set ; }
+        /// <summary>
+        /// Additional information about pay, such as when the apprentice might get a pay rise.
         /// </summary>
         [JsonPropertyName("wageAdditionalInformation")]
+        [MaxLength(250)]
         public string WageAdditionalInformation { get ; set ; }
         /// <summary>
-        /// If `WageType.FixedWage` then enter the yearly amount.
+        /// Describe benefits the company offers.
         /// </summary>
-        [JsonPropertyName("fixedWageYearlyAmount")]
-        public decimal? FixedWageYearlyAmount { get ; set ; }
+        [JsonPropertyName("CompanyBenefitsInformation")]
+        [MaxLength(250)]
+        public string CompanyBenefitsInformation { get; set; }
         /// <summary>
-        /// The total number of hours per week. This must include the 20% of time the apprentice will spend training, which could be offsite. Needs to be greater than 16 and less than 48.
+        /// The total number of hours per week. This includes both work and training.
         /// </summary>
         [JsonPropertyName("weeklyHours")]
+        [Length(16, 48, ErrorMessage = "Needs to be between 16 and 48 hours.")]
         [Required]
         public decimal WeeklyHours { get ; set ; }
         /// <summary>
-        /// Expected duration must be at least 12 months. The minimum duration of each apprenticeship is based on the apprentice working at least 30 hours a week, including any off-the-job training they undertake.
-        /// Extend the minimum duration when the working week is fewer than 30 hours using the following formula:
-        /// 12 x 30/average weekly hours = new minimum duration in months; or 52 x 30/average weekly hours = new minimum duration in weeks
-        /// </summary>
-        [JsonPropertyName("duration")]
-        [Required]
-        public int Duration { get ; set ; }
-        /// <summary>
-        /// A short description of the pattern of working hours over the week. Start time, end time and working days. You have up to 250 characters
+        /// Information about the working schedule, such as daily working hours.
         /// </summary>
         [JsonPropertyName("workingWeekDescription")]
+        [MaxLength(250)]
         [Required]
         public string WorkingWeekDescription { get ; set ; }
-        [JsonPropertyName("wageType")]
+        /// <summary>
+        /// How long the apprenticeship will be. Use duration to set a number, and then `durationUnit` to say whether it’s months or years. Apprenticeships must be longer than a year.
+        /// </summary>
+        /// <example>18</example>
+        [JsonPropertyName("duration")]
         [Required]
-        public WageType WageType { get; set; }
+        public int Duration { get ; set ; }
+
         /// <summary>
         /// Used with <see cref="Duration"/> for duration in months or years
         /// </summary>
         [JsonPropertyName("durationUnit")]
         [Required]
         public DurationUnit DurationUnit { get; set; }
-        /// <summary>
-        /// Describe benefits your company offers. Must not exceed 250 characters.
-        /// </summary>
-        [JsonPropertyName("CompanyBenefitsInformation")]
-        public string CompanyBenefitsInformation { get; set; }
     }
 
     public class CreateVacancyQualification
@@ -355,18 +386,27 @@ public static implicit operator PostCreateVacancyQualificationData(CreateVacancy
             };
         }
         /// <summary>
-        /// Qualification Type can be obtained from `GET referencedata/qualifications`
+        /// The type of qualification you want. Use `GET referencedata/qualifications` to see what qualification types you can use.
         /// </summary>
         [JsonPropertyName("qualificationType")]
         public string QualificationType { get; set; }
         /// <summary>
-        /// Add a subject you would like the applicant to have.
+        /// If `qualificationType` is `BTEC`, you must tell us what level of BTEC you’re looking for.
+        /// </summary>
+        /// <example>7</example>
+        [JsonPropertyName("level")]
+        [AllowedValues(1,2,3,4,5,6,7)]
+        [Required]
+        public int Level { get; set; }
+        /// <summary>
+        /// The name of the subject for the qualification.
         /// </summary>
         [JsonPropertyName("subject")]
         public string Subject { get; set; }
         /// <summary>
-        /// Enter the grade. GCSEs must be in number format 1-9
+        /// The grade for the qualification. GCSEs must include the 1 to 9 grading system.
         /// </summary>
+        /// <example>C or 4</example>
         [JsonPropertyName("grade")]
         public string Grade { get; set; }
         /// <summary>
@@ -374,48 +414,57 @@ public static implicit operator PostCreateVacancyQualificationData(CreateVacancy
         /// </summary>
         [JsonPropertyName("weighting")]
         public QualificationWeighting Weighting { get; set; }
-        /// <summary>
-        /// If qualificationType is BTEC, you must tell us what level of BTEC you’re looking for.
-        /// </summary>
-        [JsonPropertyName("level")]
-        public int? Level { get; set; }
     }
 
     public class SubmitterContactDetails
     {
         /// <summary>
-        /// The name of the person creating the advert
+        /// The name of a contact who applicants can contact to discuss the apprenticeship.
         /// </summary>
+        [JsonPropertyName("name")]
+        [Required]
         public string Name { get; set; }
         /// <summary>
-        /// The email address of the person creating the advert
+        /// The contact's email address.
         /// </summary>
+        [JsonPropertyName("email")]
+        [Required]
         public string Email { get; set; }
         /// <summary>
-        /// The phone number of the person creating the advert
+        /// The contact's phone number.
         /// </summary>
+        [JsonPropertyName("phone")]
+        [Required]
         public string Phone { get; set; }
     }
 
     public class ContractingParties
     {
         /// <summary>
-        /// The UKPRN of the training provider you will be working with for this apprenticeship.
-        /// </summary>
-        [JsonPropertyName("ukprn")]
-        public int Ukprn { get; set; }
-        /// <summary>
-        /// The Account Legal Entity public hashed Id of the organisation that you wish to create the vacancy for. This can be obtained from `GET accountlegalentites`
+        /// The unique identification number for the apprentice’s employer. Use `GET accountlegalentites` to obtain the hashed ID for the employer.
         /// </summary>
         [Required]
         public string AccountLegalEntityPublicHashedId { get; set; }
+        /// <summary>
+        /// The UK provider reference number (UKPRN) for the apprenticeship’s training provider.
+        /// </summary>
+        [JsonPropertyName("ukprn")]
+        public int Ukprn { get; set; }
     }
-    
+
+    /// <summary>
+    /// How much you want an application to have the qualification.
+    /// </summary>
     public enum QualificationWeighting
     {
         Essential,
         Desired
     }
+    /// <summary>
+    /// Choose from:
+    /// <ul><li>`throughFindAnApprenticeship` lets applicants apply through Find an apprenticeship.</li>
+    /// <li>`throughExternalApplicationSite` means you’ll use your own website to accept applications.</li></ul>
+    /// </summary>
     public enum CreateVacancyApplicationMethod
     {
         ThroughFindAnApprenticeship,
@@ -424,33 +473,46 @@ public enum CreateVacancyApplicationMethod
 
     /// <summary>
     /// Choose from:
-    /// `WageType.FixedWage` Allows you to set a wage, but wage must be more than the [National Minimum Wage for apprentices](https://www.gov.uk/national-minimum-wage-rates) for your advert’s closing date.
-    /// `WageType.NationalMinimumWageForApprentices` Sets the wage to the correct [National Minimum Wage for apprentices](https://www.gov.uk/national-minimum-wage-rates) for your advert’s closing date.
-    /// `WageType.NationalMinimumWage` Sets the wage to the correct [National Minimum Wage](https://www.gov.uk/national-minimum-wage-rates) for your advert’s closing date. 
-    /// Note that the National Minimum Wage and National Minimum Wage for apprentices change every 1 April.
+    /// `WageType.NationalMinimumWageForApprentices` sets the wage to the National Minimum Wage for apprentices
+    /// `WageType.NationalMinimumWage` sets the wage to the National Minimum Wage 
+    /// `WageType.FixedWage` lets you set a fixed wage for the apprenticeship
+    /// `WageType.CompetitiveSalary` does not set an exact wage and shows the word ‘Competitive’
+    /// National Minimum Wages will change every year on 1 April. We automatically update adverts to the correct National Minimum Wages.
     /// </summary>
+    /// <example>fixedWage</example>
     public enum WageType
     {
         FixedWage,
         NationalMinimumWageForApprentices,
-        NationalMinimumWage
+        NationalMinimumWage,
+        CompetitiveSalary
     }
     
     /// <summary>
-    /// Used in combination with `Wage.Duration` to specify the length of the apprenticeship. 
+    /// Set the unit of time for `duration`. 
     /// </summary>
     public enum DurationUnit
     {
         Month,
         Year
     }
-    
+    /// <summary>
+    /// Choose how the employer’s company name appears on Find an apprenticeship. Choose from: 
+    /// `registeredName` uses company’s name from the Companies House database (normally in all caps).
+    /// `tradingName` lets you set the company’s name yourself, using `alternativeEmployerName` to correctly format the name.
+    /// `anonymous` hides the company’s name on the vacancy. Note you’ll need to provide `employerDescription` and `anonymousReason`
+    /// </summary>
     public enum EmployerNameOption
     {
         RegisteredName,
         TradingName,
         Anonymous
     }
+    /// <summary>
+    /// Say whether the employer is part of the Department for Work and Pension’s Disability Confident scheme. If Yes:
+    /// <ul><li>we’ll show a Disability Confident logo on the vacancy</li>
+    /// <li>If `applicationMethod` is `throughFindAnApprenticeship`, we'll ask applicants whether they want to apply through the Disability Confident scheme.</li></ul>
+    /// </summary>
     public enum CreateVacancyDisabilityConfident
     {
         No = 0,