Skip to main content

List Labels

GET
Retrieve a paginated list of GitHub labels.

Query Parameters

color
string
Filter labels by color hex code (without #).Example: d93f0b
ordering
string
Sort results by field. Prefix with - for descending order.
  • nest_created_at - Creation date (ascending)
  • -nest_created_at - Creation date (descending)
  • nest_updated_at - Last update date (ascending)
  • -nest_updated_at - Last update date (descending)
page
integer
Page number for pagination. Default: 1
limit
integer
Number of results per page. Default: 100

Response Schema

items
array
Array of label objects
count
integer
Total number of labels matching the filter

Examples

# List all labels
curl -X GET "https://nest.owasp.org/api/v0/labels/"

# Filter by color
curl -X GET "https://nest.owasp.org/api/v0/labels/?color=d93f0b"

# Sort by creation date (newest first)
curl -X GET "https://nest.owasp.org/api/v0/labels/?ordering=-nest_created_at"

# Sort by update date (most recently updated first)
curl -X GET "https://nest.owasp.org/api/v0/labels/?ordering=-nest_updated_at"

# Combine filter and pagination
curl -X GET "https://nest.owasp.org/api/v0/labels/?color=d93f0b&page=1&limit=20"

Build docs developers (and LLMs) love