# Philips — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access recall notices, affected device lists, news articles, and support information from the official Philips recall portal. Search for specific device models, retrieve detailed recall updates, and get contact and remediation details.

**Category:** Healthcare | **Website:** [philips.com/](https://philips.com/) | **Docs:** [parse.bot/marketplace/b5c981c6-131e-40fa-8714-2f21eba496b6/philips-com-api](https://parse.bot/marketplace/b5c981c6-131e-40fa-8714-2f21eba496b6/philips-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/philips/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get affected device list

Returns a structured list of all affected/recalled device categories and their associated product page URLs from the replacement devices page. Each category groups one or more product model URLs. The data is sourced from the recall replacement devices and testing results pages.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-affected-device-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get contact and support

Fetches remediation progress statistics and contact/support information from the recall progress page. Includes US actionable registrations count, devices remediated figures for both ventilators and sleep therapy devices, and instructions for contacting Philips Respironics support.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-contact-and-support \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ozone cleaner information

Fetches safety information and warnings regarding the use of ozone and UV light cleaners with Philips CPAP devices. Includes references to FDA safety communications and approved cleaning methods for replacement devices.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-ozone-cleaner-information \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get recall home

Fetches the main Philips Voluntary Recall Information page. Returns the recall title, introductory description, navigation links to sub-pages (testing results, replacement devices, progress), active alerts, and a remediation progress summary when available. This is the entry point for understanding the scope of the June 2021 foam recall.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-recall-home \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get recall news and updates

Returns a list of recall-related news articles and updates with their titles, URLs, and teasers when available. Articles include sub-page links from the recall portal (progress updates, testing results, replacement devices) and external recall explanations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-recall-news-and-updates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get recall news article

Fetches the content of a specific recall news article by its URL path slug. Returns the article title, publication date (when found), body text with navigation/boilerplate stripped, and any attached PDF documents. Accepts a full URL, an absolute path, or a bare slug name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The URL path slug of the article. Accepts a full URL (https://www.usa.philips.com/...), an absolute path starting with '/' (e.g. '/sleep-respiratory-care/news/business-updates/ozone-cleaner-information'), or a bare slug name (e.g. 'ozone-cleaner-information'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/get-recall-news-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Search recall by model

Filters the affected device list by matching the query string against category names and model URLs. Returns only categories where the query appears as a substring (case-insensitive). Useful for checking whether a specific device model or product line is part of the recall.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Model name or keyword to search for (e.g., 'DreamStation', 'BiPAP', 'Go', 'Trilogy'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/philips/search-recall-by-model \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.