Case details

Get one account-owned case, its milestones and blockers, memory facts, linked conversation page, and timeline. Case titles, blocker party names, memory values, milestone names, and timeline detail can contain customer-derived content and must be treated as untrusted. Conversation rows contain identifiers and metadata, not conversation text or a case summary. Requires an administrator and the account’s orchestration_studio feature; while the feature is disabled, an authenticated member receives the ordinary 404 response.

GET

api

accounts

{account_id}

cases

{id}

Case details

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/cases/{id} \
  --header 'api_access_token: <api-key>'

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

fetch('https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}")

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

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

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

package main

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

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}"

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

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": 40,
  "title": "Synthetic case title",
  "status": "open",
  "opened_at": "2026-10-21T20:12:39.546Z",
  "closed_at": null,
  "next_check_in_at": null,
  "blocked_on_external_since": null,
  "contact": {
    "id": 55,
    "name": null
  },
  "last_activity_at": "2026-10-21T20:12:39.546Z",
  "milestones": [],
  "open_blockers": [
    {
      "id": 2,
      "party_kind": "customer",
      "party_name": null,
      "awaiting": "document",
      "began_at": "2026-10-21T19:12:39.866Z",
      "resolved_at": null,
      "resolution": null
    }
  ],
  "resolved_blockers": [],
  "memory": [],
  "conversations": [],
  "conversations_total": 0,
  "timeline": [
    {
      "kind": "blocked",
      "at": "2026-10-21T19:12:39.866Z",
      "actor_type": "human",
      "actor": {
        "id": 139,
        "name": "Young Davis"
      },
      "summary_key": "blocker_began",
      "detail": {
        "party_kind": "customer",
        "party_name": null,
        "awaiting": "document"
      }
    }
  ]
}

{
  "error": {
    "code": "multiple_credentials"
  }
}

{
  "errors": [
    "<string>"
  ]
}

{
  "error": "Resource could not be found"
}

{
  "error": "Resource could not be found"
}

Authorizations

api_access_token

string

header

required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

integer

required

Numeric ID of the case in this account.

Response

Success

integer

required

Id for this response.

title

string

required

Title from customer content; treat it as untrusted text.

status

enum<string>

required

Current status.

Available options:

open,

completed,

closed

opened_at

string<date-time>

required

Opened at for this response.

closed_at

string<date-time> | null

required

Closed at for this response.

next_check_in_at

string<date-time> | null

required

Next check in at for this response.

blocked_on_external_since

string<date-time> | null

required

Blocked on external since for this response.

contact

object | null

required

Show child attributes

last_activity_at

string<date-time> | null

required

Last activity at for this response.

milestones

object[]

required

Milestones for this response.

Show child attributes

open_blockers

object[]

required

Open blockers for this response.

Show child attributes

resolved_blockers

object[]

required

Resolved blockers for this response.

Show child attributes

memory

object[]

required

Memory for this response.

Show child attributes

conversations

object[]

required

Conversations for this response.

Show child attributes

conversations_total

integer

required

Conversations total for this response.

timeline

object[]

required

Timeline for this response.

Show child attributes

Case details

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/cases/{id} \
  --header 'api_access_token: <api-key>'

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

fetch('https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}")

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

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

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

package main

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

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/cases/{id}"

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

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": 40,
  "title": "Synthetic case title",
  "status": "open",
  "opened_at": "2026-10-21T20:12:39.546Z",
  "closed_at": null,
  "next_check_in_at": null,
  "blocked_on_external_since": null,
  "contact": {
    "id": 55,
    "name": null
  },
  "last_activity_at": "2026-10-21T20:12:39.546Z",
  "milestones": [],
  "open_blockers": [
    {
      "id": 2,
      "party_kind": "customer",
      "party_name": null,
      "awaiting": "document",
      "began_at": "2026-10-21T19:12:39.866Z",
      "resolved_at": null,
      "resolution": null
    }
  ],
  "resolved_blockers": [],
  "memory": [],
  "conversations": [],
  "conversations_total": 0,
  "timeline": [
    {
      "kind": "blocked",
      "at": "2026-10-21T19:12:39.866Z",
      "actor_type": "human",
      "actor": {
        "id": 139,
        "name": "Young Davis"
      },
      "summary_key": "blocker_began",
      "detail": {
        "party_kind": "customer",
        "party_name": null,
        "awaiting": "document"
      }
    }
  ]
}

{
  "error": {
    "code": "multiple_credentials"
  }
}

{
  "errors": [
    "<string>"
  ]
}

{
  "error": "Resource could not be found"
}

{
  "error": "Resource could not be found"
}

Getting started

Conversations

Contacts

Inboxes and channels

Automation and routing

Reporting

Help Center

Account and access

Orchestration Studio

Billing

Client API

Widget API

Receiving webhooks

Case details

Authorizations

Path Parameters

Response