Generate Codes

Limited Access - Contact us for more information

Generate codes within the context of an interaction.

This endpoint is only accessible within specific customer tenants. It is not available in the public API.

For stateless code prediction based on input text string or documentId, please refer to the Predict Codes API, or contact us for more information.

POST /interactions/{id}/codes/

Generate Codes

cURL

curl --request POST \
  --url https://api.{environment}.corti.app/v2/interactions/{id}/codes/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-Name: <tenant-name>' \
  --data '
{
  "modelName": "\"geography_modelName (Latest)\" | \"geography_modelName_version\"",
  "context": {
    "data": "<string>",
    "metadata": "<string>"
  },
  "existingCodes": [
    "<string>"
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'Tenant-Name': '<tenant-name>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    modelName: '"geography_modelName (Latest)" | "geography_modelName_version"',
    context: {data: '<string>', metadata: '<string>'},
    existingCodes: ['<string>']
  })
};

fetch('https://api.{environment}.corti.app/v2/interactions/{id}/codes/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.{environment}.corti.app/v2/interactions/{id}/codes/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Tenant-Name", "<tenant-name>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"modelName\": \"\\\"geography_modelName (Latest)\\\" | \\\"geography_modelName_version\\\"\",\n  \"context\": {\n    \"data\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"existingCodes\": [\n    \"<string>\"\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

import requests

url = "https://api.{environment}.corti.app/v2/interactions/{id}/codes/"

payload = {
    "modelName": "\"geography_modelName (Latest)\" | \"geography_modelName_version\"",
    "context": {
        "data": "<string>",
        "metadata": "<string>"
    },
    "existingCodes": ["<string>"]
}
headers = {
    "Tenant-Name": "<tenant-name>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{environment}.corti.app/v2/interactions/{id}/codes/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'modelName' => '"geography_modelName (Latest)" | "geography_modelName_version"',
    'context' => [
        'data' => '<string>',
        'metadata' => '<string>'
    ],
    'existingCodes' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Tenant-Name: <tenant-name>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.{environment}.corti.app/v2/interactions/{id}/codes/"

	payload := strings.NewReader("{\n  \"modelName\": \"\\\"geography_modelName (Latest)\\\" | \\\"geography_modelName_version\\\"\",\n  \"context\": {\n    \"data\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"existingCodes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Tenant-Name", "<tenant-name>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.{environment}.corti.app/v2/interactions/{id}/codes/")
  .header("Tenant-Name", "<tenant-name>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"modelName\": \"\\\"geography_modelName (Latest)\\\" | \\\"geography_modelName_version\\\"\",\n  \"context\": {\n    \"data\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"existingCodes\": [\n    \"<string>\"\n  ]\n}")
  .asString();

200

{
  "codes": [
    {
      "system": "ICD-10",
      "code": "T933",
      "description": "<string>",
      "state": {
        "isSelected": true
      },
      "additionalCodes": [
        {
          "subsetName": "orsakskoder",
          "code": "W0231",
          "description": "<string>",
          "state": {
            "isSelected": true
          }
        }
      ]
    }
  ],
  "usageInfo": {
    "creditsConsumed": 123
  }
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

Authorizations

Authorization · string · header · required

Input your token

Headers

Tenant-Name · string · required

Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

Example:

"base"

Path Parameters

id · string<uuid> · required

The unique identifier of the interaction. Must be a valid UUID.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Body

application/json

modelName · string · required

The model name used for code predictions

Example:

"\"geography_modelName (Latest)\" | \"geography_modelName_version\""

context · object · required

Context object containing type and data

Show child attributes

existingCodes · string[]

List of pre-selected codes before interaction

Response

200

application/json

List of predicted codes.

codes · object[]

List of medical codes

Show child attributes

usageInfo · object

Credits consumed for this request.

Show child attributes