Website logo

Update an existing job position

Updates an existing job position

URL: https://api.trademe.co.nz/v1/Jobs/Positions/{positionId}.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

positionId Integer (required)

The id of the position to update
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Query String parameters

dry_run Boolean (optional)

Whether to do a dry run of the update operation. When doing a dry run, no data is updated or saved.

POST Data

<PositionSaveRequest>

Title String (required)

The title of the position
PositionListings Collection of <PositionListingSaveRequest> (optional)

The position listings for the position. When the state is external these will be created as public Trade Me listings. At present you can only have one live position listing per position, and you must provide a position listing to create an external position.
PositionListingId Long Integer (optional)

The id of the position listing, if it already exists. Omit from request if creating a new position listing.
ShortDescription String (optional)

A short description used to differentiate the listing
ReferenceId String (optional)

A reference id to help track the listing
PayAndBenefits String (optional)

A description of the pay and benefits of the position
ContactDetails <PositionListingContactDetailsSave> (optional)

Details for who to contact regarding the listing
ContactName String (optional)

The name of the person to contact regarding the listing
PreferredApplicationMethod String (optional)

The preferred way for applicants to apply
EmailAddress String (optional)

The email address of the person to contact regarding the listing
ApplicationUrl String (optional)

The url to send applicants to if using an off site application method
PhoneNumbers Collection of <PhoneNumberDetails> (optional)

Phone numbers of people to contact regarding the listing
Prefix String (optional)

The prefix of the phone number
Number String (optional)

The rest of the phone number
Descriptions Collection of <PositionListingDescription> (optional)

The descriptions of the position listing
Type String (optional)

The type of the description
Text String (optional)

The text of the description
Promotions <PositionListingPromotionSave> (optional)

The promotions for the position listing
BundleType Enumeration (optional)

The type of promotion bundle
None 0

None
Bronze 1

Bronze
Silver 2

Silver
Gold 3

Gold
Platinum 4

Platinum
Fifth 5

Fifth
Sixth 6

Sixth
PromotionData <PromotionDataSave> (optional)

The data required for the promotion bundle
Branding Collection of <PositionBrandingItemSave> (optional)

The branding for the position listing
BrandingId Long Integer (required)

The id of the branding item
BrandingType String (required)

The type of the branding item: Logo or Banner
BulletPoints Collection of String (optional)

The bullet points for the featured position listing
EnabledPromotions Collection of Enumeration (optional)

The promotions that apply to the position listing
Featured 1

Position listing is featured
Branded 2

Position listing is branded
SevenDayListing 3

Position listing is a seven day listing
BulletPoints 4

Position listing can have bullet points
CandidateDatabaseAccess 5

Candidate database access granted
Photos 6

Position listing can have photos
Video 7

Position listing can have videos
PromotedListing 8

Position listing can have promoted listing
PhotoIds Collection of Long Integer (optional)

The list of photo IDs to be displayed with the position
VideoKey String (optional)

The id of the video to be displayed with the position. Only YouTube video ids are supported.
SalaryOptIn Boolean (optional)

Indicates if the advertiser has opted in to display salary data in LDP/SRP.
PositionCompanyName String (optional)

The name of the company where the position is vacant
CategoryIds Collection of Integer (optional)

The IDs of the categories for the position. Currently only one category ID is supported.
PayType String (optional)

Indicates the type of pay for the position. e.g. Hourly or salary
PayMin Number (optional)

The minimum pay for the position.
PayMax Number (optional)

The maximum pay for the position.
EmploymentDurationType String (optional)

Indicates the type of duration for the position
EmploymentType String (optional)

Indicates the type of employment for the position
Locations Collection of <PositionLocation> (optional)

The locations of the position
DistrictId Integer (optional)

The district id of the location
PublishedState String (required)

The published state for the position: Draft or External
IsEntryLevel Boolean (optional)

Indicates whether this is an entry level position
IsWorkFromHome Boolean (optional)

Indicates whether working from home is available for this position
DraftId String (optional)

The draft id (guid) from job smart (if present)

Returns

<PositionSaveResponse>

Information about the update of the position

Position <Position> or null

The details of the saved position. Is not present during a dry run as nothing is saved.
PositionId Long Integer

The id of the position
PublishedState String or null

The published state of the position
Title String or null

The title of the position
DateCreated DateTime

The date the position was created
DateModified DateTime

The date the position was modified
DateArchived DateTime or null

The date the position was archived
HasLiveListing Boolean

Whether the position has any live listings
Listings Collection of <PositionListingDetails> or null

The listings for the position
PositionListingId Long Integer

The id of the listing
ListingId Long Integer or null

The id of the listing
StartDate DateTime or null

The start date of the listing
EndDate DateTime or null

The end date of the listing
IsLive Boolean

Whether the listing is live
IsAccessible Boolean

Whether the listing is accessible
ShortDescription String or null

A short description used to differentiate the listing
ReferenceId String or null

A reference id to help track the listing
PayAndBenefits String or null

A description of the pay and benefits of the position
ContactDetails <PositionListingContactDetails> or null

Details for who to contact regarding the listing
ContactName String or null

The name of the person to contact regarding the listing
PreferredApplicationMethod String or null

The preferred way for applicants to apply
EmailAddress String or null

The email address of the person to contact regarding the listing
ApplicationUrl String or null

The url to send applicants to if using an off site application method
PhoneNumbers Collection of <PhoneNumberDetails> or null

Phone numbers of people to contact regarding the listing
Prefix String or null

The prefix of the phone number
Number String or null

The rest of the phone number
Descriptions Collection of <PositionListingDescription> or null

The descriptions of the position listing
Type String or null

The type of the description
Text String or null

The text of the description
Promotions <PositionListingPromotion> or null

The promotions of the position listing
BundleType Enumeration

The type of promotion bundle
None 0

None
Bronze 1

Bronze
Silver 2

Silver
Gold 3

Gold
Platinum 4

Platinum
Fifth 5

Fifth
Sixth 6

Sixth
PromotionData <PromotionData> or null

The data required for the promotion bundle
Branding Collection of <PromotionBrandingItem> or null

The branding for the position listing
BrandingId Long Integer

The id of the branding item
BrandingType String or null

The type of the branding item: Logo or Banner
BrandingUri String or null

The uri for the branding image
IsDeleted Boolean

Whether the branding is deleted
BulletPoints Collection of String or null

The bullet points for the featured position listing
CandidateAccessQuota Integer or null

The available quota for profile unlocks in the candidate database
EnabledPromotions Collection of Enumeration or null

The promotions that apply to the position listing
Featured 1

Position listing is featured
Branded 2

Position listing is branded
SevenDayListing 3

Position listing is a seven day listing
BulletPoints 4

Position listing can have bullet points
CandidateDatabaseAccess 5

Candidate database access granted
Photos 6

Position listing can have photos
Video 7

Position listing can have videos
PromotedListing 8

Position listing can have promoted listing
PhotoIds Collection of Long Integer or null

The photo IDs of the position listing
PhotoDetails Collection of <PositionListingPhotoDetail> or null

A collection of photos for the listing. This collection is read-only.
PhotoId Long Integer

The id of the photo
Urls <PositionListingPhotoUrls> or null

All the photo urls for different sized versions of the photo.
Thumbnail String or null

The URL for the thumbnail sized photo (always 85x64, with white borders).
List String or null

The URL for the list view sized photo (scaled down to fit 160x120).
Medium String or null

The URL for the medium sized photo (scaled down to fit 175x175).
Gallery String or null

The URL for the gallery sized photo (scaled down to fit 233x176).
Large String or null

The URL for the large sized photo (scaled down to fit 352x264).
FullSize String or null

The URL for the full sized photo (scaled down to fit 670x502).
PlusSize String or null

The URL for the plus sized photo (scaled down to fit).
TransformData <PositionListingPhotoTransformData> or null

The transform information if the photo was transformed. Null otherwise.
SourcePhotoDetails <PositionListingSourcePhotoDetails> or null

Details of the original source photo used for the transformation.
PhotoId Long Integer

The id of the original source photo used for the transformation.
Urls <PositionListingPhotoUrls> or null

The photo urls for different sized versions of the source photo.
(This type has already been defined)
Dimensions <PositionListingPhotoDimensions> or null

The dimensions of the source photo.
Width Integer

The width of the photo in pixels.
Height Integer

The height of the photo in pixels.
Rotation Integer

The number of degrees the original was rotated clockwise.
Crop <BoundingBox> or null

The bounding box of where the original photo was cropped.
Min <BoundingPoint> or null

A point representing the top left of the bounding box
X Integer

The point on the X axis
Y Integer

The point on the Y axis
Max <BoundingPoint> or null

A point representing the bottom left of the bounding box
(This type has already been defined)
Dimensions <PositionListingPhotoDimensions> or null

The dimensions of the photo. If the photo has been transformed (eg. cropped or rotated), it will be the transformed photo dimensions.
(This type has already been defined)
Video <PositionListingVideoDetails> or null

Details of the video for the listing.
VideoKey String or null

The id of the video
Thumbnails Collection of <PositionListingVideoThumbnail> or null

Thumbnails for the video.
Url String or null

The url of the thumbnail
Size String or null

The size of the thumbnail. Possible values are "Index", "Medium" and "High".
Width Integer or null

The width of the thumbnail
Height Integer or null

The height of the thumbnail
SalaryOptIn Boolean

Indicates if the advertiser has opted in to display salary data in LDP/SRP.
OwnerCompanyId Long Integer

The id of the company who owns the position
PositionCompanyName String or null

The name of the company where the position is vacant
CategoryIds Collection of Integer or null

The IDs of the categories for the position
PayType String or null

Indicates the type of pay for the position. e.g. Hourly or salary
PayMin Number or null

The minimum pay for the position
PayMax Number or null

The maximum pay for the position
EmploymentDurationType String or null

Indicates the type of duration for the position
EmploymentType String or null

Indicates the type of employment for the position
Self <Link> or null

A link to retrieve this position resource
Href String or null

An HREF representing the uri to the resource
Rel String or null

A REL representing the relationship between the sending resource and the linked resource
Prompt String or null

A PROMPT, optional display text to represent the resource to a user
Method String or null

A METHOD, optional field to represent the HTTP method/verb to use. If not provided, default to GET.
Locations Collection of <PositionLocation> or null

The locations of the position
DistrictId Integer or null

The district id of the location
IsEntryLevel Boolean

Indicates whether this is an entry level position
IsWorkFromHome Boolean

Indicates whether working from home is available for this position
FeeSummary <FeeSummary> or null

The details of the fees to create a position and listing
TotalCost Number

The total price for the position.
TotalCostGstExcluded Number

The total price for the position excluding GST.
InsufficientBalance Boolean

Indicates the member has insufficient funds to pay the total price for the position.
MinimumRequiredTopUpAmount Number or null

The minimum top up amount required in order to pay for this position
FeeItems Collection of <FeeItem> or null

A collection of fee items.
Type String or null

The transaction type.
Amount Number

The amount that will be charged
AmountGstExcluded Number

The amount excluding GST
WillBeInvoiced Boolean

Indicates whether this fee item will be invoiced, rather than deducted from the member's trade me balance.
ProvidingSource <FeeItemProvidingSource> or null

The providing source for this item when the member doesn't have to pay for it
Name String or null

The name of the providing source.
Remaining Integer

The number of items remaining in this source, or 0 if the source is unlimited.
IsUnlimited Boolean

True if it is possible to create unlimited listings at the provided rate

Example XML Request (switch to JSON) 

<PositionSaveRequest xmlns="http://api.trademe.co.nz/v1">
  <Title>ABC</Title>
  <PositionListings>
    <PositionListingSaveRequest>
      <PositionListingId>123</PositionListingId>
      <ShortDescription>ABC</ShortDescription>
      <ReferenceId>ABC</ReferenceId>
      <PayAndBenefits>ABC</PayAndBenefits>
      <ContactDetails>
        <ContactName>ABC</ContactName>
        <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
        <EmailAddress>ABC</EmailAddress>
        <ApplicationUrl>ABC</ApplicationUrl>
        <PhoneNumbers>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
        </PhoneNumbers>
      </ContactDetails>
      <Descriptions>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
      </Descriptions>
      <Promotions>
        <BundleType>None</BundleType>
        <PromotionData>
          <Branding>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
          </Branding>
          <BulletPoints>
            <string>ABC</string>
            <string>ABC</string>
          </BulletPoints>
        </PromotionData>
        <EnabledPromotions>
          <PromotionType>Featured</PromotionType>
          <PromotionType>Featured</PromotionType>
        </EnabledPromotions>
      </Promotions>
      <PhotoIds>
        <long>123</long>
        <long>123</long>
      </PhotoIds>
      <VideoKey>ABC</VideoKey>
      <SalaryOptIn>false</SalaryOptIn>
    </PositionListingSaveRequest>
    <PositionListingSaveRequest>
      <PositionListingId>123</PositionListingId>
      <ShortDescription>ABC</ShortDescription>
      <ReferenceId>ABC</ReferenceId>
      <PayAndBenefits>ABC</PayAndBenefits>
      <ContactDetails>
        <ContactName>ABC</ContactName>
        <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
        <EmailAddress>ABC</EmailAddress>
        <ApplicationUrl>ABC</ApplicationUrl>
        <PhoneNumbers>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
        </PhoneNumbers>
      </ContactDetails>
      <Descriptions>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
      </Descriptions>
      <Promotions>
        <BundleType>None</BundleType>
        <PromotionData>
          <Branding>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
          </Branding>
          <BulletPoints>
            <string>ABC</string>
            <string>ABC</string>
          </BulletPoints>
        </PromotionData>
        <EnabledPromotions>
          <PromotionType>Featured</PromotionType>
          <PromotionType>Featured</PromotionType>
        </EnabledPromotions>
      </Promotions>
      <PhotoIds>
        <long>123</long>
        <long>123</long>
      </PhotoIds>
      <VideoKey>ABC</VideoKey>
      <SalaryOptIn>false</SalaryOptIn>
    </PositionListingSaveRequest>
  </PositionListings>
  <PositionCompanyName>ABC</PositionCompanyName>
  <CategoryIds>
    <int>123</int>
    <int>123</int>
  </CategoryIds>
  <PayType>ABC</PayType>
  <PayMin>123.0</PayMin>
  <PayMax>123.0</PayMax>
  <EmploymentDurationType>ABC</EmploymentDurationType>
  <EmploymentType>ABC</EmploymentType>
  <Locations>
    <PositionLocation>
      <DistrictId>123</DistrictId>
    </PositionLocation>
    <PositionLocation>
      <DistrictId>123</DistrictId>
    </PositionLocation>
  </Locations>
  <PublishedState>ABC</PublishedState>
  <IsEntryLevel>false</IsEntryLevel>
  <IsWorkFromHome>false</IsWorkFromHome>
  <DraftId>ABC</DraftId>
</PositionSaveRequest>

Example JSON Request (switch to XML) 

{
  "Title": "ABC",
  "PositionListings": [
    {
      "PositionListingId": 123,
      "ShortDescription": "ABC",
      "ReferenceId": "ABC",
      "PayAndBenefits": "ABC",
      "ContactDetails": {
        "ContactName": "ABC",
        "PreferredApplicationMethod": "ABC",
        "EmailAddress": "ABC",
        "ApplicationUrl": "ABC",
        "PhoneNumbers": [
          {
            "Prefix": "ABC",
            "Number": "ABC"
          },
          {
            "Prefix": "ABC",
            "Number": "ABC"
          }
        ]
      },
      "Descriptions": [
        {
          "Type": "ABC",
          "Text": "ABC"
        },
        {
          "Type": "ABC",
          "Text": "ABC"
        }
      ],
      "Promotions": {
        "BundleType": 0,
        "PromotionData": {
          "Branding": [
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            },
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            }
          ],
          "BulletPoints": [
            "ABC",
            "ABC"
          ]
        },
        "EnabledPromotions": [
          1,
          1
        ]
      },
      "PhotoIds": [
        123,
        123
      ],
      "VideoKey": "ABC",
      "SalaryOptIn": false
    },
    {
      "PositionListingId": 123,
      "ShortDescription": "ABC",
      "ReferenceId": "ABC",
      "PayAndBenefits": "ABC",
      "ContactDetails": {
        "ContactName": "ABC",
        "PreferredApplicationMethod": "ABC",
        "EmailAddress": "ABC",
        "ApplicationUrl": "ABC",
        "PhoneNumbers": [
          {
            "Prefix": "ABC",
            "Number": "ABC"
          },
          {
            "Prefix": "ABC",
            "Number": "ABC"
          }
        ]
      },
      "Descriptions": [
        {
          "Type": "ABC",
          "Text": "ABC"
        },
        {
          "Type": "ABC",
          "Text": "ABC"
        }
      ],
      "Promotions": {
        "BundleType": 0,
        "PromotionData": {
          "Branding": [
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            },
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            }
          ],
          "BulletPoints": [
            "ABC",
            "ABC"
          ]
        },
        "EnabledPromotions": [
          1,
          1
        ]
      },
      "PhotoIds": [
        123,
        123
      ],
      "VideoKey": "ABC",
      "SalaryOptIn": false
    }
  ],
  "PositionCompanyName": "ABC",
  "CategoryIds": [
    123,
    123
  ],
  "PayType": "ABC",
  "PayMin": 123.0,
  "PayMax": 123.0,
  "EmploymentDurationType": "ABC",
  "EmploymentType": "ABC",
  "Locations": [
    {
      "DistrictId": 123
    },
    {
      "DistrictId": 123
    }
  ],
  "PublishedState": "ABC",
  "IsEntryLevel": false,
  "IsWorkFromHome": false,
  "DraftId": "ABC"
}

Example XML Response (switch to JSON) 

<PositionSaveResponse xmlns="http://api.trademe.co.nz/v1">
  <Position>
    <PositionId>123</PositionId>
    <PublishedState>ABC</PublishedState>
    <Title>ABC</Title>
    <DateCreated>2018-01-01T00:00:00Z</DateCreated>
    <DateModified>2018-01-01T00:00:00Z</DateModified>
    <DateArchived>2018-01-01T00:00:00Z</DateArchived>
    <HasLiveListing>false</HasLiveListing>
    <Listings>
      <PositionListingDetails>
        <PositionListingId>123</PositionListingId>
        <ListingId>123</ListingId>
        <StartDate>2018-01-01T00:00:00Z</StartDate>
        <EndDate>2018-01-01T00:00:00Z</EndDate>
        <IsLive>false</IsLive>
        <IsAccessible>false</IsAccessible>
        <ShortDescription>ABC</ShortDescription>
        <ReferenceId>ABC</ReferenceId>
        <PayAndBenefits>ABC</PayAndBenefits>
        <ContactDetails>
          <ContactName>ABC</ContactName>
          <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
          <EmailAddress>ABC</EmailAddress>
          <ApplicationUrl>ABC</ApplicationUrl>
          <PhoneNumbers>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
          </PhoneNumbers>
        </ContactDetails>
        <Descriptions>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
        </Descriptions>
        <Promotions>
          <BundleType>None</BundleType>
          <PromotionData>
            <Branding>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
            </Branding>
            <BulletPoints>
              <string>ABC</string>
              <string>ABC</string>
            </BulletPoints>
            <CandidateAccessQuota>123</CandidateAccessQuota>
          </PromotionData>
          <EnabledPromotions>
            <PromotionType>Featured</PromotionType>
            <PromotionType>Featured</PromotionType>
          </EnabledPromotions>
        </Promotions>
        <PhotoIds>
          <long>123</long>
          <long>123</long>
        </PhotoIds>
        <PhotoDetails>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
        </PhotoDetails>
        <Video>
          <VideoKey>ABC</VideoKey>
          <Thumbnails>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
          </Thumbnails>
        </Video>
        <SalaryOptIn>false</SalaryOptIn>
      </PositionListingDetails>
      <PositionListingDetails>
        <PositionListingId>123</PositionListingId>
        <ListingId>123</ListingId>
        <StartDate>2018-01-01T00:00:00Z</StartDate>
        <EndDate>2018-01-01T00:00:00Z</EndDate>
        <IsLive>false</IsLive>
        <IsAccessible>false</IsAccessible>
        <ShortDescription>ABC</ShortDescription>
        <ReferenceId>ABC</ReferenceId>
        <PayAndBenefits>ABC</PayAndBenefits>
        <ContactDetails>
          <ContactName>ABC</ContactName>
          <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
          <EmailAddress>ABC</EmailAddress>
          <ApplicationUrl>ABC</ApplicationUrl>
          <PhoneNumbers>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
          </PhoneNumbers>
        </ContactDetails>
        <Descriptions>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
        </Descriptions>
        <Promotions>
          <BundleType>None</BundleType>
          <PromotionData>
            <Branding>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
            </Branding>
            <BulletPoints>
              <string>ABC</string>
              <string>ABC</string>
            </BulletPoints>
            <CandidateAccessQuota>123</CandidateAccessQuota>
          </PromotionData>
          <EnabledPromotions>
            <PromotionType>Featured</PromotionType>
            <PromotionType>Featured</PromotionType>
          </EnabledPromotions>
        </Promotions>
        <PhotoIds>
          <long>123</long>
          <long>123</long>
        </PhotoIds>
        <PhotoDetails>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
        </PhotoDetails>
        <Video>
          <VideoKey>ABC</VideoKey>
          <Thumbnails>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
          </Thumbnails>
        </Video>
        <SalaryOptIn>false</SalaryOptIn>
      </PositionListingDetails>
    </Listings>
    <OwnerCompanyId>123</OwnerCompanyId>
    <PositionCompanyName>ABC</PositionCompanyName>
    <CategoryIds>
      <int>123</int>
      <int>123</int>
    </CategoryIds>
    <PayType>ABC</PayType>
    <PayMin>123.0</PayMin>
    <PayMax>123.0</PayMax>
    <EmploymentDurationType>ABC</EmploymentDurationType>
    <EmploymentType>ABC</EmploymentType>
    <Self>
      <Href>ABC</Href>
      <Rel>ABC</Rel>
      <Prompt>ABC</Prompt>
      <Method>ABC</Method>
    </Self>
    <Locations>
      <PositionLocation>
        <DistrictId>123</DistrictId>
      </PositionLocation>
      <PositionLocation>
        <DistrictId>123</DistrictId>
      </PositionLocation>
    </Locations>
    <IsEntryLevel>false</IsEntryLevel>
    <IsWorkFromHome>false</IsWorkFromHome>
  </Position>
  <FeeSummary>
    <TotalCost>123.0</TotalCost>
    <TotalCostGstExcluded>123.0</TotalCostGstExcluded>
    <InsufficientBalance>false</InsufficientBalance>
    <MinimumRequiredTopUpAmount>123.0</MinimumRequiredTopUpAmount>
    <FeeItems>
      <FeeItem>
        <Type>ABC</Type>
        <Amount>123.0</Amount>
        <AmountGstExcluded>123.0</AmountGstExcluded>
        <WillBeInvoiced>false</WillBeInvoiced>
        <ProvidingSource>
          <Name>ABC</Name>
          <Remaining>123</Remaining>
          <IsUnlimited>false</IsUnlimited>
        </ProvidingSource>
      </FeeItem>
      <FeeItem>
        <Type>ABC</Type>
        <Amount>123.0</Amount>
        <AmountGstExcluded>123.0</AmountGstExcluded>
        <WillBeInvoiced>false</WillBeInvoiced>
        <ProvidingSource>
          <Name>ABC</Name>
          <Remaining>123</Remaining>
          <IsUnlimited>false</IsUnlimited>
        </ProvidingSource>
      </FeeItem>
    </FeeItems>
  </FeeSummary>
</PositionSaveResponse>

Example JSON Response (switch to XML) 

{
  "Position": {
    "PositionId": 123,
    "PublishedState": "ABC",
    "Title": "ABC",
    "DateCreated": "\/Date(1514764800)\/",
    "DateModified": "\/Date(1514764800)\/",
    "DateArchived": "\/Date(1514764800)\/",
    "HasLiveListing": false,
    "Listings": [
      {
        "PositionListingId": 123,
        "ListingId": 123,
        "StartDate": "\/Date(1514764800)\/",
        "EndDate": "\/Date(1514764800)\/",
        "IsLive": false,
        "IsAccessible": false,
        "ShortDescription": "ABC",
        "ReferenceId": "ABC",
        "PayAndBenefits": "ABC",
        "ContactDetails": {
          "ContactName": "ABC",
          "PreferredApplicationMethod": "ABC",
          "EmailAddress": "ABC",
          "ApplicationUrl": "ABC",
          "PhoneNumbers": [
            {
              "Prefix": "ABC",
              "Number": "ABC"
            },
            {
              "Prefix": "ABC",
              "Number": "ABC"
            }
          ]
        },
        "Descriptions": [
          {
            "Type": "ABC",
            "Text": "ABC"
          },
          {
            "Type": "ABC",
            "Text": "ABC"
          }
        ],
        "Promotions": {
          "BundleType": 0,
          "PromotionData": {
            "Branding": [
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              },
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              }
            ],
            "BulletPoints": [
              "ABC",
              "ABC"
            ],
            "CandidateAccessQuota": 123
          },
          "EnabledPromotions": [
            1,
            1
          ]
        },
        "PhotoIds": [
          123,
          123
        ],
        "PhotoDetails": [
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          },
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          }
        ],
        "Video": {
          "VideoKey": "ABC",
          "Thumbnails": [
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            },
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            }
          ]
        },
        "SalaryOptIn": false
      },
      {
        "PositionListingId": 123,
        "ListingId": 123,
        "StartDate": "\/Date(1514764800)\/",
        "EndDate": "\/Date(1514764800)\/",
        "IsLive": false,
        "IsAccessible": false,
        "ShortDescription": "ABC",
        "ReferenceId": "ABC",
        "PayAndBenefits": "ABC",
        "ContactDetails": {
          "ContactName": "ABC",
          "PreferredApplicationMethod": "ABC",
          "EmailAddress": "ABC",
          "ApplicationUrl": "ABC",
          "PhoneNumbers": [
            {
              "Prefix": "ABC",
              "Number": "ABC"
            },
            {
              "Prefix": "ABC",
              "Number": "ABC"
            }
          ]
        },
        "Descriptions": [
          {
            "Type": "ABC",
            "Text": "ABC"
          },
          {
            "Type": "ABC",
            "Text": "ABC"
          }
        ],
        "Promotions": {
          "BundleType": 0,
          "PromotionData": {
            "Branding": [
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              },
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              }
            ],
            "BulletPoints": [
              "ABC",
              "ABC"
            ],
            "CandidateAccessQuota": 123
          },
          "EnabledPromotions": [
            1,
            1
          ]
        },
        "PhotoIds": [
          123,
          123
        ],
        "PhotoDetails": [
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          },
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          }
        ],
        "Video": {
          "VideoKey": "ABC",
          "Thumbnails": [
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            },
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            }
          ]
        },
        "SalaryOptIn": false
      }
    ],
    "OwnerCompanyId": 123,
    "PositionCompanyName": "ABC",
    "CategoryIds": [
      123,
      123
    ],
    "PayType": "ABC",
    "PayMin": 123.0,
    "PayMax": 123.0,
    "EmploymentDurationType": "ABC",
    "EmploymentType": "ABC",
    "Self": {
      "Href": "ABC",
      "Rel": "ABC",
      "Prompt": "ABC",
      "Method": "ABC"
    },
    "Locations": [
      {
        "DistrictId": 123
      },
      {
        "DistrictId": 123
      }
    ],
    "IsEntryLevel": false,
    "IsWorkFromHome": false
  },
  "FeeSummary": {
    "TotalCost": 123.0,
    "TotalCostGstExcluded": 123.0,
    "InsufficientBalance": false,
    "MinimumRequiredTopUpAmount": 123.0,
    "FeeItems": [
      {
        "Type": "ABC",
        "Amount": 123.0,
        "AmountGstExcluded": 123.0,
        "WillBeInvoiced": false,
        "ProvidingSource": {
          "Name": "ABC",
          "Remaining": 123,
          "IsUnlimited": false
        }
      },
      {
        "Type": "ABC",
        "Amount": 123.0,
        "AmountGstExcluded": 123.0,
        "WillBeInvoiced": false,
        "ProvidingSource": {
          "Name": "ABC",
          "Remaining": 123,
          "IsUnlimited": false
        }
      }
    ]
  }
}