ETSI

ETSI NGSI-LD API (ISG CIM)

The NGSI-LD API standardised by ETSI ISG CIM in GS CIM 009, a JSON-LD context information management API for entities, attributes, relationships, subscriptions, temporal queries, entity types, context source registration and distributed federation. It is the API layer beneath most European smart-city and FIWARE deployments and is published as OpenAPI 3.0.3 and 3.1.0.

GitHub OpenAPI

Operations 49

POST /entities Entity creation #
GET /entities Query entities #
GET /entities/{entityId} Entity retrieval by id #
DELETE /entities/{entityId} Entity deletion by id #
PATCH /entities/{entityId} Entity merge by id #
PUT /entities/{entityId} Entity replacement by id #
POST /entities/{entityId}/attrs Append Attributes to Entity #
PATCH /entities/{entityId}/attrs Update Attributes of an Entity #
PATCH /entities/{entityId}/attrs/{attrId} Partial Attribute Update #
DELETE /entities/{entityId}/attrs/{attrId} Attribute delete #
PUT /entities/{entityId}/attrs/{attrId} Attribute replace #
POST /csourceRegistrations Csource registration creation #
GET /csourceRegistrations Discover Csource registrations #
GET /csourceRegistrations/{registrationId} Csource registration retrieval by id #
PATCH /csourceRegistrations/{registrationId} Csource registration update by id #
DELETE /csourceRegistrations/{registrationId} Csource registration deletion by id #
POST /subscriptions Create Subscription #
GET /subscriptions Retrieve list of Subscriptions #
GET /subscriptions/{subscriptionId} Subscription retrieval by id #
PATCH /subscriptions/{subscriptionId} Subscription update by id #
DELETE /subscriptions/{subscriptionId} Subscription deletion by id #
POST /csourceSubscriptions Create subscription to Csource registration #
GET /csourceSubscriptions Retrieval of list of subscriptions to Csource registrations #
GET /csourceSubscriptions/{subscriptionId} Csource registration subscription update by id #
PATCH /csourceSubscriptions/{subscriptionId} Csource registration subscription update by id #
DELETE /csourceSubscriptions/{subscriptionId} Csource registration subscription deletion by id #
POST /entityOperations/create Batch Entity Creation #
POST /entityOperations/upsert Batch Entity Creation or Update (Upsert) #
POST /entityOperations/update Batch Entity Update #
POST /entityOperations/delete Batch Entity Delete #
POST /entityOperations/query Query entities based on POST #
POST /entityOperations/merge Batch Entity Merge #
POST /temporal/entities Temporal Representation of Entity creation #
GET /temporal/entities Query temporal evolution of Entities #
GET /temporal/entities/{entityId} Temporal Representation of Entity retrieval by id #
DELETE /temporal/entities/{entityId} Temporal Representation of Entity deletion by id #
POST /temporal/entities/{entityId}/attrs Temporal Representation of Entity Attribute instance addition #
DELETE /temporal/entities/{entityId}/attrs/{attrId} Attribute from Temporal Representation of Entity deletion #
PATCH /temporal/entities/{entityId}/attrs/{attrId}/{instanceId} Attribute Instance update #
DELETE /temporal/entities/{entityId}/attrs/{attrId}/{instanceId} Attribute Instance deletion by instance id #
POST /temporal/entityOperations/query Temporal Representation of Entity Query based on POST #
GET /types Retrieve available entity types #
GET /types/{type} Details about available entity type #
GET /attributes Available attributes #
GET /attributes/{attrId} Details about available attribute #
POST /jsonldContexts Add a user @context to the internal cache #
GET /jsonldContexts List all cached @contexts #
GET /jsonldContexts/{contextId} Serve one specific user @context #
DELETE /jsonldContexts/{contextId} Delete one specific @context from internal cache, possibly re-inserting a freshly downloaded copy of it #

Documentation

📖
Documentation
https://www.etsi.org/technologies/context-information-management
📖
APIReference
https://forge.etsi.org/rep/cim/ngsi-ld-openapi

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/etsi/refs/heads/main/openapi/ngsi-ld/ngsi-ld-api-3.0.3.yaml
⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/etsi/refs/heads/main/openapi/ngsi-ld/ngsi-ld-api-3.1.0.yaml

Other Resources

🔗
Repository
https://forge.etsi.org/rep/cim/ngsi-ld-openapi
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/etsi/refs/heads/main/overlays/etsi-ngsi-ld-overlay.yaml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/etsi/refs/heads/main/skills/etsi-ngsi-ld-manage-context-entities.md

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ngsi-ld"
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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ngsi-ld-api-3.0.3.yaml Raw ↑ 
openapi: 3.0.3
info:
  title: NGSI-LD OAS
  version: 1.7.1
  description: OpenAPI Specification for NGSI-LD API.
  contact:
    url: https://www.etsi.org/committee/cim
  license:
    name: BSD-3-Clause
    url: https://forge.etsi.org/legal-matters

externalDocs:
  description: ETSI GS CIM 009 V1.7.1 Context Information Management (CIM); NGSI-LD API
  url: https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.07.01_60/gs_CIM009v010701p.pdf

servers:


# --- truncated at 32 KB (192 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/etsi/refs/heads/main/openapi/ngsi-ld/ngsi-ld-api-3.0.3.yaml