Get a level

GET 
/api/levels/:id

Required permissions:

• settings.company: allows view of company levels.

Here the dedicated support page.

Request

Path Parameters

id integerrequired

The ID of the level to view

Header Parameters

Wethod-Company stringrequired

The company you want to interact with

Wethod-Version stringrequired

The API version you want to use

Responses

200

Returns the requested level.

application/json

Schema

Schema

id integerrequired

Possible values: >= 1

created_at date-timerequired
updated_at date-timerequired
name stringrequired

Possible values: <= 45 characters

The level name

code stringrequired

Possible values: <= 45 characters

The level code

chargeability_target float

Possible values: <= 100

The level chargeability target percentage

is_external booleanrequired

Whether this level is external

must_be_planned booleanrequired

Whether resources with this level must be planned

must_do_timesheet booleanrequired

Whether resources with this level must fill timesheets

is_default_in_budget booleanrequired

Whether this is the default level in budget

Example (from schema)

{
  "id": 1,
  "created_at": "2025-04-22T10:10:02.719Z",
  "updated_at": "2025-04-22T10:10:02.719Z",
  "name": "Junior",
  "code": "jr",
  "chargeability_target": 80,
  "is_external": false,
  "must_be_planned": true,
  "must_do_timesheet": true,
  "is_default_in_budget": false
}

400

Validation failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

failures

object[]

List of validation errors

Array [

field string

Name of the field causing the error

message string

Human-readable description of the error

]

Example (from schema)

{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

403

Forbidden

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

404

Not found

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "not_found",
  "message": "string"
}

Loading...