# Philips — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_affected_device_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_contact_and_support \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_ozone_cleaner_information \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_recall_home \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_recall_news_and_updates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/get_recall_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-philips-com-api-b5c981c6/search_recall_by_model \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```