Problems

The Problems API allows you to manage patient problems and diagnoses in Jump EHR. Problems track medical conditions, diagnoses, and health concerns.

Endpoints

Method	Endpoint	Description
`GET`	`/problems`	List all problems
`GET`	`/problems/{id}`	Retrieve a problem
`POST`	`/problems`	Create a problem

Required scopes: read_problems for GET requests, write_problems for POST requests.

The Problem Object

{
  "id": "prb_123e4567-e89b-12d3-a456-426614174000",
  "patient_id": "pat_456e7890-e89b-12d3-a456-426614174111",
  "problem_name": "Type 2 Diabetes Mellitus",
  "snomed_code": "44054006",
  "icd10_code": "E11",
  "status": "active",
  "severity": "moderate",
  "onset_date": "2023-06-15",
  "end_date": null,
  "notes": "Well-controlled with metformin",
  "created_at": "2023-06-15T10:00:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}

Attributes

Field	Type	Description
`id`	string	Unique identifier (UUID)
`patient_id`	string	Associated patient ID
`problem_name`	string	Name/description of the problem
`snomed_code`	string	SNOMED CT code
`icd10_code`	string	ICD-10 code
`status`	string	active, resolved, or inactive
`severity`	string	mild, moderate, or severe
`onset_date`	string	Date problem started (YYYY-MM-DD)
`end_date`	string	Date problem resolved (YYYY-MM-DD)
`notes`	string	Clinical notes
`created_at`	string	ISO 8601 creation timestamp
`updated_at`	string	ISO 8601 last update timestamp

List Problems

GET /problems

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	100	Number of records (max 100)
`offset`	integer	0	Pagination offset
`patient_id`	string	-	Filter by patient
`status`	string	-	Filter by status (active, resolved, inactive)

Request

curl -X GET "https://app.usejump.co.uk/functions/v1/api-v1/problems?patient_id=pat_456e7890&status=active" \
  -H "Authorization: Bearer pk_live_your_api_key"

Response

{
  "data": [
    {
      "id": "prb_123e4567-e89b-12d3-a456-426614174000",
      "patient_id": "pat_456e7890-e89b-12d3-a456-426614174111",
      "problem_name": "Type 2 Diabetes Mellitus",
      "snomed_code": "44054006",
      "status": "active",
      "severity": "moderate",
      "onset_date": "2023-06-15"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 100,
    "offset": 0,
    "has_more": false
  }
}

Retrieve a Problem

GET /problems/{id}

Request

curl -X GET "https://app.usejump.co.uk/functions/v1/api-v1/problems/prb_123e4567" \
  -H "Authorization: Bearer pk_live_your_api_key"

Create a Problem

POST /problems

Request Body

Field	Type	Required	Description
`patient_id`	string	Yes	Patient ID
`problem_name`	string	Yes	Problem description
`snomed_code`	string	No	SNOMED CT code
`icd10_code`	string	No	ICD-10 code
`status`	string	No	Status (default: active)
`severity`	string	No	mild, moderate, or severe
`onset_date`	string	No	Date of onset
`notes`	string	No	Clinical notes

Request

curl -X POST "https://app.usejump.co.uk/functions/v1/api-v1/problems" \
  -H "Authorization: Bearer pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": "pat_456e7890-e89b-12d3-a456-426614174111",
    "problem_name": "Essential Hypertension",
    "snomed_code": "59621000",
    "icd10_code": "I10",
    "status": "active",
    "severity": "mild",
    "onset_date": "2025-01-15"
  }'

Related Resources

Patients - Patient records
Consultations - Clinical consultations
Prescriptions - Medications

Consultations Appointments