# List Blocked Companies

`GET https://api.getprospect.com/v2/blocklist/companies`

Lists the company domains on the workspace's block list, newest first, optionally filtered by a substring of the domain. Free, no credits; spends no rate-limit units, but counts against the per-second window of the `search` bucket. Blocked people and companies are left out of people and company search, people and company enrich, email find and suggestions in this workspace, within 15 seconds. Saving a person by id and email verify are not filtered by workspace block lists, and blocked domains that resolve to more than 10,000 companies are only partly excluded from people search. Any member or API key of the workspace may call it; a credential that belongs to no workspace answers 403.

## Authentication

Pass your API key in the `x-api-key` header.

## Query parameters

- `query` (string, optional, min length: 2, max length: 100): Case-insensitive substring of the first or last name (people) or of the domain (companies). Matched as plain text.
- `page` (number, optional, min: 1, default: 1): The page, 1-based. Past the end: `[]` with the totals.
- `per_page` (number, optional, min: 1, max: 100, default: 25): Entries per page.

## Example request

```bash
curl --request GET \
  --url https://api.getprospect.com/v2/blocklist/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

One page of entries, newest first.

```json
{
  "success": true,
  "data": [
    {
      "id": "6705a1c2e4b0f1a2b3c4d5e7",
      "domain": "acme.com",
      "created_at": "2026-10-08T09:30:00.000Z"
    }
  ],
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_pages": 1,
      "total_count": 1
    }
  }
}
```

## Response 400

Invalid query (`VALIDATION_ERROR`): `out_of_range` (`page` below 1, `per_page` outside 1-100, `query` outside 2-100 characters), `wrong_type` or `unknown_field` (with `allowed_fields`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "per_page must not be greater than 100",
      "payload": {
        "field": "per_page",
        "code": "out_of_range",
        "received_value": 500,
        "received_type": "number",
        "constraints": {
          "max": "per_page must not be greater than 100"
        }
      }
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 403

The credential belongs to no workspace (`FORBIDDEN`, `workspace_required`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T09:30:00.000Z"
  },
  "errors": [
    {
      "name": "FORBIDDEN",
      "message": "This operation works inside a workspace, and the credential used belongs to none",
      "payload": {
        "code": "workspace_required"
      }
    }
  ]
}
```

## Response 429

Over the per-second window of the `search` bucket (`RATE_LIMIT`). Sent only where rate-limit enforcement is on; wait `Retry-After` seconds.

## Response 500

Unexpected server error.