Fields: Get

Description

Fetch the full value of a single artifact-backed field (a JSON or ARTIFACT field) on a record. This is the dereference target of the { "expandable": true, "href": "..." } handle returned inline by the Search records API and Get record API.

The value is returned directly, not wrapped in a JSON envelope. A JSON field is parsed and returned using canonical JSON encoding, while a text-backed artifact is returned verbatim as plain text. This is the v2 successor to the v1 Get artifact API.

Request

HTTP Method: GET

Path parameter	Description
id	The ID of the record.
field	The ID, name, or slug of the field to retrieve.

Query parameter	Description
format	Optional Override the response content type: json, text, txt, or plain. Defaults to json for JSON fields and text for text artifacts.

curl -X GET \
  https://<tenant-domain>/api/v2/records/<<record_id>>/fields/<<field>> \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

The href in an artifact handle addresses the field by its numeric ID, so you can request it directly:

curl -X GET \
  "https://<tenant-domain>/api/v2/records/555/fields/103" \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request returns the field value directly, not in a JSON envelope:

• A JSON field (or format=json) is returned as application/json. Stored JSON is parsed and re-encoded canonically, so formatting, duplicate keys, and non-finite numbers may be normalized.
• A text-backed ARTIFACT field (or format=text) is returned verbatim as text/plain.

A stored null value is returned as null (for JSON) or an empty body (for text).

Sample response

For a JSON field:

{
  "host": "web-01",
  "tags": ["prod", "eu-west-1"]
}

For a text artifact field (Content-Type: text/plain):

2026-07-02T00:00:01Z  WARN  connection reset by peer
2026-07-02T00:00:02Z  INFO  retrying (1/3)

Errors

Status	Meaning
400	The field reference is unknown or ambiguous, the field is not artifact-backed, or format is invalid.
403	The tenant does not have access to records.
404	Record not found, or the field has no stored value.
500	A stored JSON artifact contains invalid JSON and cannot be returned.

Errors are returned as a JSON object: { "error": { "type", "message", "field"?, "hint"? } }.