> For the complete documentation index, see [llms.txt](https://doc.orbeon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.orbeon.com/xforms/submission/submission-json.md).
# JSON support
\[SINCE Orbeon Forms 2016.1]
## Receiving JSON
### Introduction
When an `xf:submission` or by an `xf:instance` with a `src` or `resource` attribute receives content with the `application/json` mediatype, Orbeon Forms parses the received JSON and converts it to an XML representation friendly to XPath expressions.
\[SINCE Orbeon Forms 2017.1] In addition to the `application/json` mediatype, mediatypes of the form `a/b+json` are recognized.
### Conversion examples
The following JSON object:
```javascript
{ "given": "Mark", "family": "Smith" }
```
converts to:
```markup
Mark
Smith
```
and the values can be accessed in XPath with the paths `instance()/given` and `instance()/family`.
Numbers have a `type="number"` attribute:
```javascript
{ "name": "Mark", "age": 21 }
```
converts to:
```markup
Mark
21
```
Booleans similarly have a `type="boolean"` attribute:"
```javascript
{ "selected": true }
```
converts to:
```markup
true
```
Arrays use the `_` element name and the `type="array"` attribute:
```javascript
{ "cities": ["Amsterdam", "Paris", "London"] }
```
converts to:
```markup
<_>Amsterdam
<_>Paris
<_>London
```
and the string "Paris" can be accessed with `instance()/cities/_[2]`.
JSON `null` adds a `type="null"` attribute:"
```javascript
{ "p": null }
```
converts to:
```markup
```
Here is a link to [more examples](https://github.com/orbeon/orbeon-forms/blob/master/src/test/scala/org/orbeon/oxf/json/ConverterTest.scala) as part of the test suite.
### Seeing the converted XML
You can visualize the XML converted from JSON with Form Builder as follows:
1. Create a new form.
2. In the Advanced tab, create a new HTTP service, name it `my-service`, provide the URL to your JSON, and save.
3. In the Advanced tab, create a new Action, name it `show-result`, run it on form load after the controls are ready, have it call `my-service`.
4. Still while editing the new action, in the Service Response Actions tab set the value of "(control-1)" to `saxon:serialize(., 'xml')`.
5. Hit the Text button, and you'll find the XML in the text field. To make it easier to read, copy the XML in the text field, and paste it in an [XML formatting tool](https://www.freeformatter.com/xml-formatter.html).
\[SINCE Orbeon Forms 2019.1]
The Form Builder HTTP Service dialog supports viewing JSON response translated into XML.
See [XML view of JSON responses](/form-builder/advanced/services-and-actions/http-services.md#xml-view-of-json-responses).
## Sending JSON
When setting `serialization="application/json"` on `xf:submission`, the source XML is converted to JSON. The source XML must be compatible with the XForms XML representation of JSON shown above to be meaningful.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://doc.orbeon.com/xforms/submission/submission-json.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.