Create a venue

POST

/v1/venues

curl --request POST \
  --url https://api.ligr.live/rest/v1/venues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "gfxName": "example", "address": "example", "city": "example", "country": "example", "state": "example", "postcode": "example" }'

• LIGR REST API

Creates a venue in the API key’s organization. Location fields require a nonblank address. Omit all location fields to create a venue with only its name and optional graphics name.

Authorizations

• bearer
  venues:write
• api_key
  venues:write

Request Body^required

Media typeapplication/json

Location fields require a nonblank address. Omit all location fields for a venue without an address.

object

name

required

Default Entity name

string

>= 6 characters <= 39 characters

gfxName

string

address

string

city

Requires a nonblank address.

string

country

Requires a nonblank address.

string

state

Requires a nonblank address.

string

postcode

Requires a nonblank address.

string

Example^generated

{
  "name": "example",
  "gfxName": "example",
  "address": "example",
  "city": "example",
  "country": "example",
  "state": "example",
  "postcode": "example"
}

Responses

201

Created

Media typeapplication/json

object

id

required

Entity identifier

integer format: int32

>= 1

name

required

Default Entity name

string

>= 6 characters <= 39 characters

gfxName

required

Name predominantly display in graphics

string

nullable >= 6 characters <= 19 characters

dataProvider

object

name

required

string

Allowed values: RB OPTA_CRICKET OPTA_FOOTBALL OPTA_RUGBY_UNION STATSLLC GENIUS_BASKETBALL GENIUS_GRIDIRON GENIUS_VOLLEYBALL GENIUS_FOOTBALL GENIUS_ICE_HOCKEY PIXELLOT CLOUDMIX CHAMPION ligr-live-score MLB IMG_FOOTBALL CRIONET_TENNIS SPORT_RADAR_FOOTBALL

id

required

string

Example

{
  "dataProvider": {
    "name": "RB"
  }
}

400

Request is invalid

Media typeapplication/json

object

message

required

string

details

required

object

key

additional properties

Example^generated

{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Missing or invalid api key

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Api key provides insufficient access for the request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

404

Venue not found

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

429

Api key has made too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

An unexpected error has occured. If problems persist please contact support

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}