Get job

Job can be retrieved by uuid or external_id.

Get job using uuid
$ curl -H "Authorization: Bearer api-key" \
       https://api.planadoapp.com/v2/jobs/cb4b2ede-114f-4c55-9118-0b62f8182403 | jq
{
  "job": {
    "uuid": "cb4b2ede-114f-4c55-9118-0b62f8182403",
    "external_id": null,
    "external_order_id": null,
    "serial_no": 22461,
    "status": "started",
    "scheduled_at": "2015-01-19T20:00:00.000Z",
    "scheduled_duration": {
      "minutes": 60
    },
    "template": {
      "uuid": "2bb9f66f-082c-4bfd-b806-e777d483c769",
      "name": "Network diagnostic"
    },
    "client": {
      "uuid": "50c773b3-a4f8-5619-be47-cb6a0edb22cc",
      "external_id": "423430387320568-acme"
    },
    "site": {
      "uuid": "dc62cfdf-f9f1-59ec-80bd-ff5da151e515",
      "external_id": "kelheimer-6"
    },
    "type": {
      "uuid": "8d5f2415-fce3-45a6-b417-ad939a63f70d",
      "code": "Diagnostic"
    },
    "timestamps": {
      "en_route_at": "2015-01-19T20:35:04.617Z",
      "started_at": "2015-01-19T21:02:04.617Z",
      "suspended_at": null,
      "finished_at": null,
    },
    "assignee": {
      "worker": {
        "uuid": "8ebd12cc-b2d9-407c-a4f4-5943263d54a4",
        "email": "john@doe"
      }
    },
    "skills": [
      {
        "uuid": "8d486972-28de-4216-8957-bbfffe0a8d77",
        "name": "Installation"
      },
      {
        "uuid": "173ab190-acf0-42e5-aa4e-4beecd941137",
        "name": "Diagnostic"
      }
    ],
    "territory": {
      "uuid": "d528336e-c310-4485-a80f-580b3b4cb6f1",
      "name": "Manhattan"
    },
    "description": "Chuck Norris threw a grenade and killed 50 people, then it exploded.",
    "address": {
      "formatted": "Kelheimer Str. 6, 10777 Berlin, Germany",
      "entrance_no": null,
      "apartment": null,
      "floor": "3",
      "description": null,
      "geolocation": {
        "longitude": 13.3363265,
        "latitude": 52.4984896
      }
    },
    "contacts": [
      {
        "name": "Herr Karl",
        "value": "0179-1234567",
        "type": "phone"
      }
    ],
    "possible_resolutions": [
      {
        "uuid": "f74c80bd-e21c-4d11-a036-84126004088b",
        "name": "Success"
      },
      {
        "uuid": "19b30c02-371f-4da7-a24f-cf0dd840b793",
        "name": "Failure"
      }
    ],
    "custom_fields": [
      {
        "uuid": "137e2ad5-8d02-6360-d77f-6a19c8f707ca",
        "name": "Instructions",
        "field_type": "file",
        "data_type": "attachment",
        "required": false,
        "value": "https://www.cs.virginia.edu/~robins/Turing_Paper_1936.pdf"
      },
      {
        "uuid": "137e2ad5-8d2e-6a00-d77f-6a19c8f707ca",
        "name": "Order #",
        "field_type": "input",
        "data_type": "string",
        "required": true,
        "value": "IO-42-1862/11/2015"
      },
      {
        "uuid": "137e81d2-c3e3-6b20-78b2-2e6e183cc868",
        "name": "Diagnostic type",
        "field_type": "dictionary",
        "data_type": "dictionary",
        "required": true,
        "dictionary": {
          "uuid": "0bd6395c-1668-4cf2-bdab-1cde5d3eecd9",
          "name": "Diagnostic type"
        }
      }
    ],
    "report_fields": [
      {
        "uuid": "a3d0136f-db10-4b70-a092-d27841c94345",
        "name": "Greetings",
        "field_type": "action",
        "data_type": "boolean",
        "required": true,
        "value": true,
        "filled_at": "2015-11-20T14:12:03Z"
      },
      {
        "uuid": "137e9b14-9ca2-64a0-b9b6-5eb27cb176c4",
        "name": "Photo of issue",
        "field_type": "file",
        "data_type": "image",
        "required": true,
        "pending_files": 0,
        "value": [
          "https://previews.123rf.com/images/rottenman/rottenman1303/rottenman130300014/18519536-broken-cable-isolated-on-white.jpg",
          "https://blog.apnic.net/wp-content/uploads/2018/07/damagedfibreoptic-header-555x202.jpg?v=845dd091246c794f108761aec0e9e7bc"
        ],
        "filled_at": "2015-11-20T14:12:03Z"
      },
      {
        "uuid": "a3d0136f-db10-4b70-a092-d27841c94345",
        "name": "Issue solved?",
        "field_type": "checkbox",
        "data_type": "boolean",
        "required": true,
        "value": true,
        "filled_at": "2015-11-20T14:12:03Z"
      },
      {
        "uuid": "354e9542-e706-4fa1-a52b-175ca7d8081e",
        "name": "Installed equipment",
        "field_type": "barcode",
        "data_type": "string",
        "required": false,
        "value": "80189807",
        "filled_at": "2015-11-20T14:12:03Z"
      },
      {
        "uuid": "1824094e-fa43-43a2-8f6f-c94f201d035c"
        "name": "Actual severity of damage",
        "field_type": "dictionary",
        "data_type": "dictionary",
        "required": true,
        "value": {
          "uuid": "ad5c8dba-2014-4d42-b6f0-d21af8bef97d",
          "name": "Not really"
        }
        "dictionary": {
          "uuid": "e88d66e2-82e3-4699-ab39-e59fe2b902ed",
          "name": "Damage severity"
        },
        "filled_at": "2015-11-20T14:12:03Z"
      },
      {
        "uuid": "127bdd39-efad-4be3-9e07-c5238b78e68d",
        "name": "Notes",
        "field_type": "textarea",
        "data_type": "string",
        "required": false,
        "value": null
      }
    ],
    "available_catalog": [
      {
        "type": "service",
        "service": {
          "uuid": "3bd10759-81ab-4539-8fda-61d6ab5f9a8f",
          "name": "Delivery",
          "external_id": "delivery-pro"
        },
        "required": false,
        "pre_ordered": true
      },
      {
        "type": "category",
        "category": {
          "uuid": "83cb090e-7c6b-4302-9c6e-80cba03ab59a",
          "name": "Installations",
          "external_id": "install"
        }
      }
    ],
    "ordered_services": [
      {
        "service": {
          "uuid": "3bd10759-81ab-4539-8fda-61d6ab5f9a8f",
          "name": "Delivery",
          "external_id": "delivery-pro"
        },
        "ordered_service_uuid": "9f9b9779-7210-472b-9082-086c33c40e4b",
        "required": false
      }
    ],
    "provided_services": [
      {
        "amount": "50.00",
        "service": {
          "uuid": "3bd10759-81ab-4539-8fda-61d6ab5f9a8f",
          "name": "Delivery",
          "external_id": "delivery-pro"
        },
        "price": "50.00",
        "currency": "eur",
        "ordered_service_uuid": "9f9b9779-7210-472b-9082-086c33c40e4b",
        "provided_service_uuid": "4d86b76d-9d73-4f4b-9b8d-2f400e2a5a7e"
      }
    ],
    "used_materials": [
      {
        "product": {
          "name": "Cable",
          "external_id": "cable",
          "uuid": "f1d773f6-71dc-4a85-817a-fcdcd36513ee"
        },
        "unit": {
          "code": "m",
          "name": "Meter",
          "external_id": "meter",
          "uuid": "f9fd36cc-3be8-4e92-9a08-3824ce9dbf41"
        },
        "amount": "45.00",
        "quantity": "5.0",
        "service": {
          "name": "Delivery",
          "external_id": "delivery-pro",
          "uuid": "3bd10759-81ab-4539-8fda-61d6ab5f9a8f"
        },
        "price": "7.00",
        "currency": "eur",
        "provided_service_uuid": "4d86b76d-9d73-4f4b-9b8d-2f400e2a5a7e"
      },
    ],
    "version": 5,
    "created_at": "2016-05-29T17:31:01.419601Z",
    "updated_at": "2016-06-07T10:57:19.529209Z"
  }
}
Table 1. Fields of job
Field Type JSON type Can be null Description

uuid

UUID

String

No

Unique identifier

external_id

String

String

Yes

External ID

external_order_id

String

String

Yes

Order identifier in an external system.
This value is not unique, you can link multiple jobs to a single order, lead or similar thing in another system

serial_no

Integer

Number

No

Sequential job number

status

String

String

No

Current job status

scheduled_at

Datetime

String

Yes

Planned job start time

scheduled_duration

Duration

String

Yes

Planned job duration

description

String

String

Yes

Large text with job decription. Up to 15000 characters

assignee

Assignee

Object

Yes

Either a user or a team

type

Job type

Object

Yes

Job type

template

Template

Object

Yes

Job template

client

Client

Object

Yes

Client

site

Site

Object

Yes

Site

territory

Territory

Object

Yes

Territory

skills

[Skill]

Array

No

List of skills required for the job

contacts

[Contact]

Array

No

List of job contacts

custom_fields

[Custom field]

Array

No

List of custom fields

report_fields

[Custom field]

Array

No

List of report fields

possible_resolutions

[Resolution]

Array

No

List of possible resolutions

resolution

Resolution

Object

No

Job resolution. The field is present only for finished jobs

available_catalog

[Available catalog entity]

Array

No

List of available catalog entities

ordered_services

[Ordered service]

Array

No

List of ordered services

provided_services

[Provided service]

Array

No

List of provided services

used_materials

[Used material]

Array

No

List of used materials

version

Integer

Number

No

Version

created_at

Timestamp

String

No

Timestamp of creation

updated_at

Timestamp

String

No

Timestamp of last update