> ## Documentation Index > Fetch the complete documentation index at: https://docs.tread.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Device Status for Job > Get GPS data and other data like device permissions for a Job. Requires job authorization. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/companies/{company-id}/jobs/{job-id}/device_status openapi: 3.0.3 info: title: Horizon API V1 version: '1.0' contact: name: Tread url: https://tread.io email: developers@tread.io description: >- This is the Version 1 implementation. When in doubt we default to the practices outlined [here](https://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api#advanced-queries) license: name: Private url: https://tread.io servers: - description: production url: https://api.tread-horizon.com security: - bearerAuth: [] tags: - name: Projects - name: Orders - name: Loads - name: Jobs - name: JobAssignments - name: ApprovalAssignments - name: Equipment - name: FuelSurcharges - name: Materials - name: Accounts - name: Tickets - name: Users - name: Sites - name: Companies - name: Departments - name: Rates - name: Services - name: EquipmentType - name: FileAttachments - name: MaterialType - name: LineItemType - name: DriverStateEvent - name: Authentication - name: IamRoles - name: Typeaheads - name: Integrations - name: Reflection - name: LoadCycles - name: AddOns - name: ServiceClass - name: Invoices - name: JobSummaries - name: LoadSummaries - name: CompanyShares - name: UserDevicePermission - name: Drivers - name: Settlements - name: LocationHistories - name: Telematics - name: OmniReports - name: DriverDays - name: Agave - name: AddOnCharges - name: ResourceUsageLogs - name: ResourceScopes - name: TravelledDistances - name: MaterialRates - name: CompanyDayJobStats - name: KMLFiles - name: AutoAddOnAssignments - name: SiteRateSchedules - name: TwilioIntegrations - name: Foremen - name: AccountExternalTruckIdentifier - name: GeofenceTriggers - name: Labels - name: Compliance - name: ComplianceDocuments paths: /v1/companies/{company-id}/jobs/{job-id}/device_status: parameters: - schema: type: string name: job-id in: path required: true description: Job ID - schema: type: string name: company-id in: path required: true description: Company ID - $ref: '#/components/parameters/Accept-Language' get: tags: - Jobs summary: Get Device Status for Job description: >- Get GPS data and other data like device permissions for a Job. Requires job authorization. operationId: get-v1-companies-company-id-jobs-job-id-device_status responses: '200': description: OK content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DeviceStatus' required: - data '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/UnauthenticatedError' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '406': $ref: '#/components/responses/Error' components: parameters: Accept-Language: name: Accept-Language in: header schema: type: string default: en example: en description: >- The Accept-Language request HTTP header indicates the natural language and locale that the client prefers. schemas: DeviceStatus: title: DeviceStatus x-stoplight: id: 1bzyq4ijbjbtt example: offline default: no_signal description: >- Telematic and other status data about a hardware device. The `user_device_permissions` values are not return for telematics hardware. allOf: - type: object properties: user_device_permissions: type: array x-stoplight: id: gn07hocr0lntq items: $ref: '#/components/schemas/UserDevicePermission-Read-Nested' - $ref: '#/components/schemas/GpsStatusable' UserDevicePermission-Read-Nested: title: UserDevicePermission-Read-Nested x-stoplight: id: e3jx6upc31ms7 type: object description: An individual permission and current state required: - device_permission - device_permission_state properties: device_permission: $ref: '#/components/schemas/DevicePermission' device_permission_state: $ref: '#/components/schemas/DevicePermissionState' additionalProperties: false GpsStatusable: title: GpsStatusable x-stoplight: id: o6oprcupw6ep7 type: object required: - gps_status properties: gps_status: $ref: '#/components/schemas/GpsStatus' additionalProperties: false Error-Response: title: Error-Response x-stoplight: id: 52cydhphee3qe type: object required: - error properties: error: $ref: '#/components/schemas/Error' additionalProperties: false UnauthenticatedError-Response: title: UnauthenticatedError-Response x-stoplight: id: o477eph7ttbzt type: object required: - error properties: error: $ref: '#/components/schemas/UnauthenticatedError' additionalProperties: false DevicePermission: title: DevicePermission x-stoplight: id: fog1bzwo59bxy description: These are the list of permissions an app user can set enum: - location_while_using - location_always - notifications - motion_and_fitness - physical_activity - ignore_battery_optimizations - background_refresh DevicePermissionState: title: DevicePermissionState x-stoplight: id: 3c1p4ft9qi1uj description: These are the list of permission states a permission can have enum: - denied - granted - restricted - limited - permanently_denied - provisional GpsStatus: title: GpsStatus x-stoplight: id: 3b02180lfd6ve description: GPS Ping status for a record type: object required: - status - last_ping_at properties: status: x-stoplight: id: 7f6aqydupq3ac enum: - online - offline - idle - no_signal last_ping_at: type: string x-stoplight: id: 1ikh7blmxdqcz format: date-time nullable: true additionalProperties: false Error: title: Error x-stoplight: id: 3g57kkik3l464 type: object description: An Error. required: - code properties: code: type: string x-stoplight: id: 7o9x1t8v0bgfo additionalProperties: false UnauthenticatedError: title: UnauthenticatedError x-stoplight: id: 202o69l0fs40h allOf: - $ref: '#/components/schemas/Error' - type: object x-stoplight: id: tg10dt7s0l6bw properties: error_type: type: string x-stoplight: id: wvq8c0qsym4hz required: - error_type responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/Error-Response' type: object UnauthenticatedError: description: Example response content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedError-Response' type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````