Open Concept Lab (OCL) Concepts API
The concepts API from Open Concept Lab (OCL) — 3 operation(s) for concepts.
The concepts API from Open Concept Lab (OCL) — 3 operation(s) for concepts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/openconceptlab:openconceptlab-concepts-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: OCL Concepts API
description: 'OCL API (2.3.250-d17a48ac)
FHIR terminology Swagger.'
version: 2.3.250-d17a48ac
servers:
- url: https://api.openconceptlab.org/
security:
- Basic: []
- Token: []
tags:
- name: concepts
paths:
/concepts/:
parameters: []
get:
operationId: concepts_list
description: ''
parameters:
- name: page
in: query
description: page number
schema:
type: integer
- name: limit
in: query
description: result list size
schema:
type: integer
default: 25
- name: q
in: query
description: search text
schema:
type: string
- name: sortDesc
in: query
description: With q param (last_update, name, best_match)
schema:
type: string
- name: sortAsc
in: query
description: With q param (last_update, name, best_match)
schema:
type: string
- name: verbose
in: query
schema:
type: boolean
default: false
- name: includeRetired
in: query
schema:
type: boolean
default: false
- name: includeInverseMappings
in: query
schema:
type: boolean
default: false
- name: updatedSince
in: query
description: 'format: YYYY-MM-DD HH:MM:SS'
schema:
type: string
- name: INCLUDEFACETS
in: header
schema:
type: boolean
default: false
- name: COMPRESS
in: header
schema:
type: boolean
default: false
- name: INCLUDESEARCHLATEST
in: header
schema:
type: boolean
default: false
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ConceptList'
application/zip:
schema:
type: array
items:
$ref: '#/components/schemas/ConceptList'
application/fhir+json:
schema:
type: array
items:
$ref: '#/components/schemas/ConceptList'
tags:
- concepts
summary: Concepts list
x-summary-source: derived
post:
operationId: concepts_create
description: ''
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ConceptDetail'
application/zip:
schema:
$ref: '#/components/schemas/ConceptDetail'
application/fhir+json:
schema:
$ref: '#/components/schemas/ConceptDetail'
tags:
- concepts
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConceptDetail'
required: true
summary: Concepts create
x-summary-source: derived
/concepts/$match/:
parameters: []
post:
operationId: concepts_$match_create
summary: $match - Find matching concepts
description: Find matching concepts across repositories using structured input data.
parameters:
- name: verbose
in: query
schema:
type: boolean
default: false
- name: includeRetired
in: query
schema:
type: boolean
default: false
- name: limit
in: query
description: result list size
schema:
type: integer
default: 25
- name: page
in: query
description: page number
schema:
type: integer
- name: offset
in: query
description: Number of results to skip per row
schema:
type: integer
default: 0
- name: semantic
in: query
description: Use semantic (LM-based) matching algorithm
schema:
type: boolean
default: false
- name: bestMatch
in: query
description: Apply minimum score threshold, filtering out low-quality matches
schema:
type: boolean
default: false
- name: numCandidates
in: query
description: 'Number of approximate nearest neighbor candidates (semantic only). Max: 3000'
schema:
type: integer
default: 500
- name: kNearest
in: query
description: 'Number of nearest neighbors to return from vector search (semantic only). Max: 100'
schema:
type: integer
default: 100
- name: brief
in: query
description: Return minimal concept fields in results
schema:
type: boolean
default: false
- name: encoder_model
in: query
description: Custom encoder model name for semantic vector search (e.g. BAAI/bge-reranker-v2-m3)
schema:
type: string
- name: reranker
in: query
description: Enable cross-encoder reranking of results (semantic only)
schema:
type: boolean
default: true
responses:
'200':
description: List of matched results per input row
'400':
description: Missing required parameters (rows, target_repo_url/target_repo)
'403':
description: User does not have Mapper access
tags:
- concepts
requestBody:
content:
application/json:
schema:
required:
- rows
type: object
properties:
target_repo_url:
description: Repository URL to match against. Either target_repo_url or target_repo is required.
type: string
target_repo:
description: Alternative to target_repo_url. Object with owner, source, source_version, owner_type fields.
type: object
rows:
description: List of concept-like key-value pairs to match.
type: array
items:
type: object
map_config:
description: Optional list configuring mapping logic per row.
type: array
items:
type: object
filter:
description: Filtering criteria including locale and faceted filters.
type: object
required: true
/concepts/$rerank/:
parameters: []
post:
operationId: concepts_$rerank_create
description: ''
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ConceptList'
application/zip:
schema:
$ref: '#/components/schemas/ConceptList'
application/fhir+json:
schema:
$ref: '#/components/schemas/ConceptList'
tags:
- concepts
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConceptList'
required: true
summary: Concepts $rerank create
x-summary-source: derived
components:
schemas:
LocalizedName:
required:
- name
- locale
type: object
properties:
uuid:
title: Uuid
type: string
readOnly: true
minLength: 1
name:
title: Name
type: string
minLength: 1
external_id:
title: External id
type:
- string
- 'null'
type:
title: Type
type:
- string
- 'null'
locale:
title: Locale
type: string
minLength: 1
locale_preferred:
title: Locale preferred
type: boolean
name_type:
title: Name type
type:
- string
- 'null'
checksum:
title: Checksum
type: string
readOnly: true
retired:
title: Retired
type: boolean
retire_reason:
title: Retire reason
type:
- string
- 'null'
ConceptDetail:
required:
- concept_class
- datatype
- names
type: object
properties:
uuid:
title: Uuid
type: string
readOnly: true
minLength: 1
parent_concept_urls:
type:
- array
- 'null'
items:
type:
- string
- 'null'
extras:
title: Extras
type:
- object
- 'null'
checksums:
title: Checksums
type: object
additionalProperties:
type: string
minLength: 1
readOnly: true
mappings_payload:
type: array
items:
type: object
id:
title: Id
type: string
minLength: 1
external_id:
title: External id
type: string
concept_class:
title: Concept class
type: string
minLength: 1
datatype:
title: Datatype
type: string
minLength: 1
url:
title: Url
type: string
minLength: 1
retired:
title: Retired
type: boolean
source:
title: Source
type: string
readOnly: true
minLength: 1
owner:
title: Owner
type: string
readOnly: true
minLength: 1
owner_type:
title: Owner type
type: string
readOnly: true
minLength: 1
owner_url:
title: Owner url
type: string
format: uri
readOnly: true
minLength: 1
display_name:
title: Display name
type: string
readOnly: true
minLength: 1
display_locale:
title: Display locale
type: string
readOnly: true
minLength: 1
names:
type: array
items:
$ref: '#/components/schemas/LocalizedName'
descriptions:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/LocalizedDescription'
created_on:
title: Created on
type: string
format: date-time
readOnly: true
updated_on:
title: Updated on
type: string
format: date-time
readOnly: true
versions_url:
title: Versions url
type: string
readOnly: true
version:
title: Version
type: string
readOnly: true
minLength: 1
parent_id:
title: Parent id
type: string
format: uuid
type:
title: Type
type: string
readOnly: true
minLength: 1
update_comment:
title: Update comment
type:
- string
- 'null'
version_url:
title: Version url
type: string
readOnly: true
updated_by:
title: Updated by
type: string
format: date-time
readOnly: true
created_by:
title: Created by
type: string
format: date-time
readOnly: true
public_can_view:
title: Public can view
type: string
readOnly: true
versioned_object_id:
title: Versioned object id
type: string
readOnly: true
latest_source_version:
title: Latest source version
type: string
readOnly: true
property:
title: Property
type: object
readOnly: true
retire_reason:
title: Retire reason
type:
- string
- 'null'
LocalizedDescription:
required:
- description
- locale
type:
- object
- 'null'
properties:
uuid:
title: Uuid
type: string
readOnly: true
minLength: 1
description:
title: Description
type: string
minLength: 1
external_id:
title: External id
type:
- string
- 'null'
type:
title: Type
type:
- string
- 'null'
locale:
title: Locale
type: string
minLength: 1
locale_preferred:
title: Locale preferred
type: boolean
description_type:
title: Description type
type:
- string
- 'null'
checksum:
title: Checksum
type: string
readOnly: true
retired:
title: Retired
type: boolean
retire_reason:
title: Retire reason
type:
- string
- 'null'
ConceptList:
required:
- id
- concept_class
- datatype
- source
- owner
- version
type: object
properties:
uuid:
title: Uuid
type: string
readOnly: true
minLength: 1
checksums:
title: Checksums
type: object
additionalProperties:
type: string
minLength: 1
readOnly: true
mappings_payload:
type: array
items:
type: object
id:
title: Id
type: string
minLength: 1
external_id:
title: External id
type:
- string
- 'null'
concept_class:
title: Concept class
type: string
minLength: 1
datatype:
title: Datatype
type: string
minLength: 1
url:
title: Url
type: string
minLength: 1
retired:
title: Retired
type: boolean
source:
title: Source
type: string
minLength: 1
owner:
title: Owner
type: string
minLength: 1
owner_type:
title: Owner type
type: string
readOnly: true
owner_url:
title: Owner url
type: string
readOnly: true
display_name:
title: Display name
type: string
readOnly: true
display_locale:
title: Display locale
type: string
readOnly: true
version:
title: Version
type: string
maxLength: 255
minLength: 1
update_comment:
title: Update comment
type:
- string
- 'null'
locale:
title: Locale
type: string
readOnly: true
minLength: 1
version_created_by:
title: Version created by
type: string
format: date-time
readOnly: true
version_created_on:
title: Version created on
type: string
format: date-time
readOnly: true
is_latest_version:
title: Is latest version
type: boolean
versions_url:
title: Versions url
type: string
readOnly: true
version_url:
title: Version url
type: string
readOnly: true
type:
title: Type
type: string
readOnly: true
minLength: 1
versioned_object_id:
title: Versioned object id
type: string
readOnly: true
version_updated_on:
title: Version updated on
type: string
format: date-time
readOnly: true
version_updated_by:
title: Version updated by
type: string
format: date-time
readOnly: true
latest_source_version:
title: Latest source version
type: string
readOnly: true
property:
title: Property
type: object
readOnly: true
retire_reason:
title: Retire reason
type:
- string
- 'null'
securitySchemes:
Basic:
type: http
scheme: basic
Token:
type: apiKey
name: Authorization
in: header