# Earthquake Phivolcs Dost — 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 real-time and historical earthquake data from the Philippines, including the latest seismic events, monthly records, detailed information about specific earthquakes, and official bulletins. Search through archived earthquake data to track seismic activity over time.

**Category:** Government & Public Data | **Website:** [earthquake.phivolcs.dost.gov.ph/](https://earthquake.phivolcs.dost.gov.ph/) | **Docs:** [parse.bot/marketplace/dd52d729-ac3e-4bba-9c2e-3c3362e22b4f/earthquake-phivolcs-dost-gov-ph-api](https://parse.bot/marketplace/dd52d729-ac3e-4bba-9c2e-3c3362e22b4f/earthquake-phivolcs-dost-gov-ph-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/earthquake-phivolcs-dost/`
**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 earthquake bulletin url

Constructs the bulletin URL for a specific earthquake event from its date/time code and bulletin suffix. No network request is made; this is a deterministic URL builder. Useful for constructing URLs when you know the event identifiers but do not have the full URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bulletin_suffix` | string | Yes | Bulletin suffix code appended to the filename (e.g. 'B1', 'B2', 'B1F', 'B2F', 'B3F'). |
| `date_time_code` | string | Yes | Date-time code in format YYYY_MMDD_HHMM (e.g. '2025_0204_2134'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/earthquake-phivolcs-dost/get-earthquake-bulletin-url \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bulletin_suffix":"<string>","date_time_code":"<string>"}'
```

### Get earthquake detail

Fetches the full bulletin for a single earthquake event. Returns tectonic origin, precise date/time, magnitude with scale type, location with coordinates, depth, reported intensities, damage/aftershock expectations, issue metadata, and an epicentral map image URL when available. The bulletin_url is obtained from get_latest_earthquakes or get_monthly_earthquakes results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bulletin_url` | string | Yes | Full URL to the earthquake bulletin page, obtained from the bulletin_url field in get_latest_earthquakes or get_monthly_earthquakes results. |

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

### Get latest earthquakes

Fetches the current month's earthquake listings from the PHIVOLCS home page. Returns all recorded seismic events with date/time, coordinates, depth, magnitude, location description, and a link to the full bulletin. The list is ordered most-recent-first and covers the current calendar month only; for older data use get_monthly_earthquakes.

**Estimated cost:** Metered

_No parameters required._

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

### Get monthly earthquakes

Retrieves earthquake listings for a specific month and year from the PHIVOLCS archive. Returns the same structure as get_latest_earthquakes. Available months can be discovered via list_available_archives.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | Yes | Full month name: January, February, March, April, May, June, July, August, September, October, November, December. |
| `year` | integer | Yes | Four-digit year of the archive (e.g. 2025). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/earthquake-phivolcs-dost/get-monthly-earthquakes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<integer>"}'
```

### List available archives

Lists all available year/month combinations for the earthquake archive by scanning the PHIVOLCS home page for archive links. Each entry includes the year, month name, and direct URL to the monthly archive page. Use the year and month values as inputs to get_monthly_earthquakes.

**Estimated cost:** Metered

_No parameters required._

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

## 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.