# Developers & API

[Full page](https://rides.je/developers)

Build against Jersey's vehicle marketplace. Every participating dealer's live
stock — cars, vans, motorbikes and boats — over REST, MCP, NLWeb or plain
markdown. Read-only, free, and open without an account.

## Quickstart — no key needed

```bash
curl -s 'https://rides.je/api/listings?type=car&make=BMW&priceTo=15000&perPage=5'
```

Want markdown instead of JSON? Append `.md` to any page URL, or send
`Accept: text/markdown`.

## API keys

Only `/api/v1` — the versioned contract — needs a token, and any agent can
mint one anonymously: no registration, no secret to store, nothing to approve.

```bash
curl -s -X POST https://rides.je/api/agent/identity \
  -H 'content-type: application/json' -d '{"client_name":"my-agent"}'
```

A request without one returns `401` with a `WWW-Authenticate` header naming
our [protected resource metadata](https://rides.je/.well-known/oauth-protected-resource),
so a failed call is enough to rediscover the whole flow.

## Sandbox — no token at all

```bash
curl -s 'https://rides.je/api/v1/vehicles?sandbox=true'
```

Fixture data in the production response shape, so an integration built against
it works unchanged on live stock.

## MCP

| Server | URL | Purpose |
| --- | --- | --- |
| Product | `https://rides.je/api/mcp` | Search and read live Jersey stock |
| Documentation | `https://rides.je/api/mcp/docs` | Our docs and Jersey vehicle rules |

Both Streamable HTTP, both unauthenticated.

## Reference

- [API reference](https://rides.je/api.md) · [Authentication](https://rides.je/auth.md) · [Agent guide](https://rides.je/agents.md)
- [OpenAPI](https://rides.je/openapi.json) · [llms.txt](https://rides.je/llms.txt) · [Developer llms.txt](https://rides.je/developers/llms.txt)
- [API catalog](https://rides.je/.well-known/api-catalog) · [Agent card](https://rides.je/.well-known/agent-card.json)

## Limits

Free, no published rate limits — send a descriptive `User-Agent` and tell us
before you go heavy. Stock refreshes nightly, so link the buyer through to the
listing rather than asserting availability. Attribute to Rides.je. There
are no write endpoints: enquiries reach dealers through the listing page, with
a human in the loop, deliberately.

Questions: rides@rides.je

---

_Source: https://rides.je · Jersey, Channel Islands · Agent guide: https://rides.je/agents.md · Contact: rides@rides.je_