Not a member? Join now to track your game, create a group, find courses, find golfers, and browse equipment all for FREE.

Save Score Live

    Developer API Home
Save a live score as it happens, hole by hole.
When testing this with fake scores, be sure to mark them of type 4 (practice rounds).

URL: http://www.oobgolf.com/api/save_score_live.php

Sample Request: http://www.oobgolf.com/api/save_score_live.php?type=1&session=627e2&score=95&tee_id=14&dev=YOUR-KEY-HERE

Required Parameters
score strokes for this specific hole
session session id for user to save score against.
hole current hole being submitted
dev developer api key


Optional Parameters
tee_id id of tee played, if this parameter is not provided then course name is required
name name of the course being played, if this parameter is not provided then the id of the tee is required
id id of score to edit (leave blank for new scores)
putts putts recorded for hole
penalties # of stroke penalites recorded for hole
sand_shots # of sand shots recorded for hole
tee_club club used off of tee, possible valuse: dr, 3w, 4w, 5w, 7w, hy, 2i, 3i, 4i, 5i, 6i, 7i, 8i, 9i, pw, gw, sw, lw
tee_dist integer distance in yards of first stroke off tee
fairway Don't provide this unless its tracked, otherwise provide:
0) Missed
1) Hit
2) Missed Right
3) Missed Left
nine 0 if playing 18 holes, 1 if playing only 9
back 1 if playing 9 holes starting on the back
type integer type of score entered, options include:
1) Standard - Rules of Golf followed on a USGA rated course during it's active season
2) Scramble - 2-4 player best ball used (doesn't affect handicap)
3) Tournament - Official tournament where you played your own ball
4) Practice Rules of Golf were not followed for the majority of the holes, such as multiple balls played (doesn't affect handicap)
5) Out of Season - Score played on a course that has an inactive season
tee_uid Developer's UNIQUE id of the tee. This is stored by oobgolf and used to find the best matching tee in our system. NOTE: this is unique across all tees not just tee for a course, therefore if you only have an id unique to the course concat that with the course_uid
course_uid Developer's UNIQUE id of the course. This is stored by oobgolf and used to find the best matching course in our system.
city City of the course being played. Used to find best matching tee for score, thus pointless if tee_id is provided.
state State of the course being played (Two character for US states). Used to find best matching tee for score, thus pointless if tee_id is provided.
country Two Character Code for the country of the course being played. Used to find best matching tee for score, thus pointless if tee_id is provided.
zipcode Zipcode of the course being played (5 digit for US). Used to find best matching tee for score, thus pointless if tee_id is provided.
rating USGA rating of the tee being played. Used to find best matching tee for score, thus pointless if tee_id is provided.
slope USGA slope of the tee being played. Used to find best matching tee for score, thus pointless if tee_id is provided.


Sample Response: 
<score>
	<id>28827</id>
	<url>http://www.oobgolf.com/golfers/score.php?id=28827</url>
	<gross-score>15</gross-score>
	<net-score/>
	<esc-score>15</esc-score>
	<fairway-perctange>66.6</fairway-perctange>
	<avg-putts>2.3</avg-putts>
	<next-hole>
		<num>4</num>
		<par>3</par>
		<handicap>12</handicap>
		<distance>197</distance>
	</next-hole>
</score>