---
title: "BeachRankingPerson Updates (full or delta)"
method: GET
path: "/beach/beach-rankings"
tags: ["Beach Updates"]
---

# BeachRankingPerson Updates (full or delta)

`GET /beach/beach-rankings`

## Request

- Base URL: `https://api.volleynet.cc`
- URL: `https://api.volleynet.cc/beach/beach-rankings`
- Auth: none required
- TypeScript: <https://skmtc.dev/volleynet/apis/o-vv-volley-api-documentation/docs/beach/beach-rankings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns aggregated person rankings per season and ranking type,
either all available or only those modified since a given timestamp.

## Query parameters

- `ts` integer: Unix timestamp (in seconds). Filters records updated since this time.
- `all` boolean: Return all records ignoring `ts`.
- `season` string: Season ID to filter by. Defaults to current beach season.
- `person_id` integer: Filter by person ID.
- `ranking_list_type_id` integer: Filter by ranking list type.

## Response `200`

- object[]
  - `id` integer
  - `season_id` string
  - `person_id` integer
  - `ranking_list_type_id` integer
  - `ranking_list_type_name` string
  - `sex` string
  - `rank` integer
  - `all_points` integer
  - `player_name` string
  - `club` string
  - `slug` string
  - `code` string
  - `created_at` string
  - `updated_at` string
  - `deleted_at` string

---

[API](https://skmtc.dev/volleynet/apis/o-vv-volley-api-documentation.md) - [All operations](https://skmtc.dev/volleynet/apis/o-vv-volley-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/volleynet/apis/o-vv-volley-api-documentation/revisions/1743e6e988d5?raw)