Jobiflow LogoAPI Docs
ApiReference Data

List tags

Returns all available tags. Tags are used to categorize job listings and are organised by `tagType` (e.g. `SKILL`, `INDUSTRY`, `PROJECT_TYPE`).

GET
/public/v1/tags

Returns all available tags. Tags are used to categorize job listings and are organised by tagType (e.g. SKILL, INDUSTRY, PROJECT_TYPE).

Authorization

ApiKeyAuth
X-API-Key<token>

API key issued by Jobiflow. Pass it in the X-API-Key request header.

Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/public/v1/tags"
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "Machine Learning",
    "tagType": "SKILL"
  }
]
{
  "status": 401,
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}

Test a webhook POST

Sends a test `ping` event to the registered URL and returns the response status and body from your endpoint. Useful for verifying connectivity and signature verification before going live. Requires scope: `webhooks:manage`

List sectors GET

Returns all available industry sectors and sub-sectors. Use a sector's `id` when creating or updating a job listing.