Get an invoice

GEThttps://api.fieldtask.example/public/v1/invoices/{resource_id}

Permissions

customers:read, invoices:read

Also available as

fieldtask_get_invoice

Returns one invoice by its ID, with its line items, taxes and discount.

Use the id from List invoices or from the Location header of a create response. The invoice must belong to the organization your credential is connected to; otherwise the response is 404 resource_not_found, the same as for an ID that doesn't exist or an invoice that has been deleted.

Reading an invoice never changes it. There's no endpoint to send an invoice, record a payment or collect money.

Permissions

Permission	Dependency in the permission map
customers:read	No dependencies
invoices:read	Depends on customers:read

Invoicing must be enabled for your organization. Otherwise the response is 404 resource_not_found.

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.

What's included

The invoice has every field from List invoices, plus:

Field	Meaning
items	The invoice's line items.
tax1, tax2	Each tax's name, type (percent or fixed), percent_amount and fixed_amount, or null. The amount that doesn't apply to the type is "0.00".
discount	The discount's type, percent_amount and fixed_amount, or null.

Each item has:

Item field	Meaning
name, description, item_type	As shown on the invoice.
quantity, unit_price	Decimal strings with two decimal places.
amount	Quantity × unit price, rounded to cents.
tax1, tax2	Whether each invoice tax applies to this item.
tax1_amount, tax2_amount	The item's tax. A fixed tax adds its full amount to each flagged item.
taxed_amount	amount plus both taxes.
is_active	false for an item that's kept on the invoice but marked inactive. Inactive items still count towards the totals, as they do in FieldTask.

For the order of the calculation and the rounding rule, see Totals, taxes and discounts.

An invoice can have at most 200 items in this response. An invoice with more returns 503 temporarily_unavailable rather than a partial list.

Payment details, sending history and the invoice's subject, po_number and notes aren't returned.

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 a permission this request needs. error.code is missing_permission.	Add the permission named in error.message to the connection.
404	resource_not_found	The invoice doesn't exist, has been deleted or belongs to another organization; invoicing isn't enabled for your organization or in this environment; or the URL is wrong.	Check the ID, that your organization can use invoices in FieldTask, and that the path has 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, or the invoice has more than 200 items or saved values the API can't return.	Retry with exponential backoff. If it keeps failing for one invoice, open it in FieldTask and include the request ID when contacting support.

Request

curl "$FIELDTASK_API_ORIGIN/public/v1/invoices/cccccccc-cccc-4ccc-8ccc-cccccccccc02" \
  --header "Authorization: Bearer $FIELDTASK_API_TOKEN"

Response200 OK

Partly paid invoice with its items and tax

{
  "data": {
    "id": "cccccccc-cccc-4ccc-8ccc-cccccccccc02",
    "invoice_number": "Ex-1038",
    "name": "Rooftop unit inspection",
    "status": "partial",
    "customer": {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Example Property Services",
      "email": "facilities@example.com"
    },
    "issued_date": "2026-10-14",
    "due_date": "2026-11-13",
    "currency": "USD",
    "items": [
      {
        "id": "cccccccc-cccc-4ccc-8ccc-cccccccccc12",
        "name": "Rooftop unit inspection",
        "description": "Visual inspection, filter check and safety report.",
        "item_type": "service",
        "quantity": "2.00",
        "unit_price": "120.00",
        "amount": "240.00",
        "tax1": true,
        "tax1_amount": "19.80",
        "tax2": false,
        "tax2_amount": "0.00",
        "taxed_amount": "259.80",
        "is_active": true
      }
    ],
    "tax1": {
      "type": "percent",
      "name": "Sales tax",
      "percent_amount": "8.25",
      "fixed_amount": "0.00"
    },
    "tax2": null,
    "discount": null,
    "total_tax1": "19.80",
    "total_tax2": "0.00",
    "total_amount": "259.80",
    "discounted_amount": "259.80",
    "paid_amount": "100.00",
    "balance": "159.80",
    "created_at": "2026-10-14T16:05:22.904310Z",
    "updated_at": "2026-10-28T10:41:09.377260Z"
  }
}

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…