Skip to main content
GET
Search roles for an agency member

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

recruiterEmail
string<email>
required

Email of currently approved member of your agency, e.g. jane@agency.com. Results use that member's permissions; does not authenticate key holder. Unknown, other-agency, or unapproved member answers 403.

Maximum string length: 254
query
string

Typo-tolerant text search over roles and companies, e.g. senior backend. 1-200 characters. Omit to browse without text filter.

Required string length: 1 - 200
location

Location key, e.g. san_francisco, not display name. Repeat up to 20; matches any.

Available options:
new_york,
san_francisco,
south_bay_area,
los_angeles,
boston,
seattle,
texas,
chicago,
europe,
latam,
korea,
canada,
australia,
india,
uk,
washington_dc,
asia,
denver,
florida,
minnesota,
sacramento
workplace

Workplace key, e.g. REMOTE. Repeat up to 20; matches any.

Available options:
REMOTE,
ON_SITE,
HYBRID
roleType

Role type key, e.g. backend_engineer. Repeat up to 20; matches any.

Available options:
backend_engineer,
frontend_engineer,
full_stack_engineer,
mobile_engineer,
infrastructure_devops_sre,
security_engineer,
forward_deployed_engineer_solutions_support,
robotics_software_engineer,
robotics_platform_engineer,
sales_solutions_engineer,
qa_test_engineering,
blockchain_protocol_engineer,
developer_relations_advocacy,
founding_engineer,
product_engineer,
embedded_firmware_engineer,
mechanical_engineer,
electrical_engineer,
robotics_hardware_engineer,
aerospace_flight_engineer,
machine_learning_engineer,
robotics_ml_engineer,
data_engineer,
data_science_analytics,
computer_vision_engineer,
research_scientist_applied_research,
ai_ml_researcher,
research_engineer_applied_research,
data_scientist_applied_scientist,
machine_learning_infrastructure,
machine_learning_ops_platform,
research_scientist,
research_engineer,
ai_engineer,
product_management,
product_design_ux_ui,
brand_visual_design,
marketing_growth,
growth_engineer,
growth_marketing,
demand_generation,
performance_paid_media,
lifecycle_crm_email,
seo_organic_growth,
marketing_ops_analytics,
product_marketing,
customer_marketing,
content_marketing,
brand_marketing,
social_media_influencer,
communications_pr,
events_field_marketing,
marketing_leadership,
founding_marketer_generalist,
account_executives_sales,
account_management_customer_success,
business_development,
sales_development_rep,
customer_technical_support,
content_copywriting,
sales_gtm_leadership,
partnerships,
operations_strategy,
robotics_operations_engineer,
revenue_operations,
finance_accounting,
people_talent,
chief_of_staff,
program_project_management,
executive_assistant,
data_analyst,
engineering_leadership,
executive_leadership,
clinical_healthcare,
legal_compliance_officer,
legal_operations,
legal_compliance,
legal_partner,
legal_counsel,
legal_associate,
legal_in_house_counsel,
legal_paralegal,
legal_admin
industry

Industry key (e.g. fintech) or namespaced practice area (e.g. law::litigation). Repeat up to 20; matches any.

Required string length: 1 - 100
techStack

Tech stack key, e.g. python. Repeat up to 20; matches any.

Available options:
java,
python,
javascript,
typescript,
react,
node,
nextjs,
tensorflow,
pytorch,
tensorboard,
pyspark,
kafka,
kubernetes,
redis,
mongo,
postgresql,
mysql,
mongodb,
aws,
gcp,
azure,
git,
docker,
k8s,
terraform,
tailwind,
cloudflare,
c/c++,
c#,
htmx,
html,
css,
ruby,
ruby_on_rails,
django,
flutter,
dart,
fastapi,
graphql,
rest_api,
vue,
svelte,
langchain,
snowflake,
hadoop,
mapreduce,
rpc,
cassandra,
cicd,
graph_database,
vector_database,
open_ai,
web3,
solidity,
go,
rust,
scala,
kotlin,
swift,
php,
laravel,
spring_boot,
express,
angular,
ember,
backbone,
jquery,
sass,
less,
webpack,
babel,
elasticsearch,
rabbitmq,
nginx,
apache,
jenkins,
travis_ci,
circle_ci,
ansible,
puppet,
chef,
prometheus,
grafana,
tableau,
power_bi,
d3,
three_js,
unity,
unreal_engine,
opencv,
scikit_learn,
pandas,
numpy,
r,
sas,
spark,
hive,
airflow,
luigi,
dask,
kubeflow,
mlflow
minSalary

Lowest annual candidate base salary, whole currency units, e.g. 150000. Max 999000; above rejected with 400. Matched to nearest 1,000, no currency conversion.

Pattern: ^\d+$
maxSalary

Highest annual candidate base salary, whole currency units, e.g. 250000. Max 999000; above rejected with 400. Must be at least minSalary.

Pattern: ^\d+$
minYearsExperience

Lowest years of experience, whole number 0-100, e.g. 3.

Pattern: ^\d+$
maxYearsExperience

Highest years of experience, whole number 0-100. Must be at least minYearsExperience.

Pattern: ^\d+$
limit
default:20

Roles per page, 1-50, default 20. Above 50 rejected with 400.

Pattern: ^\d+$
cursor
string

Previous page's nextCursor. Only with same recruiterEmail, query, filters; changed search starts new first page. Results live, not frozen snapshot.

Required string length: 1 - 2048

Response

200 - application/json

Success

roles
object[]
required
nextCursor
string | null
required