# Event Handicap (Player)

Operations related to Player Handicaps for an Event

**Multi-Round Handicaps:**
For multi-round events, the player's will have handicaps set at the overall event level and then for each round which will override the event level for that round.

**Course vs. Playing Handicap:**
The "Course Handicap" is the players calculated handicap for the assigned tee box (Slope, Rating, and Par).

The "Playing Handicap" is the player's course handicap and then applying allocations, an example allocation could be 80% of a player's handicap where their Course handicap is a 10 and their playing handicap is an 8.

**Applying Allocations:**
Allocations are applied to the unrounded course handicap wich may result is 2 players having the same course handicap but slightly different playing handicaps.

**Handicap Number of Holes:**
All handicaps consumed and calculated are for 18 holes, regardless of the number of holes that are being played.  If you are manually setting a handicap for an event that is playing less then 18 holes, ensure you are setting an 18 hole equilivant handicap for the player.



## Search handicaps

 - [GET /v1/events/{eventId}/players/handicaps](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/search_2.md): List of players and their handicaps for the event


## Update handicap

 - [PATCH /v1/events/{eventId}/players/{playerId}/handicap/coursePlaying](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/updatebycourseplaying.md): Set the player's Course and Playing handicap for an Event.


## Update handicap index

 - [PATCH /v1/events/{eventId}/players/{playerId}/handicap/index](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/updatebyindex.md): Set the player's Course and Playing handicap for an Event by Handicap Index.


## Update locked

 - [PATCH /v1/events/{eventId}/players/{playerId}/handicap/lock](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/updatelocked.md): Set the player's handicap as locked or unlocked for the event


## Update lock all

 - [PATCH /v1/events/{eventId}/players/handicaps/lock](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/updatelockedall.md): Set all player's handicaps as locked or unlocked for the event


## Update Assigned tee

 - [PATCH /v1/events/{eventId}/players/{playerId}/handicap/tee/{teeId}](https://api-docs.unknowngolf.com/ug-api/event-handicap-(player)/updatetee.md): Set the player's assigned tee box