---
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`

## Request

- Base URL: `https://www.pickanagency.com/api/v1`
- URL: `https://www.pickanagency.com/api/v1/match`
- Auth: none required
- TypeScript: <https://skmtc.dev/pickanagency/apis/pick-an-agency-api/docs/match/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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
    - `location` object
      - `city` string, nullable
      - `country` string, nullable
    - `rating` number, nullable: Overall rating, 0-5
    - `total_reviews` integer
    - `services` string[]
    - `industries` string[]
    - `is_verified` boolean
    - `match_score` number
    - `profile_url` string, uri
  - `meta` Meta: Attribution and docs pointers, present on every response
    - `source` string
    - `attribution` string
    - `docs` string, uri

## Other responses

- `400`: services parameter missing
- `500`: Matching failed

## Changes

- **2026-09-14** `7d3d76fe54d2`: 5 warning, 3 info
  - removed the optional property `matches/items/founded_year` from the response with the `200` status
  - removed the optional property `matches/items/min_budget_usd` from the response with the `200` status
  - removed the optional property `matches/items/tagline` from the response with the `200` status
  - removed the optional property `matches/items/team_size` from the response with the `200` status
  - …4 more

[Operation history](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/changes/match/get.md)

---

[API](https://skmtc.dev/pickanagency/apis/pick-an-agency-api.md) - [All operations](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/revisions/0c6a8f294ce8?raw)