Open Concept Lab (OCL) Mappings API

The mappings API from Open Concept Lab (OCL) — 1 operation(s) for mappings.

GitHub OpenAPI

Operations 2

GET /mappings/ Mappings list #
POST /mappings/ Mappings create #

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/openconceptlab:openconceptlab-mappings-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. 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 Specification

openconceptlab-mappings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OCL Mappings 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: Mappings
paths:
  /mappings/:
    parameters: []
    get:
      operationId: mappings_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: 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/MappingList'
            application/zip:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MappingList'
            application/fhir+json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MappingList'
      tags:
      - Mappings
      summary: Mappings list
      x-summary-source: derived
    post:
      operationId: mappings_create
      description: ''
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MappingDetail'
            application/zip:
              schema:
                $ref: '#/components/schemas/MappingDetail'
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/MappingDetail'
      tags:
      - Mappings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MappingDetail'
        required: true
      summary: Mappings create
      x-summary-source: derived
components:
  schemas:
    MappingDetail:
      required:
      - map_type
      - parent_id
      type: object
      properties:
        extras:
          title: Extras
          type:
          - object
          - 'null'
        checksums:
          title: Checksums
          type: string
          readOnly: true
        external_id:
          title: External id
          type:
          - string
          - 'null'
        retired:
          title: Retired
          type: boolean
        map_type:
          title: Map type
          type: string
          minLength: 1
        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
        from_concept_code:
          title: From concept code
          type: string
          minLength: 1
        from_concept_name:
          title: From concept name
          type:
          - string
          - 'null'
        from_concept_url:
          title: From concept url
          type: string
          minLength: 1
        to_concept_code:
          title: To concept code
          type: string
          minLength: 1
        to_concept_name:
          title: To concept name
          type:
          - string
          - 'null'
        to_concept_url:
          title: To concept url
          type: string
          minLength: 1
        from_source_owner:
          title: From source owner
          type: string
          readOnly: true
        from_source_owner_type:
          title: From source owner type
          type: string
          readOnly: true
        from_source_url:
          title: From source url
          type:
          - string
          - 'null'
        from_source_name:
          title: From source name
          type: string
          readOnly: true
        to_source_owner:
          title: To source owner
          type: string
          readOnly: true
        to_source_owner_type:
          title: To source owner type
          type: string
          readOnly: true
        to_source_url:
          title: To source url
          type:
          - string
          - 'null'
        to_source_name:
          title: To source name
          type: string
          readOnly: true
        url:
          title: Url
          type: string
          minLength: 1
        version:
          title: Version
          type: string
          readOnly: true
          minLength: 1
        id:
          title: Id
          type: string
          minLength: 1
        versioned_object_id:
          title: Versioned object id
          type: string
          readOnly: true
        versioned_object_url:
          title: Versioned object url
          type: string
          readOnly: true
        is_latest_version:
          title: Is latest version
          type: boolean
        update_comment:
          title: Update comment
          type:
          - string
          - 'null'
        version_url:
          title: Version url
          type: string
          readOnly: true
        uuid:
          title: Uuid
          type: string
          readOnly: true
          minLength: 1
        version_created_on:
          title: Version created on
          type: string
          format: date-time
          readOnly: true
        from_source_version:
          title: From source version
          type:
          - string
          - 'null'
        to_source_version:
          title: To source version
          type:
          - string
          - 'null'
        from_concept_name_resolved:
          title: From concept name resolved
          type: string
          readOnly: true
          minLength: 1
        to_concept_name_resolved:
          title: To concept name resolved
          type: string
          readOnly: true
          minLength: 1
        type:
          title: Type
          type: string
          readOnly: true
          minLength: 1
        sort_weight:
          title: Sort weight
          type:
          - number
          - 'null'
        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
        retire_reason:
          title: Retire reason
          type:
          - string
          - 'null'
        created_on:
          title: Created on
          type: string
          format: date-time
          readOnly: true
        updated_on:
          title: Updated on
          type: string
          format: date-time
          readOnly: true
        created_by:
          title: Created by
          type: string
          readOnly: true
          minLength: 1
        updated_by:
          title: Updated by
          type: string
          readOnly: true
          minLength: 1
        parent_id:
          title: Parent id
          type: integer
        public_can_view:
          title: Public can view
          type: string
          readOnly: true
    MappingList:
      required:
      - map_type
      type: object
      properties:
        checksums:
          title: Checksums
          type: string
          readOnly: true
        external_id:
          title: External id
          type:
          - string
          - 'null'
        retired:
          title: Retired
          type: boolean
        map_type:
          title: Map type
          type: string
          minLength: 1
        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
        from_concept_code:
          title: From concept code
          type: string
          minLength: 1
        from_concept_name:
          title: From concept name
          type:
          - string
          - 'null'
        from_concept_url:
          title: From concept url
          type: string
          readOnly: true
        to_concept_code:
          title: To concept code
          type: string
          minLength: 1
        to_concept_name:
          title: To concept name
          type:
          - string
          - 'null'
        to_concept_url:
          title: To concept url
          type: string
          readOnly: true
        from_source_owner:
          title: From source owner
          type: string
          readOnly: true
        from_source_owner_type:
          title: From source owner type
          type: string
          readOnly: true
        from_source_url:
          title: From source url
          type:
          - string
          - 'null'
        from_source_name:
          title: From source name
          type: string
          readOnly: true
        to_source_owner:
          title: To source owner
          type: string
          readOnly: true
        to_source_owner_type:
          title: To source owner type
          type: string
          readOnly: true
        to_source_url:
          title: To source url
          type:
          - string
          - 'null'
        to_source_name:
          title: To source name
          type: string
          readOnly: true
        url:
          title: Url
          type: string
          minLength: 1
        version:
          title: Version
          type: string
          readOnly: true
          minLength: 1
        id:
          title: Id
          type: string
          minLength: 1
        versioned_object_id:
          title: Versioned object id
          type: string
          readOnly: true
        versioned_object_url:
          title: Versioned object url
          type: string
          readOnly: true
        is_latest_version:
          title: Is latest version
          type: boolean
        update_comment:
          title: Update comment
          type:
          - string
          - 'null'
        version_url:
          title: Version url
          type: string
          readOnly: true
        uuid:
          title: Uuid
          type: string
          readOnly: true
          minLength: 1
        version_created_on:
          title: Version created on
          type: string
          format: date-time
          readOnly: true
        from_source_version:
          title: From source version
          type:
          - string
          - 'null'
        to_source_version:
          title: To source version
          type:
          - string
          - 'null'
        from_concept_name_resolved:
          title: From concept name resolved
          type: string
          readOnly: true
          minLength: 1
        to_concept_name_resolved:
          title: To concept name resolved
          type: string
          readOnly: true
          minLength: 1
        type:
          title: Type
          type: string
          readOnly: true
          minLength: 1
        sort_weight:
          title: Sort weight
          type:
          - number
          - 'null'
        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
        retire_reason:
          title: Retire reason
          type:
          - string
          - 'null'
  securitySchemes:
    Basic:
      type: http
      scheme: basic
    Token:
      type: apiKey
      name: Authorization
      in: header