Get skills

curl --request GET \
  --url https://api.kombo.dev/v1/hris/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'

{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "28KMdr68N8kG9EzLwjsN9aoz",
        "remote_id": "238476582",
        "name": "TypeScript Programming",
        "description": "The ability understand and write TypeScript code.",
        "ordered_levels": [
          "Proficiency Level 1",
          "Proficiency Level 2",
          "Proficiency Level 3",
          "Proficiency Level 4",
          "Proficiency Level 5"
        ],
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "remote_data": null
      }
    ]
  }
}

GET

hris

skills

Get skills

curl --request GET \
  --url https://api.kombo.dev/v1/hris/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'

{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "28KMdr68N8kG9EzLwjsN9aoz",
        "remote_id": "238476582",
        "name": "TypeScript Programming",
        "description": "The ability understand and write TypeScript code.",
        "ordered_levels": [
          "Proficiency Level 1",
          "Proficiency Level 2",
          "Proficiency Level 3",
          "Proficiency Level 4",
          "Proficiency Level 5"
        ],
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "remote_data": null
      }
    ]
  }
}

Closed Beta Feature: This endpoint is currently in closed beta. We’re testing it with selected customers before its public release. If you’re interested in learning more or getting early access, please reach out.

Retrieve all skills available in the HRIS system. Skills are available on employees and job positions.

Authorizations

Authorization

string

header

required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

X-Integration-Id

string

required

ID of the integration you want to interact with.

Query Parameters

ids

string

Filter by a comma-separated list of IDs such as 222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3.

remote_ids

string

Filter by a comma-separated list of remote IDs.

name_contains

string

Filter by the name field. Can be used to find a skills by keywords present in the skill name.

Response

GET /hris/skills Positive response

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

data.next

string | null

required

Cursor string that can be passed to the cursor query parameter to get the next page. If this is null, then there are no more pages.

data.results

object[]

required

Show child attributes

data.results.id

string

required

The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.

data.results.remote_id

string

required

The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key.

data.results.name

string

required

The name of the skill.

data.results.description

string | null

required

The description of the skill.

data.results.ordered_levels

string[] | null

required

List of available skill levels in order of proficiency (e.g., ["Beginner", "Intermediate", "Advanced"]).

data.results.changed_at

string<date-time>

required

The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the updated_after parameter which will return records when either the record itself OR its related models have been updated.

data.results.remote_deleted_at

string<date-time> | null

required

The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.

data.results.remote_data

object

required

Includes the data fetched from the remote system. Please be aware that including this in you scope config might violate other scopes that are set.

Remote data always has the endpoint path that we got the data from as the top level key. For example, it could look like: { "/companies": { ... }}

This is not available on all plans. Reach out to Kombo if you need it.

Get performance reviews Create skill

⌘I

General

Features

Guides

HRIS API Reference

General API Reference

DATEV

Get skills

Authorizations

Headers

Query Parameters

Response