---
title: "List services, search operations, or inspect one operation"
method: GET
path: "/v1/discover"
tags: ["Discovery"]
---

# List services, search operations, or inspect one operation

`GET /v1/discover`

## Request

- Base URL: `https://app.taskfuel.ai`
- URL: `https://app.taskfuel.ai/v1/discover`
- Auth: HTTP bearer

With no parameters, lists allowed domains. Use q for keyword search, domain to list or filter one service, or url and method together for one operation's full provider docs.

## Query parameters

- `q` string
- `domain` string
- `url` string, uri
- `method` string

## Response `200`

Domain list, operation list, or full operation docs.

- union
  - DomainList
    - `domains` Domain[], required
      - `domain` string, required
      - `name` string, required
      - `description` string, required
      - `specUrl` string, uri, required
      - `score` number, required
      - `protocol` 'x402' | 'mpp' | 'l402', required
      - `rating` Rating, required: Feedback from paying users. `score` is the share of up-votes weighted by each voter's lifetime top-ups; `weight` is the total voter weight behind it.
        - `score` number, required
        - `up` integer, required
        - `down` integer, required
        - `weight` number, required
    - `hint` string, required
  - OperationList
    - `results` OperationSummary[], required
      - `domain` string, required
      - `method` string, required
      - `url` string, uri, required
      - `summary` string, required
      - `matchedOn` string[]
      - `score` number
      - `rating` Rating, required: Feedback from paying users. `score` is the share of up-votes weighted by each voter's lifetime top-ups; `weight` is the total voter weight behind it.
        - `score` number, required
        - `up` integer, required
        - `down` integer, required
        - `weight` number, required
    - `unavailable` string[]
  - OperationDocs
    - `domain` string, required
    - `method` string, required
    - `url` string, uri, required
    - `docs` unknown, required
    - `rating` Rating, required: Feedback from paying users. `score` is the share of up-votes weighted by each voter's lifetime top-ups; `weight` is the total voter weight behind it.
      - `score` number, required
      - `up` integer, required
      - `down` integer, required
      - `weight` number, required

## Other responses

- `400`: The query parameter combination is invalid.
- `401`: The bearer API key is missing or invalid.
- `404`: The domain or operation was not found.

---

[API](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api.md) · [All operations](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/revisions/fbf2d5210800?raw)