# POST /companies/bulk-delete

**Resource:** [Companies](./companies.md)  
**Scopes:** `companies:delete`  
**Write operation:** yes

Permanently delete up to 100 companies in a single request. Returns a count of deleted records. Cannot be undone. Legacy alias: POST /customers/bulk-delete.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `ids` | body | uuid[] | yes | Array of company UUIDs to delete (max 100) |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/companies/bulk-delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["uuid-1","uuid-2"]}'
```

## Response example

```json
{
  "data": { "success": true, "deleted": 2 },
  "meta": { "credits_remaining": 9480 }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`