Label Types API #

The Label Types API lists the different types of labels used in Project Sidewalk, including the name, description, associated icon images, and color codes. For each label, users can also assign one or more optional tags, which provides additional information about the sidewalk feature or barrier.

This Label Types API endpoint is useful for applications that want to display Project Sidewalk data with consistent styling, or for developers who need to understand the classification system used in our other APIs.

Label Types API Preview #

Below is a live preview of the primary label types retrieved directly from the API:

Loading label types data...

Endpoint #

Retrieve a list of all label types with their metadata.

GET /v3/api/labelTypes

Examples#

/v3/api/labelTypes Get all label types in JSON

Quick Download #

Download label types data directly in JSON:

Preparing your download...

This should only take a few seconds.

Responses#

Success Response (200 OK)#

On success, the API returns an HTTP 200 OK status code and a JSON object containing an array of label types.

{
  "status": "OK",
  "label_types": [
    {
      "id": 1,
      "name": "CurbRamp",
      "description": "Curb ramp connecting sidewalk to street",
      "icon_url": "/assets/images/icons/label_type_icons/CurbRamp.png",
      "small_icon_url": "/assets/images/icons/label_type_icons/CurbRamp_small.png",
      "tiny_icon_url": "/assets/images/icons/label_type_icons/CurbRamp_tiny.png",
      "color": "#90C31F",
      "is_primary": true,
      "is_primary_validate": true
    },
    {
      "id": 2,
      "name": "NoCurbRamp",
      "description": "Missing curb ramp",
      "icon_url": "/assets/images/icons/label_type_icons/NoCurbRamp.png",
      "small_icon_url": "/assets/images/icons/label_type_icons/NoCurbRamp_small.png",
      "tiny_icon_url": "/assets/images/icons/label_type_icons/NoCurbRamp_tiny.png",
      "color": "#E679B6",
      "is_primary": true,
      "is_primary_validate": true
    },
    // ... more label types
  ]
}

Response Fields #

Field	Type	Description
`status`	`string`	Always "OK" for successful responses.
`label_types`	`array`	Array of label type objects.
`label_types[].id`	`integer`	Unique identifier for the label type.
`label_types[].name`	`string`	Name of the label type (e.g., "CurbRamp", "Obstacle").
`label_types[].description`	`string`	Human-readable description of the label type.
`label_types[].icon_url`	`string`	Path to the standard icon image for this label type.
`label_types[].small_icon_url`	`string`	Path to the small icon image for this label type.
`label_types[].tiny_icon_url`	`string`	Path to the minimap/tiny icon image for this label type.
`label_types[].color`	`string`	Hex color code (e.g., "#90C31F") associated with this label type.
`label_types[].is_primary`	`boolean`	Whether this is a primary label type in the Project Sidewalk system.
`label_types[].is_primary_validate`	`boolean`	Whether this label type is included in primary validation tasks.

Error Responses#

If an error occurs, the API will return an appropriate HTTP status code and a JSON response body containing details about the error.

500 Internal Server Error: An unexpected error occurred on the server.
503 Service Unavailable: The server is temporarily unable to handle the request (e.g., during maintenance).

Error Response Body #

All errors are returned as RFC 7807 “problem details” with the application/problem+json content type and the following structure:

{
  "type": "about:blank",          // RFC 7807 problem-type URI ("about:blank" means no type beyond the status)
  "title": "Invalid Parameter",   // Short, human-readable summary of the problem type (stable for a given code)
  "status": 400,                  // HTTP status code (also repeated in the body)
  "detail": "Invalid value for the bbox parameter. Expected format: minLng,minLat,maxLng,maxLat.", // This occurrence
  "code": "INVALID_PARAMETER",    // Stable, machine-readable error code you can branch on
  "parameter": "bbox"             // Extension member: the specific parameter at fault (omitted when not applicable)
}

Terms of Use #

If you use Project Sidewalk data in your research, please cite the following paper (awarded 🏆 Best Paper at CHI 2019):

Manaswi Saha, Michael Saugstad, Hanuma Teja Maddali, Aileen Zeng, Ryan Holland, Steven Bower, Aditya Dash, Sage Chen, Anthony Li, Kotaro Hara, and Jon Froehlich. 2019. Project Sidewalk: A Web-based Crowdsourcing Tool for Collecting Sidewalk Accessibility Data At Scale. In Proceedings of the 2019 CHI Conference on Human Factors in Computing Systems (CHI '19). Association for Computing Machinery, New York, NY, USA, Paper 62, 1–14.

Contribute#

Project Sidewalk is an open-source project created by the Makeability Lab and hosted on GitHub. We welcome your contributions! If you found a bug or have a feature request, please open an issue on GitHub.

You can also email us at sidewalk@cs.uw.edu

Project Sidewalk in Your City!#

If you are interested in bringing Project Sidewalk to your city, please read our Wiki page.