HIhibob
Skills

Search skills

Search API-origin skills using field projection, filters, and cursor pagination.

Search always returns only API-origin skills (those with a /skill/source and /skill/externalId). Use it to verify sync outcomes and reconcile an external framework against Bob.

Filters: optional. Only the equals operator is supported, on the fields listed in SkillFilterFieldId. Requesting an unsupported field or operator returns 400 Bad Request.

Pagination: cursor-based. Pass limit (1–200, default 50) and the response_metadata.next_cursor from the previous page as cursor. The last page returns next_cursor: null.

Rate limit: 60 requests/min per tenant.

OAuth scope (app-user): job_catalog.skills:read.

IAM permission: Job catalog / Skills / View or Manage (company-scoped).

post/skills/search

Request

  • Base URL
    https://api.hibob.com/v1
  • URL
    https://api.hibob.com/v1/skills/search
  • Auth
    • HTTP basic
    • or HTTP bearer

Request body

fieldsSkillFieldId[] nullable

Field IDs to include in each result item (see SkillFieldId). When omitted or empty, a default field set is returned.

limitinteger nullable

Maximum number of results per page. Allowed range 1–200; defaults to 50.

cursorstring nullable

Opaque cursor from a previous response's response_metadata.next_cursor. Omit on the first request.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.