LogoLogo
About Us
  • PLAYING THE SANDBOX
    • Get Started
    • Sandbox - Upland Sign Up
    • Buying Upx
  • Sign Up & Authentication
    • 1. Developer's Sign Up
    • 2. Connecting Upland Account
  • Application Management
    • Third-Party Applications
      • Device Checking
    • Inactivating an Application
    • Activating an Application
    • Dev Shops
    • Permission Delegation
  • API Definitions
    • API Information - Sandbox
    • API Information - Production
    • Upland Users Authentication
    • Upland User Information
    • Escrow Container Management
    • Tournament APIs
    • Generic Endpoints
    • Webhooks Notifications
    • Upland Appchain
  • Release Notes
    • September - 21st
    • August - 23rd
    • August - 10th
    • July - 10th
    • July - 3rd
    • April - 27th
    • April - 13th
    • April - 6th
Powered by GitBook
On this page
  1. API Definitions

Generic Endpoints

PreviousTournament APIsNextWebhooks Notifications

Last updated 1 year ago

API Definition

These endpoints require Basic Authentication. Click here to read more about how to generate valid credentials.

List all tracks

get

List all avaiblable tracks.

Authorizations
Query parameters
cityNamestringOptional
includePathbooleanOptional
Responses
200Success
application/json
404
Tracks not found.
get
GET /tracks HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
{
  "tracks": [
    {
      "id": 1,
      "name": "text",
      "path": [
        []
      ]
    }
  ]
}

Retrieve track's information

get

Retrieve track's information given an track ID.

Authorizations
Path parameters
idnumberRequired
Responses
200Success
application/json
400
Bad request or invalid query parameters
404
Track not found.
get
GET /tracks/{id} HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
{
  "id": 1,
  "name": "text",
  "path": [
    []
  ],
  "center": [
    1
  ],
  "boundaries": [
    []
  ]
}

Retrieve buildings on a track

get

That endpoint will return all the constructions along the selected track

Authorizations
Path parameters
idnumberRequired
Responses
200Success
application/json
404
Buildings not found.
get
GET /tracks/{id}/buildings HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
{
  "buildings": [
    {
      "id": 1,
      "model_id": 1,
      "name": "text",
      "model": "text",
      "lat": 1,
      "lng": 1,
      "rotate": [
        []
      ],
      "scale": 1,
      "altitude": 1,
      "meshes": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

List availables cities

get
Authorizations
Responses
200Success
application/json
get
GET /cities HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
200Success
{
  "cities": [
    {
      "id": 1,
      "name": "text",
      "stateName": "text",
      "countryName": "text"
    }
  ]
}

List available properties given a city id

get
Authorizations
Query parameters
currentPagenumberRequired
pageSizenumberRequired
cityIdnumberRequired
Responses
200Success
application/json
get
GET /properties?currentPage=1&pageSize=1&cityId=1 HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
200Success
{
  "currentPage": 1,
  "pageSize": 1,
  "totalResults": 1,
  "results": [
    {
      "id": 1,
      "address": "text",
      "city": "text",
      "neighborhood": {
        "id": 1,
        "name": "text"
      }
    }
  ]
}

List neighborhoods

get
Authorizations
Query parameters
cityIdnumberOptional

Filter by city id

Example: 9
textSearchstringOptional

Text search on neighborhood name

Example: South
Responses
200Success
application/json
get
GET /neighborhoods HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
200Success
{
  "results": [
    {
      "id": 790,
      "name": "SOUTH SAN LAUREN",
      "cityId": 9,
      "area": 5770832.01833196,
      "boundaries": [
        [
          [
            -119.092011,
            35.383382
          ],
          [
            -119.061756,
            35.383242
          ],
          [
            -119.061499,
            35.396887
          ],
          [
            -119.056263,
            35.404932
          ],
          [
            -119.054632,
            35.412347
          ],
          [
            -119.069953,
            35.412452
          ],
          [
            -119.069953,
            35.410249
          ],
          [
            -119.069395,
            35.410109
          ],
          [
            -119.069266,
            35.405562
          ],
          [
            -119.067249,
            35.405562
          ],
          [
            -119.067421,
            35.401504
          ],
          [
            -119.074416,
            35.401539
          ],
          [
            -119.074287,
            35.394158
          ],
          [
            -119.092312,
            35.394333
          ],
          [
            -119.092269,
            35.38786
          ],
          [
            -119.092011,
            35.383382
          ]
        ]
      ],
      "center": [
        -119.07175840309523,
        35.394906456318544
      ]
    },
    {
      "id": 403,
      "name": "SOUTH SLOPE",
      "city_id": 6,
      "area": 1032113.16342545,
      "boundaries": [
        [
          [
            -73.984533,
            40.663241
          ],
          [
            -73.991632,
            40.666691
          ],
          [
            -73.992738,
            40.665446
          ],
          [
            -73.99719,
            40.668009
          ],
          [
            -73.99925,
            40.669181
          ],
          [
            -74.00013,
            40.667912
          ],
          [
            -74.002018,
            40.667212
          ],
          [
            -74.003284,
            40.666496
          ],
          [
            -74.004625,
            40.665264
          ],
          [
            -73.995173,
            40.659643
          ],
          [
            -73.992963,
            40.658325
          ],
          [
            -73.992394,
            40.658878
          ],
          [
            -73.990152,
            40.6576
          ],
          [
            -73.988392,
            40.659204
          ],
          [
            -73.986414,
            40.6612
          ],
          [
            -73.98586,
            40.661759
          ],
          [
            -73.985449,
            40.662221
          ],
          [
            -73.984533,
            40.663241
          ]
        ]
      ],
      "center": [
        -73.99431534202182,
        40.66341009993273
      ]
    }
  ]
}

List collections

get
Authorizations
Responses
200Success
application/json
get
GET /collections HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
200Success
{
  "results": [
    {
      "id": 1,
      "name": "King of the Street",
      "amount": 3,
      "rarityLevel": 1,
      "description": "Standard Collection",
      "requirements": "Own 3 properties on the same street",
      "yieldBoost": 1.3,
      "oneTimeReward": 950,
      "image": "https://static.upland.me/collections-assets/king_of_the_street-1-banner.png",
      "imageThumbnail": "https://static.upland.me/collections-assets/king_of_the_street-1-thumbnail.png",
      "cityId": null
    },
    {
      "id": 2,
      "name": "Mission District",
      "amount": 3,
      "rarityLevel": 2,
      "description": "Limited collection",
      "requirements": "Own 3 properties in the Mission District in SF",
      "yieldBoost": 1.4,
      "oneTimeReward": 1300,
      "image": "https://static.upland.me/collections-assets/mission_district-2-banner.png",
      "imageThumbnail": "https://static.upland.me/collections-assets/mission_district-2-thumbnail.png",
      "cityId": 1
    }
  ]
}

List Treasures History

get
Authorizations
Query parameters
currentPagenumberRequired
pageSizenumberRequired
cityIdnumberOptional

Filter by city id

Example: 1
Responses
200Success
application/json
get
GET /treasures-history?currentPage=1&pageSize=1 HTTP/1.1
Host: 
Authorization: Basic username:password
Accept: */*
200Success
{
  "results": {
    "results": [
      {
        "userName": "elenchusis",
        "reward": 13125,
        "lockedAt": "2022-06-02T00:08:57.299Z",
        "spawnAt": "2022-05-20T13:38:59.604Z",
        "fullAddress": "682 LISBON ST, San Francisco, CA",
        "treasureType": "box"
      },
      {
        "userName": "vladp_p9",
        "reward": 3369,
        "lockedAt": "2022-05-24T08:58:47.492Z",
        "spawnAt": "2022-05-23T12:46:13.583Z",
        "fullAddress": "2159 47TH AVE, San Francisco, CA",
        "treasureType": "pinata"
      }
    ]
  }
}
  • API Definition
  • GETList all tracks
  • GETRetrieve track's information
  • GETRetrieve buildings on a track
  • POSTRetrieve buildings given some boundaries
  • GETList availables cities
  • GETList available properties given a city id
  • GETList neighborhoods
  • GETList collections
  • GETList Treasures History

Retrieve buildings given some boundaries

post

Each boundary contains a list of coordinates as the example below.

Authorizations
Body
Responses
200
Buildings
application/json
post
POST /buildings HTTP/1.1
Host: 
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "boundaries": [
    []
  ]
}
200

Buildings

{
  "buildings": [
    {
      "id": 1,
      "model_id": 1,
      "name": "text",
      "model": "text",
      "lat": 1,
      "lng": 1,
      "rotate": [
        []
      ],
      "scale": 1,
      "altitude": 1,
      "meshes": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}