---
title: "Search freelancers by name"
method: GET
path: "/V1/freelancers"
tags: ["Freelancers"]
---

# Search freelancers by name

`GET /V1/freelancers`

## Request

- Base URL: `https://api.worders.net`
- URL: `https://api.worders.net/V1/freelancers`
- Auth: one of:
  - API key in cookie `_worders_session`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/worders/apis/worders-api-v1/docs/V1/freelancers/get.ts> (a function with typed inputs; its response is checked against the schema)

Search freelancers by full or partial name. Used by the freelance invoice verification scenario to locate the user behind an invoice.

## Query parameters

- `q` string, required

## Response `200`

matching freelancers

- object
  - `data` Freelancer[]
    - `id` string, uuid, required
    - `internal_id` string, uuid, nullable: Same as id
    - `full_name` string, required
    - `first_name` string
    - `last_name` string
    - `email` string, email, required
    - `user_type` string, required

## Other responses

- `401`: unauthenticated

---

[API](https://skmtc.dev/worders/apis/worders-api-v1.md) - [All operations](https://skmtc.dev/worders/apis/worders-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/worders/apis/worders-api-v1/revisions/ef0debe7af75?raw)