# list_search_providers

Source: <https://everruns.com/docs/api/operations/list_search_providers/>

GET

/v1/search-providers

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/search-providers';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/search-providers
```

* Production APIapp.everruns.com/api/v1/search-providers

List the web search providers of the active organization: built-in free and model provider search, connected model providers that search natively, connectors that hold search accounts, connected search accounts with status, and the organization’s web search defaults.

## Responses

### 200

Media typeapplication/json

Everything the organization can search with.

object

**accounts**

required

Array\<object>

A connected organization search account (never its key).

object

**automatic\_position**

Place in the Automatic order (1-based), counting native and accounts.

integer | null

**connected\_at**

required

string format: date-time

**id**

required

string format: uuid

**name**

required

Account name the admin gave it.

string

**provider**

required

string

**status**

required

`ready` when a key is stored, `missing_key` otherwise.

string

**built\_in**

required

Array\<object>

A provider that needs no setup.

object

**description**

required

string

**id**

required

`free` or `native`.

string

**name**

required

string

**price\_note**

Plain-words cost, when the provider bills per search.

string | null

**connectors**

required

Array\<object>

A connector whose organization accounts answer web search.

object

**description**

required

string

**icon**

required

string

**name**

required

string

**provider**

required

Connector id, used to connect an account at `/v1/orgs/{org}/organization-connections/providers/{provider}`.

string

**defaults**

required

An organization’s web search defaults.

object

**account\_id**

The search account when `provider` is `account`.

string | null format: uuid

**allow\_native**

Whether agents may use the model provider’s own search (billed by the model provider).

boolean

**automatic\_order**

Automatic order: `native`, search account ids, and `free`, which is always last. Entries left out keep their natural place.

Array\<string>

**blocked\_domains**

Sites no search in this organization returns, on top of each agent’s.

Array\<string>

**fallback**

When a provider cannot answer: `next` falls back (free search last), `none` stops. An agent’s own `fallback` wins.

string

Allowed values: next none

**provider**

Provider for agents set to the organization default: `auto`, `native`, `brave`, `account` (with `account_id`) or `free`.

string

Allowed values: org\_default auto native brave account free

**results\_per\_search**

Results per search when neither the model nor the agent asks (1 to 20).

integer format: int32

**native\_providers**

required

Array\<object>

A connected model provider whose models search natively.

object

**name**

required

string

**price\_note**

required

string

**provider\_id**

required

string

**provider\_type**

required

string

##### Example

```json
{
  "accounts": [
    {
      "provider": "brave_search",
      "status": "ready"
    }
  ],
  "built_in": [
    {
      "id": "free"
    }
  ],
  "connectors": [
    {
      "provider": "brave_search"
    }
  ],
  "defaults": {
    "fallback": "next",
    "provider": "org_default"
  },
  "native_providers": [
    {
      "provider_type": "anthropic"
    }
  ]
}
```