# MESH API

**URL:** https://developer.community.nhs.uk/c/mesh/meshapi/33.md

[Latest](https://developer.community.nhs.uk/latest.md) · [Categories](https://developer.community.nhs.uk/categories.md) · [Tags](https://developer.community.nhs.uk/tags.md)

---

## [About the MESH API category](https://developer.community.nhs.uk/t/about-the-mesh-api-category/520)

<div class="topic-metadata">

**Author:** [@alan.rawlings2](https://developer.community.nhs.uk/u/alan.rawlings2)\
**Replies:** 0\
**Last updated:** [6 October 2023 09:52 UTC](https://developer.community.nhs.uk/t/about-the-mesh-api-category/520 "2023-10-06T09:52:52Z")

</div>

Use the MESH API to integrate MESH into your own software products. There is a digital onboarding process to access the service. Expect it to take a minimum of 1 month. Once integrated and onboarded, you can send files…

---

## [Can i send on behalf of](https://developer.community.nhs.uk/t/can-i-send-on-behalf-of/14460)

<div class="topic-metadata">

**Author:** [@gh\_ik](https://developer.community.nhs.uk/u/gh_ik)\
**Replies:** 5\
**Last updated:** [20 August 2026 08:48 UTC](https://developer.community.nhs.uk/t/can-i-send-on-behalf-of/14460 "2026-08-20T08:48:03Z")

</div>

hi if i have certificate F for my mail box A if an EHR is configured with mail box C , with password D Can I use the EHR to use C, D credentials to send to mesh with certificate F? I guess my question is a certificat…

---

## [OVM-MESH Batch Query using MESH API](https://developer.community.nhs.uk/t/ovm-mesh-batch-query-using-mesh-api/12203)

<div class="topic-metadata">

**Author:** [@Deepak\_Ghansala](https://developer.community.nhs.uk/u/Deepak_Ghansala)\
**Replies:** 1\
**Last updated:** [21 May 2026 10:40 UTC](https://developer.community.nhs.uk/t/ovm-mesh-batch-query-using-mesh-api/12203 "2026-05-21T10:40:02Z")

</div>

We currently use the MESH client and MESH UI for a workflow ID (SPINE\_OVM\_READRESP\_DSC1) that allows an OVM (Overseas Visitors Manager) working in Secondary Care (or other authorised user) to submit a list of NHS Numbers…

---

## [MESH API Integration](https://developer.community.nhs.uk/t/mesh-api-integration/7831)

<div class="topic-metadata">

**Author:** [@MGeorge](https://developer.community.nhs.uk/u/MGeorge)\
**Replies:** 5\
**Last updated:** [25 September 2025 09:00 UTC](https://developer.community.nhs.uk/t/mesh-api-integration/7831 "2025-09-25T09:00:01Z")

</div>

We are trying to integrate with MESH API via Trust Integration Engine(HealthShare HealthConnect). Could someone please help with steps we need to do get access to the MESH server. We got new MESH mailbox created and als…

---

## [MESH FHIR message Unreadable message received](https://developer.community.nhs.uk/t/mesh-fhir-message-unreadable-message-received/3219)

<div class="topic-metadata">

**Author:** [@chris.cooper](https://developer.community.nhs.uk/u/chris.cooper)\
**Replies:** 3\
**Last updated:** [15 November 2024 19:08 UTC](https://developer.community.nhs.uk/t/mesh-fhir-message-unreadable-message-received/3219 "2024-11-15T19:08:17Z")

</div>

Hi Hope someone can help, I’ve been working on a FHIR message to send a PDF back to a patients record on the MESH services. I’ve been getting help from ITK and they have given me a mailbox that I can use to validate my…

---

## [MESH Message not seen in GP mailbox](https://developer.community.nhs.uk/t/mesh-message-not-seen-in-gp-mailbox/2828)

<div class="topic-metadata">

**Author:** [@chris.cooper](https://developer.community.nhs.uk/u/chris.cooper)\
**Replies:** 4\
**Last updated:** [13 November 2024 16:47 UTC](https://developer.community.nhs.uk/t/mesh-message-not-seen-in-gp-mailbox/2828 "2024-11-13T16:47:25Z")

</div>

Hi All Hope someone can help or guide. I have created a new MESH API service, which sends FHIR messages containing a patient PDF report. The MESH solutions has stated the messages have been accepted and acknowledged, …

---

## [How to get a token?](https://developer.community.nhs.uk/t/how-to-get-a-token/501)

<div class="topic-metadata">

**Author:** [@lt23](https://developer.community.nhs.uk/u/lt23)\
**Replies:** 3\
**Last updated:** [24 July 2024 12:26 UTC](https://developer.community.nhs.uk/t/how-to-get-a-token/501 "2024-07-24T12:26:19Z")

</div>

I am using postman to try and get a token from the sandbox container I have spun up successfully. what are the credentials for this sandbox system please? I observed the below but it suggests either its already generat…

---

## [I am at Manage public key section i attach json file and it show me error that "Your public key resource is not a valid JWKS public key."](https://developer.community.nhs.uk/t/i-am-at-manage-public-key-section-i-attach-json-file-and-it-show-me-error-that-your-public-key-resource-is-not-a-valid-jwks-public-key/1011)

<div class="topic-metadata">

**Author:** [@abbas](https://developer.community.nhs.uk/u/abbas)\
**Replies:** 1\
**Last updated:** [24 July 2024 12:21 UTC](https://developer.community.nhs.uk/t/i-am-at-manage-public-key-section-i-attach-json-file-and-it-show-me-error-that-your-public-key-resource-is-not-a-valid-jwks-public-key/1011 "2024-07-24T12:21:56Z")

</div>

i am at Manage public key section i attach json file and it show me error that “Your public key resource is not a valid JWKS public key.”

---

## [The message received was unexpected or badly formatted](https://developer.community.nhs.uk/t/the-message-received-was-unexpected-or-badly-formatted/1121)

<div class="topic-metadata">

**Author:** [@chris.cooper](https://developer.community.nhs.uk/u/chris.cooper)\
**Replies:** 2\
**Last updated:** [24 July 2024 08:39 UTC](https://developer.community.nhs.uk/t/the-message-received-was-unexpected-or-badly-formatted/1121 "2024-07-24T08:39:01Z")

</div>

Hi Can someone please help? I’ve created a solution to communication with the MESH API. The development was done using the SANDBOX solution and everything worked well. Now that I’ve moved to the Integration environme…

---

## [Kettering XML and PDFs](https://developer.community.nhs.uk/t/kettering-xml-and-pdfs/1005)

<div class="topic-metadata">

**Author:** [@chris.cooper](https://developer.community.nhs.uk/u/chris.cooper)\
**Replies:** 2\
**Last updated:** [16 July 2024 10:12 UTC](https://developer.community.nhs.uk/t/kettering-xml-and-pdfs/1005 "2024-07-16T10:12:45Z")

</div>

Hi All I’m new and would like some help please. I’m currently developing a service to send messages on MESH using the below spec. https://digital.nhs.uk/developer/api-catalogue/message-exchange-for-social-care-and-hea…

---

## [Sending PDF via MESH which workflow](https://developer.community.nhs.uk/t/sending-pdf-via-mesh-which-workflow/990)

<div class="topic-metadata">

**Author:** [@chris.cooper](https://developer.community.nhs.uk/u/chris.cooper)\
**Replies:** 3\
**Last updated:** [21 June 2024 11:11 UTC](https://developer.community.nhs.uk/t/sending-pdf-via-mesh-which-workflow/990 "2024-06-21T11:11:09Z")

</div>

Hi All I’m working for a company that want to send PDF with Spirometry, ECHO, ECG and patient clinical reports through the MESH. We are looking at the onboarding process, but do not know which work flow to pick. Can a…

---

## [What is Mesh swagger URL website?](https://developer.community.nhs.uk/t/what-is-mesh-swagger-url-website/500)

<div class="topic-metadata">

**Author:** [@lt23](https://developer.community.nhs.uk/u/lt23)\
**Replies:** 1\
**Last updated:** [24 September 2023 19:04 UTC](https://developer.community.nhs.uk/t/what-is-mesh-swagger-url-website/500 "2023-09-24T19:04:12Z")

</div>

I have spun up the sandbox container. I can get a response from https://myMeshServer:8700/health/ Is there a swagger available?

---

## [Uploading a document to sandbox environment](https://developer.community.nhs.uk/t/uploading-a-document-to-sandbox-environment/502)

<div class="topic-metadata">

**Author:** [@lt23](https://developer.community.nhs.uk/u/lt23)\
**Replies:** 1\
**Last updated:** [24 September 2023 19:00 UTC](https://developer.community.nhs.uk/t/uploading-a-document-to-sandbox-environment/502 "2023-09-24T19:00:51Z")

</div>

I managed to succesfully upload a doc to the docker sandbox environment via the api which returns a message ID. However where can I find the uploaded file on the host if any? I tried E:\\mesh\\mesh-sandbox-develop\\src\\…

---

## [MESH : Swagger docs](https://developer.community.nhs.uk/t/mesh-swagger-docs/457)

<div class="topic-metadata">

**Author:** [@tc1](https://developer.community.nhs.uk/u/tc1)\
**Replies:** 9\
**Last updated:** [7 September 2023 11:22 UTC](https://developer.community.nhs.uk/t/mesh-swagger-docs/457 "2023-09-07T11:22:28Z")

</div>

I’m trying to use a generated client for MESH, using the documented API @ https://digital.nhs.uk/restapi/oas/357490 But in paths for the /messageexchange/{mailbox\_id}/outbox it doesn’t declare a requestBody which seems …

---

## [MESH API (Int Env) Related Issue](https://developer.community.nhs.uk/t/mesh-api-int-env-related-issue/318)

<div class="topic-metadata">

**Author:** [@supplier](https://developer.community.nhs.uk/u/supplier)\
**Replies:** 5\
**Last updated:** [7 September 2023 11:01 UTC](https://developer.community.nhs.uk/t/mesh-api-int-env-related-issue/318 "2023-09-07T11:01:02Z")

</div>

Hello Team, I am prashant Chourasiya from OX-Digital Health. It is a critical problem related to establish connection between mesh integration server to our server via internet. On 8th March 2023, we have received two …

---

## [MESH example Python code does not work](https://developer.community.nhs.uk/t/mesh-example-python-code-does-not-work/456)

<div class="topic-metadata">

**Author:** [@tc1](https://developer.community.nhs.uk/u/tc1)\
**Replies:** 5\
**Last updated:** [7 September 2023 10:54 UTC](https://developer.community.nhs.uk/t/mesh-example-python-code-does-not-work/456 "2023-09-07T10:54:18Z")

</div>

The code @ Message Exchange for Social Care and Health (MESH) API - NHS Digital isn’t valid python3 (that’s not how you do an import) and contains typos, and no actual output. Here is a corrected version. Save it to a f…
