Get a job item

GEThttps://api.fieldtask.example/public/v1/jobs/{job_id}/items/{resource_id}

Permissions

job_items:read, jobs:read

Also available as

fieldtask_get_job_item

Returns one item on a job by its ID.

Use the id from List job items or from the Location header of Add a job item. Send it under the job it belongs to. If the job or the item doesn't exist, has been deleted, belongs to another organization, or the item belongs to a different job, the response is 404 resource_not_found.

Permissions

Permission	Dependency in the permission map
job_items:read	Depends on jobs:read
jobs:read	No dependencies

The item has the same fields as in List job items. Its values were copied from the catalog when it was added and don't include a product or price ID. For the job's overall value, read job_value from Get a job.

Request

Responses

200

OK

Response Headers

Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

400

Bad Request

Response Headers

Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

401

Unauthorized

Response Headers

Cache-Control

Responses must not be cached.

WWW-Authenticate
X-Request-ID

Server-generated request correlation ID.

403

Forbidden

Response Headers

Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

404

Not Found

Response Headers

Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

405

Method Not Allowed

Response Headers

Allow
Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

429

Too Many Requests

Response Headers

Cache-Control

Responses must not be cached.

Retry-After

Seconds before retry; present on 429 and an in-progress operation.

X-Request-ID

Server-generated request correlation ID.

503

Service Unavailable

Response Headers

Cache-Control

Responses must not be cached.

X-Request-ID

Server-generated request correlation ID.

Errors

This endpoint accepts no query parameters.

Status	code	Meaning	What to do
400	invalid_query	The query string has an unknown, repeated or invalid parameter.	Send only the documented query parameters, each once.
401	invalid_token	The bearer token is missing, malformed, expired, revoked or issued for a different resource (for example an MCP sign-in).	Send a current REST API token or REST OAuth access token as Authorization: Bearer ….
403	api_access_not_enabled	FieldTask hasn't enabled API access for this organization, or has disabled it.	An owner or admin requests access in Settings → API connections.
403	insufficient_scope	The connection lacks job_items:read or jobs:read. error.code is missing_permission.	Add the permission named in error.message to the connection.
404	resource_not_found	The job or the item doesn't exist in your organization or has been deleted, the item belongs to a different job, job item reads aren't available in this environment, or the URL is wrong.	Check both IDs with GET /public/v1/jobs/{job_id}/items, and check the API origin and path (no trailing slash).
405	method_not_allowed	This path doesn't accept the HTTP method, or the create isn't enabled in this environment. The Allow header lists the methods that are.	Use a method listed in Allow.
429	rate_limit_exceeded	Too many requests in the current minute, or too many concurrent requests, for the organization or connection.	Wait for Retry-After seconds, then retry.
429	daily_quota_exceeded	The organization or connection has used its daily allowance for this kind of request. Allowances reset at 00:00 UTC.	Wait for Retry-After seconds, or check remaining allowance in Settings → API connections.
503	temporarily_unavailable	The service couldn't complete the request.	Retry with exponential backoff. Retry creates with the same key and body.

Request

curl "$FIELDTASK_API_ORIGIN/public/v1/jobs/77777777-7777-4777-8777-777777777777/items/aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa" \
  --header "Authorization: Bearer $FIELDTASK_API_TOKEN"

Response200 OK

Item priced from a named option

{
  "data": {
    "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
    "job_id": "77777777-7777-4777-8777-777777777777",
    "name": "Condenser fan motor replacement",
    "description": "Remove and replace a failed condenser fan motor, including parts and labour.",
    "item_type": "service",
    "price_name": "Standard",
    "quantity": "1.00",
    "unit_price": "185.00",
    "amount": "185.0000",
    "currency": "USD",
    "status": "to do",
    "allow_evidences": false,
    "created_at": "2026-11-03T14:12:09.716Z",
    "updated_at": "2026-11-03T14:12:09.716Z"
  }
}

Example values. IDs and times will differ in your organization.

Try itRequest builder

1. Set the base URL to your API origin with Edit. 2. Paste your token. 3. Fill in parameters or the body. 4. Press Send API Request, or copy the request below and run it yourself. Your token is only kept on this page. Sends are real requests: a create makes a real record.

Loading the request builder…