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/samsung-locations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: Samsung SmartThings Apps Locations API
description: 'The SmartThings REST API provides programmatic access to the SmartThings platform for controlling connected devices, creating automations, managing locations, rooms, scenes, and building smart home integrations. Supports OAuth 2.0 Bearer tokens and personal access tokens. Base URL: https://api.smartthings.com/v1.'
version: 1.0.0
contact:
name: SmartThings Developer Support
url: https://developer.smartthings.com/
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://api.smartthings.com/v1
description: SmartThings REST API
security:
- BearerAuth: []
tags:
- name: Locations
description: Location and room management.
paths:
/locations:
get:
operationId: listLocations
summary: List Locations
description: Returns all SmartThings locations accessible to the authenticated user.
tags:
- Locations
parameters:
- name: pageToken
in: query
required: false
description: Pagination cursor.
schema:
type: string
responses:
'200':
description: List of locations.
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Location'
_links:
$ref: '#/components/schemas/Links'
'401':
description: Unauthorized.
post:
operationId: createLocation
summary: Create Location
description: Creates a new SmartThings location.
tags:
- Locations
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateLocationRequest'
responses:
'200':
description: Location created.
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
'401':
description: Unauthorized.
'422':
description: Validation error.
/locations/{locationId}:
get:
operationId: getLocation
summary: Get Location
description: Returns details for a specific SmartThings location.
tags:
- Locations
parameters:
- $ref: '#/components/parameters/LocationIdParam'
responses:
'200':
description: Location details.
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
'401':
description: Unauthorized.
'404':
description: Location not found.
put:
operationId: updateLocation
summary: Update Location
description: Updates a SmartThings location's properties.
tags:
- Locations
parameters:
- $ref: '#/components/parameters/LocationIdParam'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateLocationRequest'
responses:
'200':
description: Location updated.
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
'401':
description: Unauthorized.
'404':
description: Location not found.
delete:
operationId: deleteLocation
summary: Delete Location
description: Deletes a SmartThings location and all associated devices and automations.
tags:
- Locations
parameters:
- $ref: '#/components/parameters/LocationIdParam'
responses:
'200':
description: Location deleted.
'401':
description: Unauthorized.
'404':
description: Location not found.
/locations/{locationId}/rooms:
get:
operationId: listRooms
summary: List Rooms
description: Returns all rooms within a SmartThings location.
tags:
- Locations
parameters:
- $ref: '#/components/parameters/LocationIdParam'
responses:
'200':
description: List of rooms.
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Room'
'401':
description: Unauthorized.
'404':
description: Location not found.
post:
operationId: createRoom
summary: Create Room
description: Creates a new room within a SmartThings location.
tags:
- Locations
parameters:
- $ref: '#/components/parameters/LocationIdParam'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
description: Room name.
responses:
'200':
description: Room created.
content:
application/json:
schema:
$ref: '#/components/schemas/Room'
'401':
description: Unauthorized.
components:
schemas:
Room:
type: object
description: A room within a SmartThings location.
properties:
roomId:
type: string
format: uuid
description: Unique room identifier.
locationId:
type: string
format: uuid
description: Location this room belongs to.
name:
type: string
description: Room name.
backgroundImage:
type: string
description: Room background image URL.
Links:
type: object
description: Pagination links.
properties:
next:
type: object
properties:
href:
type: string
description: URL to the next page.
previous:
type: object
properties:
href:
type: string
description: URL to the previous page.
CreateLocationRequest:
type: object
required:
- name
properties:
name:
type: string
description: Location name.
countryCode:
type: string
description: ISO 3166-1 alpha-3 country code.
latitude:
type: number
format: double
longitude:
type: number
format: double
regionRadius:
type: integer
description: Geofence radius in meters.
temperatureScale:
type: string
enum:
- F
- C
timeZoneId:
type: string
description: IANA time zone ID.
locale:
type: string
Location:
type: object
description: A SmartThings location (home, office, etc.).
properties:
locationId:
type: string
format: uuid
description: Unique location identifier.
name:
type: string
description: Location name.
countryCode:
type: string
description: ISO 3166-1 alpha-3 country code.
latitude:
type: number
format: double
description: Location latitude.
longitude:
type: number
format: double
description: Location longitude.
regionRadius:
type: integer
description: Geofence radius in meters.
temperatureScale:
type: string
enum:
- F
- C
description: Temperature unit preference.
timeZoneId:
type: string
description: IANA time zone ID (e.g., America/Chicago).
locale:
type: string
description: BCP 47 locale tag.
parameters:
LocationIdParam:
name: locationId
in: path
required: true
description: Unique location identifier (UUID).
schema:
type: string
format: uuid
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: OAuth 2.0 Bearer token or SmartThings personal access token. Obtain tokens at https://account.smartthings.com/tokens.