Jobs

Get VMS Jobs by VMS ID

Returns details about the VMS jobs associated with the specified VMS ID.

get/v1/job/vms-jobs/{vmsId}

Request

  • Base URL
    https://api.avionte.com/front-office
  • URL
    https://api.avionte.com/front-office/v1/job/vms-jobs/{vmsId}
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

vmsIdstring nullable required

The job identifier from the external VMS system.

Headers

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

RequestIdstring uuid

Unique request identifier in UUID format used to correlate request data to log entries and events.

Example:63680b86-c7e0-4a36-ae4a-d0d481089aff

Unique request identifier (UUID) used to correlate request data with log entries and events.

Response

An array of VMS Jobs for the requested VMS ID.

vmsJobIdinteger

The VMS job identifier.

vmsIdstring nullable

The VMS identifier (external system identifier).

jobIdinteger nullable

The Bold job identifier, if the VMS job has been actioned.

vmsCompanystring nullable

The VMS company name.

titlestring nullable

The job title.

statusstring nullable

The job status name.

positionsinteger

The number of positions available.

startDatestring date-time

The job start date. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T00:00:00.

endDatestring date-time

The job end date. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T00:00:00.

vmsNotesstring nullable

Notes related to the VMS job.

vmsNamestring nullable

The VMS name (e.g., "SimpleVMS", "JobRobotix").

vendorIdinteger nullable

The vendor identifier.

Changes

No recorded changes to this operation across all 1 revision of this API.