solarOSsolarOS Docs

List Cases

Lists first-class service Cases inside the organization boundary. Supply externalSystem, externalObject, and externalId together to filter by a canonical External Reference. Required scope: cases:read.

GET
/cases

Lists first-class service Cases inside the organization boundary. Supply externalSystem, externalObject, and externalId together to filter by a canonical External Reference. Required scope: cases:read.

Authorization

Authorization<token>

Organization API key. Format: Bearer sk_live_...

In: header

Query Parameters

limit?integer

Maximum records to return. Defaults to 50 and is capped at 100.

Range1 <= value <= 100
Default50
cursor?string

Opaque record cursor from the previous response meta.nextCursor value.

sortDir?string

Sort direction. Defaults to desc.

Default"desc"

Value in

  • "asc"
  • "desc"
status?string

Filter by Case status. CLOSED is the sole terminal status; legacy RESOLVED filters are treated as CLOSED.

Value in

  • "OPEN"
  • "TRIAGING"
  • "IN_PROGRESS"
  • "AWAITING_CUSTOMER"
  • "AWAITING_VENDOR"
  • "AWAITING_WORK"
  • "RESOLVED"
  • "CLOSED"
externalSystem?string

External Reference system filter. Supply with externalObject and externalId for exact reconciliation lookup.

externalObject?string

External Reference object filter. Supply with externalSystem and externalId.

externalId?string

External Reference id filter. Supply with externalSystem and externalObject.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/cases"
{  "data": [    {      "id": "string",      "caseNumber": "string",      "customerId": "string",      "propertyId": "string",      "systemId": "string",      "projectId": "string",      "sourceServiceRequestId": "string",      "subject": "string",      "description": "string",      "origin": "string",      "severity": "string",      "category": "string",      "status": "string",      "resolution": "string",      "ownerId": "string",      "openedAt": "2019-08-24T14:15:22Z",      "firstResponseAt": "2019-08-24T14:15:22Z",      "resolvedAt": "2019-08-24T14:15:22Z",      "closedAt": "2019-08-24T14:15:22Z",      "slaResponseDueAt": "2019-08-24T14:15:22Z",      "slaResolutionDueAt": "2019-08-24T14:15:22Z",      "externalReferences": [        {}      ],      "customFields": {},      "submissionAnswers": {},      "reportedHardware": [        {}      ],      "submittedContact": {},      "externalRecordLinks": [        {          "id": "string",          "externalSystem": "string",          "externalSystemLabel": "string",          "objectLabel": "string",          "recordLabel": "string",          "url": "http://example.com",          "externalId": "string",          "data": {},          "createdAt": "2019-08-24T14:15:22Z"        }      ]    }  ],  "meta": {    "requestId": "string",    "version": "v1",    "timestamp": "2019-08-24T14:15:22Z",    "rateLimit": {      "limit": 0,      "remaining": 0,      "reset": 0    }  }}