List Forms

List Forms

curl --request GET \
  --url https://api.usecobalt.com/v1/forms \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>'

import requests

url = "https://api.usecobalt.com/v1/forms"

headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "access_token": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {client_id: '<api-key>', client_secret: '<api-key>', access_token: '<api-key>'}
};

fetch('https://api.usecobalt.com/v1/forms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/forms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "access_token: <api-key>",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.usecobalt.com/v1/forms"

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

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.usecobalt.com/v1/forms")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("access_token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/forms")

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

request = Net::HTTP::Get.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'

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

{
  "success": true,
  "forms": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "emr_form_id": "392",
      "emr_fvid": "1045",
      "name": "GAD-7",
      "type": "Assessment",
      "version": "3",
      "status": "Active",
      "build_date": "2026-01-15",
      "synced_at": "2026-08-26T09:00:00.000Z",
      "created_at": "2026-01-20T12:00:00.000Z",
      "updated_at": "2026-08-26T09:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "message": "Error fetching forms."
}

GET

forms

List Forms

curl --request GET \
  --url https://api.usecobalt.com/v1/forms \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>'

import requests

url = "https://api.usecobalt.com/v1/forms"

headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "access_token": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {client_id: '<api-key>', client_secret: '<api-key>', access_token: '<api-key>'}
};

fetch('https://api.usecobalt.com/v1/forms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/forms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "access_token: <api-key>",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.usecobalt.com/v1/forms"

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

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.usecobalt.com/v1/forms")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("access_token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/forms")

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

request = Net::HTTP::Get.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["access_token"] = '<api-key>'

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

{
  "success": true,
  "forms": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "emr_form_id": "392",
      "emr_fvid": "1045",
      "name": "GAD-7",
      "type": "Assessment",
      "version": "3",
      "status": "Active",
      "build_date": "2026-01-15",
      "synced_at": "2026-08-26T09:00:00.000Z",
      "created_at": "2026-01-20T12:00:00.000Z",
      "updated_at": "2026-08-26T09:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "message": "Error fetching forms."
}

Returns the metadata for every form Cobalt has cached for your account — id, name, type, version, and status. The full form definition (categories, questions, answers) is not included here; fetch it for a single form with GET /v1/forms/{id}. Forms are cached by a sync. Trigger an on-demand refresh with POST /v1/forms/fetch; a daily scheduler also keeps the cache current.

Forms are currently supported for Credible.

When to use this

Use the list to find the form you want to document a service with. The emr_form_id of the chosen form is the form_id you pass to POST /v1/services. Then read that form’s definition to get the question ids for the service answers.

Example Request

curl https://api.usecobalt.com/v1/forms \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH'

Example Response

{
    "success": true,
    "forms": [
        {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "emr_form_id": "392",
            "emr_fvid": "1045",
            "name": "GAD-7",
            "type": "Assessment",
            "version": "3",
            "status": "Active",
            "build_date": "2026-01-15",
            "synced_at": "2026-08-26T09:00:00.000Z",
            "created_at": "2026-01-20T12:00:00.000Z",
            "updated_at": "2026-08-26T09:00:00.000Z"
        }
    ]
}

The fields on each form:

id: Cobalt form id (UUID). Use this with GET /v1/forms/{id}.
emr_form_id: The form’s id in the EMR. This is the form_id you pass to POST /v1/services.
emr_fvid: The EMR form-version id, or null.
name: Form name.
type, version, status, build_date: Form metadata from the EMR (any may be null).
synced_at: When the form was last synced into the cache.

Authorizations

client_id

string

header

required

client_secret

string

header

required

access_token

string

header

required

Response

Cached form metadata for the account

success

boolean

forms

object[]

Show child attributes

API Documentation

Account

Appointments

Availability

Claims

Codes

Documents

Eligibility

Fee Schedules

Forms

Insurance

Link

Locations

Messages

Notes

Orders

Org Settings

Patient Notes

Patients

Payments

Pharmacies

Providers

Recalls

Referrals

Referring Providers

Services

Settings

Tasks

Telephone Encounters

Visit Statuses

Visit Types

Webhooks

When to use this

Example Request

Example Response

Authorizations

Response

​When to use this

​Example Request

​Example Response

Authorizations

Response

When to use this

Example Request

Example Response