# Account

Read the connected customer's basic profile and, most importantly, whether they hold an active Ryde One membership. Check this before offering to transact so your agent can explain the requirement in its own words rather than surfacing a 403.

Read the connected customer's basic profile and, most importantly, whether they hold an active Ryde One membership. Check this before offering to transact so your agent can explain the requirement in its own words rather than surfacing a 403.

## Operations

### `GET /v1/me/membership`

Whether this customer holds an active Ryde One membership. Call it before offering to transact, so the agent can explain the requirement rather than hit a 403 mid-sentence.

- operation: `get_membership_status`
- scope: `profile.read`
- entitlement: none
- creates a transaction: no
- idempotency key: not required
- MCP tool: `get_membership_status`
- status: planned

```bash
curl -s 'https://sandbox-api.ryde.us.com/v1/me/membership' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"
```