---
title: Get
url: https://www.tines.com/stories/docs/api/records/fields/get/
updated: 2026-09-23T08:49:52+00:00
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](/api/records/search) and [Get record API](/api/records/get)."
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/stories/docs/llms.txt) › [Tines API](https://www.tines.com/stories/docs/api/llms.txt) › [Records](https://www.tines.com/llm/stories/docs/api/records.md) › [Fields](https://www.tines.com/llm/stories/docs/api/records/fields.md)*

# Get

*[View on tines.com](https://www.tines.com/stories/docs/api/records/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](/api/records/search) and [Get record API](/api/records/get).

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](/api/records/artifacts/get).

## 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. |

```bash
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:

```bash
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:

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

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

```text
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"? } }`.