> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.medicomp.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.medicomp.com/_mcp/server.

# Translate Items

GET https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems

Reference: https://docs.medicomp.com/api-reference/rest/get-quippe-coding-translate-items

## Authentication

- `Authorization` header (basic auth, required) — Login and password used to access quippe.medicomp.com. On-premise Quippe deployments can be configured to use whatever authentication and authorization your application is configured for, so basic authentication is used here to access the Quippe sandbox and is not a product requirement.
- `Authorization` header (bearer token, required) — JSON web token generated by a request to the [/Quippe/Security/Token](/api-reference/rest/get-quippe-security-token) web service endpoint in Quippe.

## Request

### Query parameters

- `SourceVocabulary` (string, required) — The unique string code of the source vocabulary to translate from. The list of supported vocabularies can be retrieved from the [/Quippe/Coding/Vocabs](/api-reference/rest/get-quippe-coding-vocabs) endpoint.
- `SourceCode` (string, required) — Comma-separate list of source codes to translate.
- `TargetVocabulary` (string, required) — The vocabulary to translate into — the vocabulary of the codes returned in each `Entry/@Code`. Common values: `icd10` (ICD-10-CM), `icd10pcs`, `cpt`, `hcpcs`, `snomed`, `loinc`, `rxnorm`. Note that `icd` is ICD-9-CM, not ICD-10 — use `icd10` for ICD-10-CM. Not every source/target pair has maps; a pair with no maps returns an empty `Map` element. The list of supported vocabularies can be retrieved from the [/Quippe/Coding/Vocabs](/api-reference/rest/get-quippe-coding-vocabs) endpoint.
- `Prefix` (string, optional) — Optional MEDCIN prefix qualifier for the source code — the prefix positions a finding in context, such as a family-history or "history of" framing. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise, and affects which target codes the translation produces.
- `Result` (string, optional) — Optional MEDCIN result qualifier for the source code — for example to indicate a positive vs. negative finding. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
- `Status` (string, optional) — Optional MEDCIN status qualifier for the source code — for example to mark a finding as absent, resolved, or historical rather than currently present. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
- `Modifier` (string, optional) — Optional MEDCIN modifier qualifier for the source code, refining the finding (for example laterality or severity). Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
- `Specifier` (string, optional) — Optional MEDCIN specification string for the source code, carrying the finding's post-coordinated detail. Applies only when SourceVocabulary is a MEDCIN vocabulary and SourceCode is numeric; ignored otherwise.
- `Age` (integer, optional) — Optional patient age in minutes, used as translation context for age-specific MEDCIN source findings. MEDCIN expresses age in minutes for neonatal/pediatric precision; for example 1 year is about 525,960 minutes. Applies only to MEDCIN source codes. Defaults to 0 (no age context).
- `Sex` (string, optional) — Optional patient sex (M or F), used as translation context for sex-specific MEDCIN source findings. Applies only to MEDCIN source codes. Leave blank (default) for no sex context.
- `Value` (string, optional) — Optional test or measurement value for the source code — for example a numeric result attached to a MEDCIN finding that carries a value. Applies only to MEDCIN source codes. Defaults to none.
- `EncounterTime` (string, optional) — The optional encounter date and time associated with an item.
- `AutoGenerateMaps` (boolean, optional) — Indicates whether maps from qualified MEDCIN concepts should be automatically generated where applicable if no maps are available.
- `Limit` (integer, optional) — Limits the number of maps returned. Defaults to no limit.
- `RelationshipFilter` (string, optional) — Limits the maps to only those with the specified relationship.
- `DataFormat` (enum, optional) — Specifies how objects are encoded in the output
  - Allowed values: `Default`, `XML`, `JSON`, `JSF`
- `RequestId` (string, optional) — Optional value that can be used by clients to track multiple requests.
- `Culture` (string, optional) — Culture to use when handling the request. If not specified the default value configured on the server will be used.

## Response

### 200

Successful response

- `maps` (list of object, optional)
  - `sourceVocabulary` (string, required)
  - `sourceCode` (string, required)
  - `targetVocabulary` (string, required)
  - `group` (list of object, optional)
    - `entry` (list of object, required)
      - `properties` (list of object, optional)
        - `name` (string, optional)
        - `value` (string, optional)
        - `category` (string, optional)
        - `sequence` (integer, optional)
      - `code` (string, optional)
      - `relationship` (string, optional)
      - `description` (string, optional)
      - `isCategory` (boolean, optional)
      - `preferred` (boolean, optional)
      - `termType` (string, optional)
      - `unreportable` (boolean, optional)
      - `age` (string, optional)
      - `sex` (string, optional)
      - `value` (string, optional)
      - `specifier` (string, optional)
      - `prefix` (string, optional)
      - `modifier` (string, optional)
      - `status` (string, optional)
      - `result` (string, optional)
      - `mapQualifier` (string, optional)
      - `codePoint` (string, optional)
    - `id` (string, optional)
    - `groupNumber` (integer, optional)
    - `codePoint` (string, optional)
  - `entry` (list of object, optional)
    - `properties` (list of object, optional)
      - `name` (string, optional)
      - `value` (string, optional)
      - `category` (string, optional)
      - `sequence` (integer, optional)
    - `code` (string, optional)
    - `relationship` (string, optional)
    - `description` (string, optional)
    - `isCategory` (boolean, optional)
    - `preferred` (boolean, optional)
    - `termType` (string, optional)
    - `unreportable` (boolean, optional)
    - `age` (string, optional)
    - `sex` (string, optional)
    - `value` (string, optional)
    - `specifier` (string, optional)
    - `prefix` (string, optional)
    - `modifier` (string, optional)
    - `status` (string, optional)
    - `result` (string, optional)
    - `mapQualifier` (string, optional)
    - `codePoint` (string, optional)

## Examples

**Response**

```json
{
  "maps": [
    {
      "sourceVocabulary": "string",
      "sourceCode": "string",
      "targetVocabulary": "string",
      "group": [
        {
          "entry": [
            {
              "properties": [
                {
                  "name": "string",
                  "value": "string",
                  "category": "string",
                  "sequence": 1
                }
              ],
              "code": "string",
              "relationship": "string",
              "description": "string",
              "isCategory": true,
              "preferred": true,
              "termType": "string",
              "unreportable": true,
              "age": "34164000-39420000",
              "sex": "M",
              "value": "string",
              "specifier": "string",
              "prefix": "PD",
              "modifier": "string",
              "status": "string",
              "result": "string",
              "mapQualifier": "string",
              "codePoint": "string"
            }
          ],
          "id": "string",
          "groupNumber": 1,
          "codePoint": "string"
        }
      ],
      "entry": [
        {
          "properties": [
            {
              "name": "string",
              "value": "string",
              "category": "string",
              "sequence": 1
            }
          ],
          "code": "string",
          "relationship": "string",
          "description": "string",
          "isCategory": true,
          "preferred": true,
          "termType": "string",
          "unreportable": true,
          "age": "34164000-39420000",
          "sex": "M",
          "value": "string",
          "specifier": "string",
          "prefix": "PD",
          "modifier": "string",
          "status": "string",
          "result": "string",
          "mapQualifier": "string",
          "codePoint": "string"
        }
      ]
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems"

querystring = {"SourceVocabulary":"SourceVocabulary","SourceCode":"SourceCode","TargetVocabulary":"TargetVocabulary"}

response = requests.get(url, params=querystring, auth=("<username>", "<password>"))

print(response.json())
```

```javascript
const url = 'https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary';
const credentials = btoa("<username>:<password>");

const options = {method: 'GET', headers: {Authorization: `Basic ${credentials}`}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary"

	req, _ := http.NewRequest("GET", url, nil)

	req.SetBasicAuth("<username>", "<password>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request.basic_auth("<username>", "<password>")

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary")
  .basicAuth("<username>", "<password>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary', [
  'headers' => [
  ],
    'auth' => ['<username>', '<password>'],
]);

echo $response->getBody();
```

```csharp
using RestSharp;
using RestSharp.Authenticators;

var client = new RestClient("https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary");
client.Authenticator = new HttpBasicAuthenticator("<username>", "<password>");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let credentials = Data("<username>:<password>".utf8).base64EncodedString()

let headers = ["Authorization": "Basic \(credentials)"]

let request = NSMutableURLRequest(url: NSURL(string: "https://quippe.medicomp.com/api/Quippe/Coding/TranslateItems?SourceVocabulary=SourceVocabulary&SourceCode=SourceCode&TargetVocabulary=TargetVocabulary")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```