Overflow Locations API
The Locations API from Overflow — 2 operation(s) for locations.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/overflow:overflow-locations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Overflow Open Locations API
description: 'The documentation for the Overflow Open APIs.
To access the OpenAPI spec in JSON/YAML format, navigate to:
* `/api/docs/openapi.json`
* `/api/docs/openapi.yaml`'
version: '3.0'
contact: {}
servers:
- url: https://server.stage.overflow.co
description: API server
tags:
- name: Locations
paths:
/api/v3/locations:
get:
description: Returns locations for a nonprofit based on the provided filters.
operationId: OpenApiLocationsController_getLocations
parameters:
- name: limit
required: false
in: query
description: The number of locations to return.
schema:
minimum: 1
maximum: 100
default: 25
type: number
- name: page
required: false
in: query
description: The page number of the locations to return.
schema:
minimum: 1
default: 1
type: number
- name: includeArchived
required: false
in: query
description: Whether to include locations that have been archived.
schema:
type: boolean
- name: sortBy
required: false
in: query
description: The field to sort the locations by.
schema:
default: displayOrder
example: displayOrder
enum:
- name
- createdAt
- displayOrder
type: string
- name: sortDirection
required: false
in: query
description: The direction to sort the locations by.
schema:
default: ASC
example: ASC
enum:
- ASC
- DESC
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetLocationsResponse'
security:
- ClientId: []
ApiKey: []
summary: Get Locations
tags:
- Locations
/api/v3/locations/{locationId}:
get:
description: Returns a location for the given ID.
operationId: OpenApiLocationsController_getLocationById
parameters:
- name: locationId
required: true
in: path
description: The Id of the location to get.
schema:
example: 2ea1ae03ca521e437db76d76
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/GetLocationByIdResponse'
'404':
description: Location not found.
security:
- ClientId: []
ApiKey: []
summary: Get Location
tags:
- Locations
components:
schemas:
GetLocationByIdResponse:
type: object
properties:
data:
type: object
properties:
id:
type: string
description: Location Id
example: 7710f34fd5061afeec3eab59
createdAt:
type: string
format: date-time
description: Location created at
example: '2025-01-01T00:00:00.000Z'
updatedAt:
type: string
format: date-time
description: Location updated at
example: '2025-01-01T00:00:00.000Z'
archivedAt:
type:
- string
- 'null'
format: date-time
description: Location archived at
example: null
name:
type: string
description: Location name
example: Main Campus
hideFromDonors:
default: false
type: boolean
description: Whether this location is hidden from donors
isDefaultLocation:
default: false
type: boolean
description: Whether this location is the default or fallback location.
required:
- id
- createdAt
- updatedAt
- archivedAt
- name
description: Location for the given id.
required:
- data
GetLocationsResponse:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
description: Location Id
example: 7710f34fd5061afeec3eab59
createdAt:
type: string
format: date-time
description: Location created at
example: '2025-01-01T00:00:00.000Z'
updatedAt:
type: string
format: date-time
description: Location updated at
example: '2025-01-01T00:00:00.000Z'
archivedAt:
type:
- string
- 'null'
format: date-time
description: Location archived at
example: null
name:
type: string
description: Location name
example: Main Campus
hideFromDonors:
default: false
type: boolean
description: Whether this location is hidden from donors
isDefaultLocation:
default: false
type: boolean
description: Whether this location is the default or fallback location.
required:
- id
- createdAt
- updatedAt
- archivedAt
- name
description: List of locations.
totalCount:
type: number
description: Total number of locations matching the filters.
example: 10
required:
- data
- totalCount
securitySchemes:
ApiKey:
type: apiKey
in: header
name: x-api-key
description: API Key for API authentication
ClientId:
type: apiKey
in: header
name: x-client-id
description: Client ID for API authentication
x-provenance:
method: harvested
publisher: Overflow
source: https://server.stage.overflow.co/api/docs/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)