---
title: "Get a ranked shortlist of agencies for a brief"
method: GET
path: "/match"
---

# Get a ranked shortlist of agencies for a brief

`GET /match`

## Query parameters

- `services` string, required
- `country` string
- `city` string
- `budget` string
- `industry` string
- `platforms` string
- `limit` integer

## Response `200`

Ranked shortlist

- object
  - `count` integer
  - `matches` object[]
    - `slug` string
    - `name` string
    - `tagline` string, nullable
    - `location` object
      - `city` string, nullable
      - `country` string, nullable
    - `rating` number, nullable — Overall rating, 0-5
    - `total_reviews` integer
    - `services` string[]
    - `industries` string[]
    - `team_size` '1-10' | '11-50' | '51-200' | '201-500' | '500+' | 'null', nullable
    - `founded_year` integer, nullable
    - `min_budget_usd` integer, nullable
    - `website` string, nullable
    - `is_verified` boolean
    - `profile_url` string, uri
    - `match_score` number

## Other responses

- `400` — services parameter missing

---

[API](https://skmtc.net/pickanagency/apis/pick-an-agency-api.md) · [All operations](https://skmtc.net/pickanagency/apis/pick-an-agency-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pickanagency/pick-an-agency-api/revisions/2a3f051cd088/schema)