Telia Company Retrieve Geographic Site API
Retrieves detailed information for a specific geographic site using its ID.
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/telia-retrievegeographicsite-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
version: 1.0.1
title: B2X-Global-SiteManagement-API-v1 Retrieve Geographic Site API
description: '**This file forms part of MEF 122**
This API implements Business Requirements described in MEF 79
It allows to retrieve a list of Geographic Sites and to get all
information for one geographic site.
List of supported Use Cases:
- Retrieve Service Site List
- Retrieve Service Site by Identifier
Copyright 2021 MEF Forum and its contributors
This file includes content based on the TM Forum Geographic Site API (TMF674
v4.0.0) available at https://github.com/tmforum-apis/TMF674_GeographicSite,
which is licensed by the TM Forum under the Apache License version 2.0. Such
content has been modified by the MEF Forum and its contributors.
'
servers:
- url: https://api-garden.teliacompany.com/v1/api/mef/geographicSiteManagement
description: Production
- url: https://api-garden-test.teliacompany.com/v1/api/mef/geographicSiteManagement
description: Test
- url: https://api-garden.teliacompany.com/sandbox/v1/api/mef/geographicSiteManagement
description: Sandbox
security:
- prodBearerAuth: []
- testBearerAuth: []
tags:
- name: retrieveGeographicSite
description: Retrieves detailed information for a specific geographic site using its ID.
paths:
/{country}/geographicSite/{id}:
get:
operationId: retrieveGeographicSite
summary: Retrieve geographic site by ID
description: 'Retrieves detailed information for a specific geographic site using its ID.
'
tags:
- retrieveGeographicSite
parameters:
- name: country
in: path
required: true
description: Country selector for the address operation.
schema:
type: string
enum:
- se
- fi
- global
examples:
Sweden:
summary: Sweden
value: se
Finland:
summary: Finland
value: fi
Global:
summary: Global
value: global
- name: id
in: path
required: true
schema:
type: integer
description: Unique identifier of the geographic site.
responses:
'200':
description: Successful retrieval of a site
content:
application/json:
schema:
$ref: '#/components/schemas/GeographicSite'
examples:
GetSiteById:
summary: Get Site Sweden by ID
value:
id: 105839411
siteCompanyName: Telia
additionnalSiteInformation: '{"siteId":"N229 NTP 001","category":"OnNet"}'
status: EXISTING
fieldedAddress:
id: 105839411
streetNr: '10'
streetName: KRISTINAGATAN
postcode: '60226'
city: NORRKÖPING
stateOrProvince: ÖSTERGÖTLANDS LÄN
country: SE
geographicLocation:
id: 105839411
spatialRef: WGS84
geographicPoint:
- latitude: '58.591864'
longitude: '16.190793'
geographicSubAdress:
- id: 105839411
buildingName: '161614704'
subUnit:
- subUnitType: business
subUnitIdentifier: '1302'
- id: 105839411
buildingName: '161304865'
subUnit:
- subUnitType: flat
subUnitIdentifier: 1581110-2001
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error400'
examples:
BadRequestExample:
summary: Example bad request error
value:
code: '400'
reason: Bad Request
message: Mandatory field siteId is missing from path parameters
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error401'
examples:
UnauthorizedExample:
summary: Example unauthorized error
value:
code: '401'
reason: Unauthorized
message: Error while authenticating TMF
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error403'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error404'
examples:
NotFoundExample:
summary: Example not found error
value:
code: '404'
reason: Not Found
message: Site not found
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error500'
examples:
InternalServerErrorExample:
summary: Example internal server error
value:
code: '500'
reason: Internal Server Error
message: Error occurred while calling the API
'503':
description: Service Unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/Error503'
examples:
ServiceUnavailableExample:
summary: Example service unavailable error
value:
code: '503'
reason: Service Unavailable
message: Service Unavailable
components:
schemas:
Error403:
type: object
properties:
code:
type: string
example: '403'
reason:
type: string
example: Forbidden
message:
type: string
example: Access to the requested resource is denied
required:
- code
- reason
GeographicLocation:
type: object
properties:
id:
type: integer
spatialRef:
type: string
geographicPoint:
type: array
items:
$ref: '#/components/schemas/GeographicPoint'
required:
- id
- spatialRef
- geographicPoint
additionalProperties: false
GeographicSubAdress:
type: object
properties:
id:
type: integer
buildingName:
type: string
levelType:
type: string
levelNumber:
type: string
subUnit:
type: array
items:
$ref: '#/components/schemas/SubUnit'
required:
- id
- buildingName
- subUnit
additionalProperties: false
Error404:
type: object
properties:
code:
type: string
example: '404'
reason:
type: string
example: Not Found
message:
type: string
example: Site not found
required:
- code
- reason
Error401:
type: object
properties:
code:
type: string
example: '401'
reason:
type: string
example: Unauthorized
message:
type: string
example: Error while authenticating TMF
required:
- code
- reason
Error400:
type: object
properties:
code:
type: string
example: '400'
reason:
type: string
example: Bad Request
message:
type: string
example: Mandatory field siteId is missing from path parameters
required:
- code
- reason
Error500:
type: object
properties:
code:
type: string
example: '500'
reason:
type: string
example: Internal Server Error
message:
type: string
example: Error occurred while calling the API
required:
- code
- reason
GeographicPoint:
type: object
properties:
latitude:
type: string
longitude:
type: string
required:
- latitude
- longitude
additionalProperties: false
Error503:
type: object
properties:
code:
type: string
example: '503'
reason:
type: string
example: Service Unavailable
message:
type: string
example: Service Unavailable
required:
- code
- reason
FieldedAddress:
type: object
properties:
id:
type: integer
streetNr:
type: string
streetName:
type: string
postcode:
type: string
city:
type: string
stateOrProvince:
type: string
country:
type: string
required:
- id
- streetNr
- streetName
- postcode
- city
- stateOrProvince
- country
additionalProperties: false
GeographicSite:
type: object
properties:
id:
type: integer
example: 105839411
siteCompanyName:
type: string
example: Telia
additionnalSiteInformation:
type: string
example: '{"siteId":"N229 NTP 001","category":"OnNet"}'
status:
type: string
example: EXISTING
fieldedAddress:
$ref: '#/components/schemas/FieldedAddress'
geographicLocation:
$ref: '#/components/schemas/GeographicLocation'
geographicSubAdress:
type: array
items:
$ref: '#/components/schemas/GeographicSubAdress'
required:
- id
- siteCompanyName
- additionnalSiteInformation
- status
- fieldedAddress
- geographicLocation
- geographicSubAdress
additionalProperties: false
SubUnit:
type: object
properties:
subUnitType:
type: string
subUnitIdentifier:
type:
- string
- 'null'
required:
- subUnitType
additionalProperties: false
securitySchemes:
prodBearerAuth:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://api-garden.teliacompany.com/v4/oauth/client_credential/accesstoken
scopes: {}
description: Token endpoint for the production environment
testBearerAuth:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://api-garden-test.teliacompany.com/v4/oauth/client_credential/accesstoken
scopes: {}
description: Token endpoint for all test environments
x-project-id: B2X-Global-SiteManagement-API-v1