---
title: "Get project custom fields"
method: GET
path: "/projects/{project_id}/custom_fields"
tags: ["project"]
---

# Get project custom fields

`GET /projects/{project_id}/custom_fields`

## Request

- Base URL: `https://api.ora.pm`
- URL: `https://api.ora.pm/projects/{project_id}/custom_fields`
- Auth: OAuth 2
  - Authorization code: `https://app.ora.pm/authorize`
  - Token URL: `https://api.ora.pm/oauth/token` scopes: `read`, `write`

## Response `200`

Success

- CustomField
  - `uuid` string: UUID of the custom field.
  - `creator_id` integer: Id of the user that created the custom field.
  - `project_id` integer: Id of the project
  - `name` string: Title of the custom field.
  - `description` string: Description about the custom field.
  - `created_at` string, date-time: Date and time when the custom field is created.
  - `updated_at` string, date-time: Date and time when the custom field is last updated.
  - `position` integer: 0 - None, 1 - Left, 2 - Right (It's returned if the type is 2).
  - `type` integer: Type of the custom field (1 - Dropdown, 2 - Number, 3 - Text, 4 - Number, 5 - Date, 6 - Checkbox).
  - `options` object[]: List with the dropdown options. (It's returned if the type is 1).
  - `is_multiline` boolean: True if the textfield is multiline. (It's returned if the type is 3).
  - `number_format` integer: 1 - Number, 2 - USD, 3 - EUR, 4 - GBP, 5 - YEN, 6 - Percent, 7 - Custom, 8 - Unformatted (It's returned if the type is 3).
  - `label` string: Which label to show, Example: %, $. (It's returned if the type is 2).
  - `decimals` integer: (It's returned if the type is 2).

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/ora/apis/ora-api.md) - [All operations](https://skmtc.dev/ora/apis/ora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ora/apis/ora-api/revisions/983b9e0b0dda?raw)