List Org Fields

Endpoint

GET /v2/core/org-fields

Authentication

This endpoint requires an OAuth access token. Send it as a bearer token:

Authorization: Bearer your_access_token

Required scope: sor:read

Query Parameters

Parameter	Type	Required	Description
`include_attributes`	boolean	No	When `true`, the response also includes the `attributes` array of mapped fields available for uploads. Defaults to `false`

Request Example

curl -X GET "https://platform.chamelio.ai/v2/core/org-fields?include_attributes=true" \
  -H "Authorization: Bearer your_access_token"

import requests

url = "https://platform.chamelio.ai/v2/core/org-fields"
headers = {
    "Authorization": "Bearer your_access_token"
}
params = {
    "include_attributes": True
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const response = await fetch('https://platform.chamelio.ai/v2/core/org-fields?include_attributes=true', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer your_access_token'
  }
});

const data = await response.json();
console.log(data);

Response

Success Response

Status Code: 200 OK

{
  "org_fields": [
    {
      "org_field_id": 301,
      "name": "Governing Law",
      "field_value_type": "enum",
      "field_scope": "global",
      "description": "The jurisdiction whose laws govern the agreement",
      "enum_values": ["Delaware", "New York", "California"],
      "document_types": ["Master Services Agreement", "Non-Disclosure Agreement"]
    },
    {
      "org_field_id": 302,
      "name": "Effective Date",
      "field_value_type": "date",
      "field_scope": "global",
      "description": null,
      "enum_values": null,
      "document_types": null
    }
  ],
  "attributes": [
    {
      "name": "contract_type",
      "field_type": "text"
    },
    {
      "name": "renewal_date",
      "field_type": "date"
    }
  ]
}

Response Fields

Field	Type	Description
`org_fields`	array	List of org fields configured for your organization. Each entry is an Org Field Object
`attributes`	array or null	List of mapped attributes available for uploads. Present only when `include_attributes=true`; otherwise `null`. Each entry is an Attribute Object

Org Field Object

Each object in the org_fields array contains:

Field	Type	Description
`org_field_id`	integer	Unique identifier of the org field
`name`	string	Human-readable name of the field
`field_value_type`	string	Type of the field value. One of `text`, `enum`, `number`, `boolean`, `date`, `clause`
`field_scope`	string	Scope the field applies to within your organization
`description`	string or null	Optional description of the field
`enum_values`	array or null	Allowed values when `field_value_type` is `enum`; otherwise `null`
`document_types`	array or null	Names of the document types this field applies to, if restricted; otherwise `null`

Attribute Object

Each object in the attributes array contains:

Field	Type	Description
`name`	string	Name of the mapped attribute
`field_type`	string	Type of the attribute. One of `text`, `number`, `boolean`, `date`, `link`

Error Responses

400 Bad Request

Returned when the access token has no user behind it. client_credentials tokens act as the admin who created the application, so this applies only to tokens issued before application creators were recorded.

{
  "detail": "client_credentials tokens are not associated with a user"
}

401 Unauthorized

Returned when the access token is missing, unknown, revoked, or expired, or when an X-API-Key was sent instead of a bearer token. See OAuth error responses.

{
  "detail": "Invalid access token"
}

403 Forbidden

Returned when the token does not carry the required scope.

{
  "detail": "Insufficient scope; this endpoint requires: sor:read"
}

429 Too Many Requests

Returned when your organization exceeds its per-minute request limit.

{
  "detail": "Rate limit exceeded"
}

500 Internal Server Error

Returned when the org fields could not be retrieved due to a server error.

{
  "detail": "Failed to fetch org fields"
}

Notes

The result is organization-global and is not filtered per user. Org fields are organization-level configuration - the token’s user is used only to authenticate and scope-check the request.

Use the org_field_id and field_value_type values returned here to populate field_overrides when uploading a document via POST /v2/core/upload.

Use Cases

This endpoint is useful for:

Field discovery - Look up the org fields configured for your organization and their value types
Override mapping - Retrieve valid org_field_id values before setting field_overrides on an upload
Attribute mapping - Discover the mapped attributes available to attach to documents

Overview

API Key Access

OAuth App Access

Webhooks

Endpoint

Authentication

Query Parameters

Request Example

Response

Success Response

Response Fields

Org Field Object

Attribute Object

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases

​Endpoint

​Authentication

​Query Parameters

​Request Example

​Response

​Success Response

​Response Fields

​Org Field Object

​Attribute Object

​Error Responses

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​429 Too Many Requests

​500 Internal Server Error

​Notes

​Use Cases

Endpoint

Authentication

Query Parameters

Request Example

Response

Success Response

Response Fields

Org Field Object

Attribute Object

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

429 Too Many Requests

500 Internal Server Error

Notes

Use Cases