---
title: "Get Fields"
method: GET
path: "/v0/logs/fields"
tags: ["Logs"]
---

# Get Fields

`GET /v0/logs/fields`

Returns field definitions and their types for the specified project.

Context handling:
- If no context is provided (or an empty string), returns a flat mapping of field
  name → metadata for the default context.
- If a specific context name is provided, returns a flat mapping of field
  name → metadata for that context.
- If context is '*', returns a nested mapping of context_name → {field_name → metadata}
  containing fields from all contexts in the project.

Each field entry contains:
- data_type: The data type of the field (int, str, etc)
- field_type: Whether it's an entry, param, or derived_entry
- mutable: Whether the field can be modified
- unique: Whether the field enforces uniqueness
- created_at: When the field was first created
- artifacts: For derived entries, contains the equation
- description: The description of the field

## Query parameters

- `project_name` string, required — Name of the project to get fields and their types for.
- `context` string, nullable — Optional context name to filter field types. Use '*' to return fields from all contexts in the project.

## Response `200`

Successful Response

- unknown

## Other responses

- `404` — Project Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)