Lifen CommunicationRequest API

The CommunicationRequest API from Lifen — 3 operation(s) for communicationrequest.

Operations 3

POST /v3/CommunicationRequest/$send-to-ehr Send document to the EHR #
POST /v3/CommunicationRequest/$send-to-mss Send document to Healthcare Professionals #
GET /v3/CommunicationRequest/$tracking?transaction-id={transaction-id} Check sending status #

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/lifen-communicationrequest-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 email required.

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

OpenAPI Specification

lifen-communicationrequest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: lifen-authentication-api Communication Request API
  version: '3'
servers:
- url: https://authentication.lifen.fr/
security:
- {}
tags:
- name: CommunicationRequest
paths:
  /v3/CommunicationRequest/$send-to-ehr:
    post:
      summary: Send document to the EHR
      description: ''
      operationId: communicationrequestsend-to-ehr-1
      parameters:
      - name: Content-Type
        in: header
        required: true
        schema:
          type: string
          default: application/fhir+json
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - resourceType
              - parameter
              properties:
                resourceType:
                  type: string
                  default: Parameters
                parameter:
                  type: array
                  description: 'The parameters : subject (valueReference), context (valueReference), content-type (valueCode - optional), document-type (valueCode - optional), document-title (valueString - optional), payload (valueString), sender-identifier (valueString - optional)'
                  items:
                    properties:
                      name:
                        type: string
                      valueReference:
                        type: object
                        required:
                        - reference
                        properties:
                          reference:
                            type: string
                      valueString:
                        type: string
                      valueCode:
                        type: string
                      part:
                        type: array
                        items:
                          properties:
                            name:
                              type: string
                            resource:
                              type: object
                          required:
                          - name
                          - resource
                          type: object
                    required:
                    - name
                    type: object
            examples:
              send-to-ehr-example:
                value:
                  resourceType: Parameters
                  parameter:
                  - name: subject
                    valueReference:
                      reference: Patient/{{patientId}}
                  - name: context
                    valueReference:
                      reference: Encounter/{{encounterId}}
                  - name: content-type
                    valueCode: application/pdf
                  - name: document-type
                    valueCode: 11488-4
                  - name: document-title
                    valueString: Compte rendu de télémédecine
                  - name: payload
                    valueString: '{{base64}}'
      responses:
        '201':
          description: '201'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n\t\"resourceType\": \"Parameters\",\n\t\"parameter\": [\n\t\t{\n\t\t\t\"name\": \"tracking-url\",\n\t\t\t\"valueString\": \"https://api.post-prod.lifen.fr/fhir/v3/Communication?based-on=CommunicationRequest/[id_communication_request]&_elements=status,notDoneReason\"\n\t\t}\n\t]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: Parameters
                  parameter:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          example: tracking-url
                        valueString:
                          type: string
                          example: https://api.post-prod.lifen.fr/fhir/v3/Communication?based-on=CommunicationRequest/[id_communication_request]&_elements=status,notDoneReason
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n\t\"resourceType\": \"OperationOutcome\",\n\t\"issue\": [\n\t\t{\n\t\t\t\"severity\": \"error\",\n\t\t\t\"code\": \"processing\",\n\t\t\t\"diagnostics\": \"Invalid access token\"\n\t\t}\n\t]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: OperationOutcome
                  issue:
                    type: array
                    items:
                      type: object
                      properties:
                        severity:
                          type: string
                          example: error
                        code:
                          type: string
                          example: processing
                        diagnostics:
                          type: string
                          example: Invalid access token
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n\t\"resourceType\": \"OperationOutcome\",\n\t\"issue\": [\n\t\t{\n\t\t\t\"severity\": \"ERROR\",\n\t\t\t\"code\": \"FORBIDDEN\",\n\t\t\t\"diagnostics\": \"[error_diagnostic]\"\n\t\t}\n\t]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: OperationOutcome
                  issue:
                    type: array
                    items:
                      type: object
                      properties:
                        severity:
                          type: string
                          example: ERROR
                        code:
                          type: string
                          example: FORBIDDEN
                        diagnostics:
                          type: string
                          example: '[error_diagnostic]'
        '422':
          description: '422'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"resourceType\": \"OperationOutcome\",\n    \"issue\": [\n        {\n            \"severity\": \"ERROR\",\n            \"code\": \"PROCESSING\",\n            \"diagnostics\": \"[error_diagnostic]\",\n            \"location\": \"[error_location]\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: OperationOutcome
                  issue:
                    type: array
                    items:
                      type: object
                      properties:
                        severity:
                          type: string
                          example: ERROR
                        code:
                          type: string
                          example: PROCESSING
                        diagnostics:
                          type: string
                          example: '[error_diagnostic]'
                        location:
                          type: string
                          example: '[error_location]'
      deprecated: false
      tags:
      - CommunicationRequest
  /v3/CommunicationRequest/$send-to-mss:
    post:
      summary: Send document to Healthcare Professionals
      description: For more details, please refer to the "Guides" section
      operationId: send-document-to-the-hcp
      parameters:
      - name: Content-Type
        in: header
        required: true
        schema:
          type: string
          default: application/fhir+json
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - resourceType
              - parameter
              properties:
                resourceType:
                  type: string
                  default: Parameters
                parameter:
                  type: array
                  items:
                    properties:
                      name:
                        type: string
                      valueReference:
                        type: object
                        required:
                        - reference
                        properties:
                          reference:
                            type: string
                      valueString:
                        type: string
                      valueCode:
                        type: string
                      part:
                        type: array
                        items:
                          properties:
                            name:
                              type: string
                            resource:
                              type: object
                          required:
                          - name
                          - resource
                          type: object
                    required:
                    - name
                    type: object
      responses:
        '201':
          description: '201'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"resourceType\": \"Parameters\",\n    \"parameter\": [\n        {\n            \"name\": \"tracking-url\",\n            \"valueString\": \"https://api.lifen.fr/fhir/v3/CommunicationRequest/$tracking?transaction-id=ifad1343e-496f-11ed-b878-0242ac120002\"\n        },\n      \t{\n            \"name\": \"transaction-id\",\n            \"valueString\": \"ifad1343e-496f-11ed-b878-0242ac120002\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: Parameters
                  parameter:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          example: tracking-url
                        valueString:
                          type: string
                          example: https://api.lifen.fr/fhir/v3/CommunicationRequest/$tracking?transaction-id=ifad1343e-496f-11ed-b878-0242ac120002
        '412':
          description: '412'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"resourceType\": \"OperationOutcome\",\n    \"issue\": [\n        {\n            \"severity\": \"ERROR\",\n            \"code\": \"PROCESSING\",\n            \"diagnostics\": \"Mail support missing, please defined it in `https://portal.lifen.fr`\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: OperationOutcome
                  issue:
                    type: array
                    items:
                      type: object
                      properties:
                        severity:
                          type: string
                          example: ERROR
                        code:
                          type: string
                          example: PROCESSING
                        diagnostics:
                          type: string
                          example: Mail support missing, please defined it in `https://portal.lifen.fr`
        '422':
          description: '422'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"resourceType\": \"OperationOutcome\",\n    \"issue\": [\n        {\n            \"severity\": \"ERROR\",\n            \"code\": \"PROCESSING\",\n            \"diagnostics\": \"[error_diagnostic]\",\n            \"location\": \"[error_location]\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: OperationOutcome
                  issue:
                    type: array
                    items:
                      type: object
                      properties:
                        severity:
                          type: string
                          example: ERROR
                        code:
                          type: string
                          example: PROCESSING
                        diagnostics:
                          type: string
                          example: '[error_diagnostic]'
                        location:
                          type: string
                          example: '[error_location]'
      deprecated: false
      tags:
      - CommunicationRequest
  /v3/CommunicationRequest/$tracking?transaction-id={transaction-id}:
    get:
      summary: Check sending status
      description: ''
      operationId: send-to-mss-check-sending-status
      parameters:
      - name: transaction-id
        in: query
        required: true
        schema:
          type: string
          default: ifad1343e-496f-11ed-b878-0242ac120002
      - name: Content-Type
        in: header
        schema:
          type: string
          default: application/fhir+json
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n\t\"resourceType\": \"Bundle\",\n\t\"type\": \"collection\",\n\t\"total\": 1,\n\t\"entry\": [\n\t\t{\n\t\t\t\"resource\": {\n\t\t\t\t\"resourceType\": \"Communication\",\n\t\t\t\t\"status\": \"completed\",\n        \"medium\": [\n          {\n            \"coding\": [\n              {\n                \"system\": \"http://lifen.fr/fhir/ValueSet/communication-medium\",\n                \"code\": \"MSSANTE\"\n              }\n            ],\n            \"text\": \"paulette.michue@test.lifen.mssante.fr\"\n          }\n        ]\n\t\t\t}\n\t\t}\n\t]\n}"
              schema:
                type: object
                properties:
                  resourceType:
                    type: string
                    example: Bundle
                  type:
                    type: string
                    example: collection
                  total:
                    type: integer
                    example: 1
                    default: 0
                  entry:
                    type: array
                    items:
                      type: object
                      properties:
                        resource:
                          type: object
                          properties:
                            resourceType:
                              type: string
                              example: Communication
                            status:
                              type: string
                              example: completed
                            medium:
                              type: array
                              items:
                                type: object
                                properties:
                                  coding:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        system:
                                          type: string
                                          example: http://lifen.fr/fhir/ValueSet/communication-medium
                                        code:
                                          type: string
                                          example: MSSANTE
                                  text:
                                    type: string
                                    example: paulette.michue@test.lifen.mssante.fr
      deprecated: false
      tags:
      - CommunicationRequest
x-readme:
  headers: []
  explorer-enabled: false
  proxy-enabled: true
x-readme-fauxas: true