# Event Handicap (Team)

Operations related to Team Handicaps for an Event

**Multi-Round Events:**
When setting a team handicap for a multi-round event, the handicap should be set for each round of the event, there is no option to set a team handicap for the entire event.

**Course vs. Playing Handicap:**
The "Course Handicap" is the team's calculated handicap for their players.

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

**Applying Allocations:**
Allocations are applied to the unrounded course handicap which may result is 2 teams 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 than 18 holes, ensure you are setting an 18 hole equivalent handicap for the team.



## Search handicaps

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


## Update handicap

 - [PATCH /v1/events/{eventId}/teams/{teamId}/handicap](https://api-docs.unknowngolf.com/ug-api/event-handicap-(team)/updatebycourseplaying_1.md): Set the team's handicap index, course, and playing for the event


## Update locked

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


## Update lock all

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