Get custom fields from contracts | Deel

{
  "data": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "name": "Employee Bonus Eligibility",
    "type": {
      "name": "currency",
      "currency": "USD",
      "is_fixed": false
    },
    "settings": {
      "access": {
        "provided_by": "organization",
        "is_sensitive": true
      },
      "required": false,
      "countries": [
        "US",
        "GB",
        "CA"
      ],
      "is_enabled": true,
      "worker_types": [
        "contractor",
        "eor"
      ]
    },
    "placement": "contract",
    "created_at": "2023-11-01T09:15:30.000Z",
    "description": "Indicates if the employee is eligible for a performance bonus"
  }
}

Retrieves a single custom field definition from a contract by its id, returning the field’s name, type, settings, placement, and description. Token scopes: contracts:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

idstringRequiredformat: "uuid"

Custom field id.

Response

Successful response

dataobject

Custom field object

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'

$	curl https://api.letsdeel.com/rest/v2/contracts/custom_fields/d290f1ee-6c54-4b01-90e6-d701748f0851 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"