# ForeverBetter Lab Collection Location Search

> ForeverBetter Lab Collection Location Search is a paid API for AI agents from api.foreverbetter.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search for nearby lab specimen collection locations by city, postal code, or country, filtering by provider network (Quest, Synlab, or all).

## Facts

- Endpoint: GET https://api.foreverbetter.xyz/labs/search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foreverbetter-lab-collection-location-search-622dc0cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rRibN55C00Ub-uzQRzGL6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability foreverbetter-lab-collection-location-search-622dc0cf
```

Example prompt: Can you find Quest or Synlab lab collection locations near zip code 94105 in San Francisco within 15 miles?

## When to prefer this

Use this endpoint when an agent needs to find physical lab specimen collection sites near a user's location, specifically within the Quest or Synlab networks. Prefer this over a generic web search when you need structured, filterable lab location data with radius and provider controls. Best suited for health or longevity platforms directing users to local blood draw or specimen collection centers.

## Known failure modes

- No labs found in the specified area — returns empty results or a locator handoff URL
- Invalid or unsupported country code — may return error or empty list
- Provider enum value not recognized — schema validation error
- Missing required query parameters may return empty or error response
- Payment of 0.005 USDC not completed — 402 Payment Required response

## How this service works

Find nearby supported lab collection locations or official locator handoffs.

## Output

A list of nearby supported lab collection locations or official locator handoffs, including provider network names, location details (address, name), and potentially redirect URLs for official lab finders — filtered by the requested city, postal code, country, provider, and radius.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "city": {
       "type": "string",
       "description": "City near the user."
      },
      "country": {
       "type": "string",
       "description": "Country code or country name."
      },
      "provider": {
       "enum": [
        "quest",
        "synlab",
        "all"
       ],
       "type": "string",
       "description": "Lab network to search."
      },
      "postal_code": {
       "type": "string",
       "description": "Postal code near the user."
      },
      "radius_miles": {
       "type": "number",
       "description": "Search radius in miles."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foreverbetter-lab-collection-location-search-622dc0cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foreverbetter.xyz](https://www.zero.xyz/host/api.foreverbetter.xyz/llms.txt)