Create filter
curl --request POST \
--url https://api.vollna.com/v1/filters \
--header 'Content-Type: application/json' \
--header 'X-API-TOKEN: <api-key>' \
--data '
{
"name": "<string>",
"criteria": {
"keywords": {
"mode": "list",
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"query": "<string>",
"useNegative": false,
"searchIn": {
"title": true,
"description": true,
"skills": true
},
"excludeIn": {
"title": true,
"description": true,
"skills": true
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": true,
"includeFixed": true,
"hideWithoutBudget": false,
"filterByLowerRange": false
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [
123
],
"exclude": [
123
],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": false,
"enterprise": false,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [
{
"id": 123
}
],
"exclude": [
{
"id": 123
}
],
"includeUnknown": true
}
},
"project": {
"locations": {
"include": [
{
"id": 123
}
],
"exclude": [
{
"id": 123
}
],
"includeUnknown": true
},
"languages": {
"mode": "include",
"codes": [
"<string>"
]
},
"languageQualifications": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"visibility": "shared_admins"
}
'import requests
url = "https://api.vollna.com/v1/filters"
payload = {
"name": "<string>",
"criteria": {
"keywords": {
"mode": "list",
"include": ["<string>"],
"exclude": ["<string>"],
"query": "<string>",
"useNegative": False,
"searchIn": {
"title": True,
"description": True,
"skills": True
},
"excludeIn": {
"title": True,
"description": True,
"skills": True
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": True,
"includeFixed": True,
"hideWithoutBudget": False,
"filterByLowerRange": False
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [123],
"exclude": [123],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": False,
"enterprise": False,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [{ "id": 123 }],
"exclude": [{ "id": 123 }],
"includeUnknown": True
}
},
"project": {
"locations": {
"include": [{ "id": 123 }],
"exclude": [{ "id": 123 }],
"includeUnknown": True
},
"languages": {
"mode": "include",
"codes": ["<string>"]
},
"languageQualifications": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"visibility": "shared_admins"
}
headers = {
"X-API-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
criteria: {
keywords: {
mode: 'list',
include: ['<string>'],
exclude: ['<string>'],
query: '<string>',
useNegative: false,
searchIn: {title: true, description: true, skills: true},
excludeIn: {title: true, description: true, skills: true}
},
budget: {
fixedMin: 123,
fixedMax: 123,
hourlyMin: 123,
hourlyMax: 123,
includeHourly: true,
includeFixed: true,
hideWithoutBudget: false,
filterByLowerRange: false
},
connects: {min: 123, max: 123},
descriptionChars: {min: 123, max: 123},
sites: {include: [123], exclude: [123], categories: {}, categoriesExclude: {}},
client: {
paymentVerified: false,
enterprise: false,
totalSpentMin: 0,
hiresMin: 0,
ratingMin: 0,
reviewsMin: 0,
avgHourlyPaidMin: 0,
hireRateMin: 0,
rankMin: 0,
registration: {
mode: 'specific',
after: '2023-12-25',
before: '2023-12-25',
operator: 'more',
value: 123,
unit: 'months'
},
locations: {include: [{id: 123}], exclude: [{id: 123}], includeUnknown: true}
},
project: {
locations: {include: [{id: 123}], exclude: [{id: 123}], includeUnknown: true},
languages: {mode: 'include', codes: ['<string>']},
languageQualifications: {include: ['<string>'], exclude: ['<string>']},
usJobsMode: 'include',
ukJobsMode: 'include'
},
advancedPreferences: {}
},
visibility: 'shared_admins'
})
};
fetch('https://api.vollna.com/v1/filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vollna.com/v1/filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'criteria' => [
'keywords' => [
'mode' => 'list',
'include' => [
'<string>'
],
'exclude' => [
'<string>'
],
'query' => '<string>',
'useNegative' => false,
'searchIn' => [
'title' => true,
'description' => true,
'skills' => true
],
'excludeIn' => [
'title' => true,
'description' => true,
'skills' => true
]
],
'budget' => [
'fixedMin' => 123,
'fixedMax' => 123,
'hourlyMin' => 123,
'hourlyMax' => 123,
'includeHourly' => true,
'includeFixed' => true,
'hideWithoutBudget' => false,
'filterByLowerRange' => false
],
'connects' => [
'min' => 123,
'max' => 123
],
'descriptionChars' => [
'min' => 123,
'max' => 123
],
'sites' => [
'include' => [
123
],
'exclude' => [
123
],
'categories' => [
],
'categoriesExclude' => [
]
],
'client' => [
'paymentVerified' => false,
'enterprise' => false,
'totalSpentMin' => 0,
'hiresMin' => 0,
'ratingMin' => 0,
'reviewsMin' => 0,
'avgHourlyPaidMin' => 0,
'hireRateMin' => 0,
'rankMin' => 0,
'registration' => [
'mode' => 'specific',
'after' => '2023-12-25',
'before' => '2023-12-25',
'operator' => 'more',
'value' => 123,
'unit' => 'months'
],
'locations' => [
'include' => [
[
'id' => 123
]
],
'exclude' => [
[
'id' => 123
]
],
'includeUnknown' => true
]
],
'project' => [
'locations' => [
'include' => [
[
'id' => 123
]
],
'exclude' => [
[
'id' => 123
]
],
'includeUnknown' => true
],
'languages' => [
'mode' => 'include',
'codes' => [
'<string>'
]
],
'languageQualifications' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'usJobsMode' => 'include',
'ukJobsMode' => 'include'
],
'advancedPreferences' => [
]
],
'visibility' => 'shared_admins'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-TOKEN: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vollna.com/v1/filters"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-TOKEN", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vollna.com/v1/filters")
.header("X-API-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vollna.com/v1/filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-TOKEN"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 123,
"name": "<string>",
"status": "active",
"visibility": "shared_edit",
"qualifier": {
"enabled": true,
"mode": "manual",
"showOnlyQualified": true,
"qualifierId": 123,
"name": "<string>",
"prompt": "<string>",
"model": "<string>"
},
"notificationsOn": true,
"summary": {},
"criteria": {
"keywords": {
"mode": "list",
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"query": "<string>",
"useNegative": false,
"searchIn": {
"title": true,
"description": true,
"skills": true
},
"excludeIn": {
"title": true,
"description": true,
"skills": true
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": true,
"includeFixed": true,
"hideWithoutBudget": false,
"filterByLowerRange": false
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [
123
],
"exclude": [
123
],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": false,
"enterprise": false,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [
{
"type": "country",
"id": 123
}
],
"exclude": [
{
"type": "country",
"id": 123
}
],
"includeUnknown": true
}
},
"project": {
"locations": {
"include": [
{
"type": "country",
"id": 123
}
],
"exclude": [
{
"type": "country",
"id": 123
}
],
"includeUnknown": true
},
"languages": {
"mode": "include",
"codes": [
"<string>"
]
},
"languageQualifications": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"quota": {
"used": 123,
"active": 123,
"createLimit": 123,
"activeLimit": 123,
"onTrial": true
}
}
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}Filters
Create filter
Creates a filter. It starts active when the plan has a free active slot, otherwise inactive. Visibility defaults to shared_admins. Criteria keys left out take their defaults
POST
/
filters
Create filter
curl --request POST \
--url https://api.vollna.com/v1/filters \
--header 'Content-Type: application/json' \
--header 'X-API-TOKEN: <api-key>' \
--data '
{
"name": "<string>",
"criteria": {
"keywords": {
"mode": "list",
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"query": "<string>",
"useNegative": false,
"searchIn": {
"title": true,
"description": true,
"skills": true
},
"excludeIn": {
"title": true,
"description": true,
"skills": true
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": true,
"includeFixed": true,
"hideWithoutBudget": false,
"filterByLowerRange": false
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [
123
],
"exclude": [
123
],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": false,
"enterprise": false,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [
{
"id": 123
}
],
"exclude": [
{
"id": 123
}
],
"includeUnknown": true
}
},
"project": {
"locations": {
"include": [
{
"id": 123
}
],
"exclude": [
{
"id": 123
}
],
"includeUnknown": true
},
"languages": {
"mode": "include",
"codes": [
"<string>"
]
},
"languageQualifications": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"visibility": "shared_admins"
}
'import requests
url = "https://api.vollna.com/v1/filters"
payload = {
"name": "<string>",
"criteria": {
"keywords": {
"mode": "list",
"include": ["<string>"],
"exclude": ["<string>"],
"query": "<string>",
"useNegative": False,
"searchIn": {
"title": True,
"description": True,
"skills": True
},
"excludeIn": {
"title": True,
"description": True,
"skills": True
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": True,
"includeFixed": True,
"hideWithoutBudget": False,
"filterByLowerRange": False
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [123],
"exclude": [123],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": False,
"enterprise": False,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [{ "id": 123 }],
"exclude": [{ "id": 123 }],
"includeUnknown": True
}
},
"project": {
"locations": {
"include": [{ "id": 123 }],
"exclude": [{ "id": 123 }],
"includeUnknown": True
},
"languages": {
"mode": "include",
"codes": ["<string>"]
},
"languageQualifications": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"visibility": "shared_admins"
}
headers = {
"X-API-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
criteria: {
keywords: {
mode: 'list',
include: ['<string>'],
exclude: ['<string>'],
query: '<string>',
useNegative: false,
searchIn: {title: true, description: true, skills: true},
excludeIn: {title: true, description: true, skills: true}
},
budget: {
fixedMin: 123,
fixedMax: 123,
hourlyMin: 123,
hourlyMax: 123,
includeHourly: true,
includeFixed: true,
hideWithoutBudget: false,
filterByLowerRange: false
},
connects: {min: 123, max: 123},
descriptionChars: {min: 123, max: 123},
sites: {include: [123], exclude: [123], categories: {}, categoriesExclude: {}},
client: {
paymentVerified: false,
enterprise: false,
totalSpentMin: 0,
hiresMin: 0,
ratingMin: 0,
reviewsMin: 0,
avgHourlyPaidMin: 0,
hireRateMin: 0,
rankMin: 0,
registration: {
mode: 'specific',
after: '2023-12-25',
before: '2023-12-25',
operator: 'more',
value: 123,
unit: 'months'
},
locations: {include: [{id: 123}], exclude: [{id: 123}], includeUnknown: true}
},
project: {
locations: {include: [{id: 123}], exclude: [{id: 123}], includeUnknown: true},
languages: {mode: 'include', codes: ['<string>']},
languageQualifications: {include: ['<string>'], exclude: ['<string>']},
usJobsMode: 'include',
ukJobsMode: 'include'
},
advancedPreferences: {}
},
visibility: 'shared_admins'
})
};
fetch('https://api.vollna.com/v1/filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vollna.com/v1/filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'criteria' => [
'keywords' => [
'mode' => 'list',
'include' => [
'<string>'
],
'exclude' => [
'<string>'
],
'query' => '<string>',
'useNegative' => false,
'searchIn' => [
'title' => true,
'description' => true,
'skills' => true
],
'excludeIn' => [
'title' => true,
'description' => true,
'skills' => true
]
],
'budget' => [
'fixedMin' => 123,
'fixedMax' => 123,
'hourlyMin' => 123,
'hourlyMax' => 123,
'includeHourly' => true,
'includeFixed' => true,
'hideWithoutBudget' => false,
'filterByLowerRange' => false
],
'connects' => [
'min' => 123,
'max' => 123
],
'descriptionChars' => [
'min' => 123,
'max' => 123
],
'sites' => [
'include' => [
123
],
'exclude' => [
123
],
'categories' => [
],
'categoriesExclude' => [
]
],
'client' => [
'paymentVerified' => false,
'enterprise' => false,
'totalSpentMin' => 0,
'hiresMin' => 0,
'ratingMin' => 0,
'reviewsMin' => 0,
'avgHourlyPaidMin' => 0,
'hireRateMin' => 0,
'rankMin' => 0,
'registration' => [
'mode' => 'specific',
'after' => '2023-12-25',
'before' => '2023-12-25',
'operator' => 'more',
'value' => 123,
'unit' => 'months'
],
'locations' => [
'include' => [
[
'id' => 123
]
],
'exclude' => [
[
'id' => 123
]
],
'includeUnknown' => true
]
],
'project' => [
'locations' => [
'include' => [
[
'id' => 123
]
],
'exclude' => [
[
'id' => 123
]
],
'includeUnknown' => true
],
'languages' => [
'mode' => 'include',
'codes' => [
'<string>'
]
],
'languageQualifications' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'usJobsMode' => 'include',
'ukJobsMode' => 'include'
],
'advancedPreferences' => [
]
],
'visibility' => 'shared_admins'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-TOKEN: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vollna.com/v1/filters"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-TOKEN", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vollna.com/v1/filters")
.header("X-API-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vollna.com/v1/filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-TOKEN"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"criteria\": {\n \"keywords\": {\n \"mode\": \"list\",\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"query\": \"<string>\",\n \"useNegative\": false,\n \"searchIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n },\n \"excludeIn\": {\n \"title\": true,\n \"description\": true,\n \"skills\": true\n }\n },\n \"budget\": {\n \"fixedMin\": 123,\n \"fixedMax\": 123,\n \"hourlyMin\": 123,\n \"hourlyMax\": 123,\n \"includeHourly\": true,\n \"includeFixed\": true,\n \"hideWithoutBudget\": false,\n \"filterByLowerRange\": false\n },\n \"connects\": {\n \"min\": 123,\n \"max\": 123\n },\n \"descriptionChars\": {\n \"min\": 123,\n \"max\": 123\n },\n \"sites\": {\n \"include\": [\n 123\n ],\n \"exclude\": [\n 123\n ],\n \"categories\": {},\n \"categoriesExclude\": {}\n },\n \"client\": {\n \"paymentVerified\": false,\n \"enterprise\": false,\n \"totalSpentMin\": 0,\n \"hiresMin\": 0,\n \"ratingMin\": 0,\n \"reviewsMin\": 0,\n \"avgHourlyPaidMin\": 0,\n \"hireRateMin\": 0,\n \"rankMin\": 0,\n \"registration\": {\n \"mode\": \"specific\",\n \"after\": \"2023-12-25\",\n \"before\": \"2023-12-25\",\n \"operator\": \"more\",\n \"value\": 123,\n \"unit\": \"months\"\n },\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n }\n },\n \"project\": {\n \"locations\": {\n \"include\": [\n {\n \"id\": 123\n }\n ],\n \"exclude\": [\n {\n \"id\": 123\n }\n ],\n \"includeUnknown\": true\n },\n \"languages\": {\n \"mode\": \"include\",\n \"codes\": [\n \"<string>\"\n ]\n },\n \"languageQualifications\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"usJobsMode\": \"include\",\n \"ukJobsMode\": \"include\"\n },\n \"advancedPreferences\": {}\n },\n \"visibility\": \"shared_admins\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 123,
"name": "<string>",
"status": "active",
"visibility": "shared_edit",
"qualifier": {
"enabled": true,
"mode": "manual",
"showOnlyQualified": true,
"qualifierId": 123,
"name": "<string>",
"prompt": "<string>",
"model": "<string>"
},
"notificationsOn": true,
"summary": {},
"criteria": {
"keywords": {
"mode": "list",
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"query": "<string>",
"useNegative": false,
"searchIn": {
"title": true,
"description": true,
"skills": true
},
"excludeIn": {
"title": true,
"description": true,
"skills": true
}
},
"budget": {
"fixedMin": 123,
"fixedMax": 123,
"hourlyMin": 123,
"hourlyMax": 123,
"includeHourly": true,
"includeFixed": true,
"hideWithoutBudget": false,
"filterByLowerRange": false
},
"connects": {
"min": 123,
"max": 123
},
"descriptionChars": {
"min": 123,
"max": 123
},
"sites": {
"include": [
123
],
"exclude": [
123
],
"categories": {},
"categoriesExclude": {}
},
"client": {
"paymentVerified": false,
"enterprise": false,
"totalSpentMin": 0,
"hiresMin": 0,
"ratingMin": 0,
"reviewsMin": 0,
"avgHourlyPaidMin": 0,
"hireRateMin": 0,
"rankMin": 0,
"registration": {
"mode": "specific",
"after": "2023-12-25",
"before": "2023-12-25",
"operator": "more",
"value": 123,
"unit": "months"
},
"locations": {
"include": [
{
"type": "country",
"id": 123
}
],
"exclude": [
{
"type": "country",
"id": 123
}
],
"includeUnknown": true
}
},
"project": {
"locations": {
"include": [
{
"type": "country",
"id": 123
}
],
"exclude": [
{
"type": "country",
"id": 123
}
],
"includeUnknown": true
},
"languages": {
"mode": "include",
"codes": [
"<string>"
]
},
"languageQualifications": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"usJobsMode": "include",
"ukJobsMode": "include"
},
"advancedPreferences": {}
},
"quota": {
"used": 123,
"active": 123,
"createLimit": 123,
"activeLimit": 123,
"onTrial": true
}
}
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "Validation failed",
"message": "<string>",
"fields": {}
}{
"error": "<string>"
}Authorizations
API token for authentication
Body
application/json
Required string length:
1 - 255Everything a filter matches on. A key left out takes its default. Unknown keys and wrong values are refused together, one message per field path
Show child attributes
Show child attributes
Who on the team sees the filter
Available options:
shared_edit, shared_view, shared_admins, private Response
Filter created
Show child attributes
Show child attributes
Was this page helpful?