Skip to main content

Quickstart

Make your first Kula API call in under 5 minutes.

Prerequisites​

List Job Posts​

Fetch published job posts from your account:

curl -X GET "https://api.kula.ai/v1/job-boards/job-posts" \
  -H "Authorization: Bearer your_api_token_here"

Response​

{
  "job_posts": [
    {
      "id": "123",
      "title": "Senior Software Engineer",
      "ats_job": {
        "status": "open",
        "workplace": "hybrid",
        "employment_type": "full_time"
      },
      "ats_department": {
        "name": "Engineering"
      },
      "ats_offices": [
        {
          "name": "San Francisco HQ",
          "city": "San Francisco"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "total_pages": 3,
    "total_count": 45
  }
}

Common Operations​

Filter by workplace​

curl "https://api.kula.ai/v1/job-boards/job-posts?filter_by[workplaces][]=remote" \
  -H "Authorization: Bearer your_api_token_here"

Search by title​

curl "https://api.kula.ai/v1/job-boards/job-posts?filter_value=Engineer" \
  -H "Authorization: Bearer your_api_token_here"

Get a specific job​

curl "https://api.kula.ai/v1/job-boards/job-posts/123" \
  -H "Authorization: Bearer your_api_token_here"

Error Handling​

Check the response status and handle errors:

const response = await fetch('https://api.kula.ai/v1/job-boards/job-posts', {
  headers: { 'Authorization': `Bearer ${token}` }
});

if (!response.ok) {
  const error = await response.json();
  console.error(error.error.code, error.error.message);
}

Next Steps​