Skip to main content

List Chapters

GET
Retrieve a paginated list of OWASP chapters.

Query Parameters

country
string
Filter chapters by country name.Example: United States, United Kingdom, India
latitude_gte
float
Filter chapters with latitude greater than or equal to the specified value.Example: 40.0 (chapters at or above 40° North)
latitude_lte
float
Filter chapters with latitude less than or equal to the specified value.Example: 50.0 (chapters at or below 50° North)
longitude_gte
float
Filter chapters with longitude greater than or equal to the specified value.Example: -10.0
longitude_lte
float
Filter chapters with longitude less than or equal to the specified value.Example: 30.0
ordering
string
Sort results by field. Prefix with - for descending order.
  • created_at - Creation date (ascending)
  • -created_at - Creation date (descending)
  • updated_at - Last update date (ascending)
  • -updated_at - Last update date (descending)
  • latitude - Latitude (ascending)
  • -latitude - Latitude (descending)
  • longitude - Longitude (ascending)
  • -longitude - Longitude (descending)
Default: -created_at
page
integer
Page number for pagination. Default: 1
limit
integer
Number of results per page. Default: 100

Response Schema

items
array
Array of chapter objects
count
integer
Total number of chapters matching the filter

Examples

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

# Filter by country
curl -X GET "https://nest.owasp.org/api/v0/chapters/?country=United%20States"

# Filter by geographic bounds (European region)
curl -X GET "https://nest.owasp.org/api/v0/chapters/?latitude_gte=35&latitude_lte=70&longitude_gte=-10&longitude_lte=40"

# Sort by latitude (northernmost first)
curl -X GET "https://nest.owasp.org/api/v0/chapters/?ordering=-latitude"

# Pagination
curl -X GET "https://nest.owasp.org/api/v0/chapters/?page=1&limit=20"

Get Chapter

GET
Retrieve detailed information about a specific OWASP chapter.

Path Parameters

chapter_id
string
required
Chapter identifier. Can be provided with or without the www-chapter- prefix.Examples:
  • London
  • www-chapter-London
  • New-York
  • www-chapter-New-York

Response Schema

created_at
datetime
ISO 8601 timestamp when the chapter was created
key
string
Unique chapter identifier (nest_key)
latitude
float
Geographic latitude of the chapter location
longitude
float
Geographic longitude of the chapter location
name
string
Chapter name
updated_at
datetime
ISO 8601 timestamp when the chapter was last updated
country
string
Country where the chapter is located
leaders
array
Array of chapter leaders
region
string
Geographic region of the chapter

Error Responses

404 Not Found
object

Examples

# Get chapter by key (without prefix)
curl -X GET "https://nest.owasp.org/api/v0/chapters/London"

# Get chapter by key (with prefix)
curl -X GET "https://nest.owasp.org/api/v0/chapters/www-chapter-London"

# Get New York chapter
curl -X GET "https://nest.owasp.org/api/v0/chapters/New-York"

Build docs developers (and LLMs) love