logo
API docs by Redocly

AlfaDocs API (1.1.1)

Download OpenAPI specification:

Introduction

This API of AlfaDocs is documented using the OpenAPI format. In addition to the OpenAPI syntax, we use a few vendor extensions.

Location

The API is located at https://app.alfadocs.com/api/. SSL is used for transport security.

Rate Limiting

The API has a rate limit of 10 requests per second.

Authentication

1. API Key Authentication

You need to specify the X-Api-Key field in the request header using the API Key. An API key is related to a certain archive. You create an API Key for your archive inside of AlfaDocs, in Impostazioni -> Studio -> Chiavi.

2. OAuth2 Authentication

For more secure integration, follow these OAuth2 authentication steps:

Step 1: Authorization Request

Send GET request to /oauth2/authorize with:

  • client_id: YOUR_CLIENT_ID
  • redirect_uri: YOUR_CALLBACK_URL
  • response_type: code
  • scope: requested permissions (e.g., patient:list patient:view)

Step 2: Exchange Code

POST to /oauth2/token with: Content-Type: application/x-www-form-urlencoded

  • grant_type: authorization_code
  • client_id: YOUR_CLIENT_ID
  • client_secret: YOUR_CLIENT_SECRET
  • code: received authorization code
  • redirect_uri: YOUR_CALLBACK_URL

Step 3: Use Token

Add to request headers: Authorization: Bearer YOUR_ACCESS_TOKEN

Step 4: Refresh Token

POST to /oauth2/token with: Content-Type: application/x-www-form-urlencoded

  • grant_type: refresh_token
  • client_id: YOUR_CLIENT_ID
  • client_secret: YOUR_CLIENT_SECRET
  • refresh_token: YOUR_REFRESH_TOKEN

Usage

The API currently does not have a usage limit. However, AlfaDocs reserves the right to limit the API usage and also to ask for a fee related to the API usage.

Feedback

If you discover bugs or you need other API functionalities, just tell us. While doing so, please specify the use case. Generally, feedback is always welcome. Feel free to contact our support.

Accounts

API endpoints for account management

Get accounts

Get a list of accounts. Accounts are related to the transactions.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Delete account

Delete an account. Accounts are related to the transactions.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Account ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "success": true
}

Anamnesis Forms

API endpoints for anamnesis form management

Get anamnesis forms

Get a list of anamnesis forms for the specified archive.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "0": {
    },
  • "error": "Authentication required"
}

Delete anamnesis form

Delete an anamnesis form by ID.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Anamnesis Form ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "success": true
}

Anamnesis Interviews

API endpoints for anamnesis interview management

Delete anamnesis interview

Delete an anamnesis interview by ID.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Anamnesis Interview ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "success": true
}

Get required anamnesis interviews information

Get required anamnesis interviews information for a certain patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "requiredForms": [
    ],
  • "completedInterviews": [
    ]
}

Anamnesis Questions

API endpoints for anamnesis question management

Delete anamnesis question

Delete an anamnesis question by ID.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Anamnesis Question ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "success": true
}

Appointment Booking Reasons

Get the list of appointment booking reasons

Get appointment booking reasons

Get the information related to all configured appointment booking reasons.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Delete appointment booking reason

Delete an appointment booking reason.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Appointment Booking Reason ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Appointments

API endpoints for appointment management

Get appointments

Get a list of appointments. The default Date filter is from current date to Sunday +14 days. The maximum datetime range is 30 days.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
dateStart
string <Y-m-d>

Start date

dateEnd
string <Y-m-d>

End date

state
string
Enum: "absent" "waiting" "in_care" "done" "cancelled" "confirmed"

Appointment State

patientId
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create an appointment

Create an appointment

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

Request Body schema: application/json
error
string

Authentication required

date
required
string <date-time>

Appointment's date

patientId
integer

Patient's ID

emailReminder
boolean

Email reminder

smsReminder
boolean

SMS reminder

description
string

Appointment description

allDay
boolean

Is it a full day appointment?

type
string
Enum: "telehealth" "inPractice"

Type of appointment

duration
integer

Duration of the appointment in minutes

state
string

Appointment State

colorId
required
integer

ID of the color for the appointment in the agenda.

chairId
integer

Chair ID of the practice

operatorId
integer

Operator ID

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "date": "2020-01-01 00:00:00",
  • "patientId": 69215,
  • "emailReminder": false,
  • "smsReminder": true,
  • "description": "Appointment",
  • "allDay": false,
  • "type": "telehealth",
  • "duration": 30,
  • "state": "string",
  • "colorId": 85665,
  • "chairId": 2285362,
  • "operatorId": 965563
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get an appointment

Get the information related to an appointment.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

appointmentId
required
integer

Appointment ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Update an appointment

Update an existing appointment's one or multiple attributes.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

appointmentId
required
integer

Appointment id

Request Body schema: application/json
error
string

Authentication required

date
required
string <date-time>

Appointment's date

patientId
integer

Patient's ID

emailReminder
boolean

Email reminder

smsReminder
boolean

SMS reminder

description
string

Appointment description

allDay
boolean

Is it a full day appointment?

type
string
Enum: "telehealth" "inPractice"

Type of appointment

duration
integer

Duration of the appointment in minutes

state
string

Appointment State

colorId
required
integer

ID of the color for the appointment in the agenda.

chairId
integer

Chair ID of the practice

operatorId
integer

Operator ID

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "date": "2020-01-01 00:00:00",
  • "patientId": 69215,
  • "emailReminder": false,
  • "smsReminder": true,
  • "description": "Appointment",
  • "allDay": false,
  • "type": "telehealth",
  • "duration": 30,
  • "state": "string",
  • "colorId": 85665,
  • "chairId": 2285362,
  • "operatorId": 965563
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get the Care Plan Entries

Returns the CarePlan Entries related to the given appointment ID.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

appointmentId
required
integer

Appointment ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Execute unexecuted care plan entries from appointment

Execute all unexecuted care plan entries associated with an appointment.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

appointmentId
required
integer

Appointment ID

Responses

Response samples

Content type
application/json
{ }

Stream AlfaGPT conversation

Stream AlfaGPT conversation for appointment-related queries.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
question
required
string

Question to ask AlfaGPT

Responses

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Archives

API endpoints for archive management

Get current archive ID

Get the ID of the current archive.

Authorizations:
apiKeyoauth2

Responses

Response samples

Content type
application/json
123

Get current archive

Get the current archive details.

Authorizations:
apiKeyoauth2

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "id": 123,
  • "defaultPriceListId": 456
}

Patch current archive

Update the current archive settings.

Authorizations:
apiKeyoauth2
Request Body schema: application/json
defaultOutgoingBillNumberPrefixId
integer

Default Outgoing Bill Number Prefix ID

Responses

Request samples

Content type
application/json
{
  • "defaultOutgoingBillNumberPrefixId": 0
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "defaultOutgoingBillNumberPrefixId": 789
}

Bills

API endpoints for bill management

Get a filtered list of Bills

Get a filtered list of bills. By default, the list of bills is limited to the last 31 calendar days. You can filter bills using a maximum time range of 31 days.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
dateStart
string <date>
Example: dateStart=2025-01-22

Start date

dateEnd
string <date>
Example: dateEnd=2025-01-22

End date

type
string
Enum: "full" "partial" "credit" "proforma"

Bill Type

direction
string
Enum: "incoming" "outgoing"

Bill direction

carePlanId
integer

Care Plan ID

createdByUserId
integer

Filter by creator user ID

createdByUserEmail
string

Filter by creator email

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create or edit bill

Create a new bill or edit an existing bill.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": { }
}

Get a Bill

Get the information related to a Bill.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

billId
required
integer

Bill ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": { }
}

Bill Liabilities

API endpoints for bill liability management

Get bill liabilities

Get a list of liabilities for a given bill ID.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

billId
required
integer

Bill ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Delete a bill liability

Delete a bill liability from the given archive.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

billId
required
integer

Bill ID

liabilityId
required
integer

Liability id

Responses

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Update a bill liability

Update a bill liability from the given archive.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

billId
required
integer

Bill ID

liabilityId
required
integer

Liability id

header Parameters
X-Api-Key
required
string
Example: JcqPcPQ0Cg07vfYatzZPvuJO3ueuaec3

API Key Authentication

Responses

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Care Plans

Get the list of the CarePlans

Get a Care Plan

Get a specific Care Plan defined by its ID

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

carePlanId
required
integer

Care Plan ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get signature status

Returns if the specified CarePlan is signed

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

carePlanId
required
integer

Care Plan ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "isSigned": false
}

Get care plans by patient

Get a list of care plans for a specific patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete care plan

Delete a care plan.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Care Plan ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Get care plan consent templates

Get a list of consent templates for a specific care plan.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

carePlanId
required
integer

Care Plan ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Chairs

Get the list of the chairs

Get chairs

Get the information related to all configured chairs.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create chair

Create a new chair.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Request Body schema: application/json
required
name
string

Chair name

Responses

Request samples

Content type
application/json
{
  • "name": "Poltrona 1"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string"
}

Delete chair

Delete an existing chair.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

chairId
required
integer

Chair ID

Responses

Response samples

Content type
application/json
{ }

Update chair

Update an existing chair.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

chairId
required
integer

Chair ID

Request Body schema: application/json
required
name
string

Chair name

Responses

Request samples

Content type
application/json
{
  • "name": "Poltrona 1"
}

Response samples

Content type
application/json
{ }

Colors

Get the list of colors

Get colors

Get the information related to all configured colors.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Context

API endpoints for the context

Get context

Get the practice and archive ID that are related to the given API key.

Authorizations:
apiKeyoauth2

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Custom Object Fields

API endpoints for Custom Object Fields

Get Custom Object Fields

Get the list of all Custom Object Fields. By default, custom fields of all object types (patient, care_plan, etc.) will be returned. You can filter by Object type if you just need the custom field of a specific Object Type.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
objectType
string

Filter by Object Type (f.e. patient or care_plan)

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create Custom Object Field

Create a Custom Object Field.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Request Body schema: application/json
error
string

Authentication required

id
integer

Custom Object Field ID

objectType
string

The object type to which the field is related to (f.e. patient or care_plan).

label
string <= 32 characters

The label of the field (max 32 characters)

technicalName
string <= 32 characters

The technical name of the field (max 32 characters)

type
string

The type of the field (f.e. single_line_text, single_checkbox, dropdown).

choices
Array of strings

The list of dropdown choices. This is only relevant if type is 'dropdown'.

sequenceNumber
integer
Default: null

The sequence number of the field

toBeCompleted
boolean
Default: false

Whether this field should appear in patient data completion workflow

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "id": 8364,
  • "objectType": "patient",
  • "label": "Person Height",
  • "technicalName": "personHeight",
  • "type": "dropdown",
  • "choices": [
    ],
  • "sequenceNumber": 1,
  • "toBeCompleted": false
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Document

API endpoints for document management

Delete a document

Delete a document by ID.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Document ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Update a document

Update a document's properties.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Document ID

Request Body schema: application/json
required
name
string

Document name

type
string

Document type

clinical
boolean

Whether the document is clinical

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "type": "string",
  • "clinical": true
}

Response samples

Content type
application/json
{
  • "success": true
}

Get documents

Retrieves a list of documents for a specified patient, including each document's name, type, creation date, and download URL.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{}

Create a document

Add a new document to the selected patient. You can check the file inside the Patient profile -> Document tab.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient ID

Request Body schema: application/json
error
string

Authentication required

base64Data
required
string

base64 encoded file data

type
required
string
Enum: "text" "xray" "image" "identification" "electronic_signature_patient_details" "electronic_signature_patient_details_and_terms_and_conditions" "other"

File type

name
required
string

File name

folderName
required
string

Folder name where the document it's going to be

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "base64Data": "string",
  • "type": "text",
  • "name": "string",
  • "folderName": "string"
}

Response samples

Content type
application/json
{}

Get document's information

Retrieve the information of the selected document. The information includes the name, type, creation date and download URL.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

documentId
required
integer

Document ID

Responses

Response samples

Content type
application/json
{}

Download a document's content

Triggers the download of a specific document's content for a patient, providing direct access to the document's binary file.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

documentId
required
integer

Document ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "file": "string"
}

Start document preview generation

Start the document preview generation process.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

documentId
required
integer

Document ID

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Free Slots

Get available free slots to set an appointment.

Get free slots

Get a list of free slots available for a duration of time starting from the startDate.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

startDate
required
string <date-time>

Start date

query Parameters
endDate
string <date-time>

End date

duration
required
integer

Slot duration (in minutes)

operatorIds
Array of integers
Example: operatorIds=1,2,3,4

Operator's ID

chairIds
Array of integers
Example: chairIds=1,2,3

Chair's ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Marketplace Apps

Endpoints for managing marketplace app integrations.

Update the UI elements for a practice and a marketplace app

Updates the UI elements for a practice and a marketplace app after the user finished the integration.

Authorizations:
oauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

uiElementName
required
string

UIElement Name

Responses

Response samples

Content type
application/json
{
  • "error": "invalid_request",
  • "error_description": "The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed."
}

Delete a UI element for a marketplace app / practice combination

Deletes a UI element for a marketplace app and a practice

Authorizations:
oauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

uiElementName
required
string

UIElement Name

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "string"
}

Create or Update the UI elements for a marketplace app

Updates the UI elements for a marketplace app after the user finished the integration.

Authorizations:
oauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

uiElementName
required
string

UIElement Name

Request Body schema: application/json
error
string

Authentication required

Array of objects (UIElementRequestBodyItem)

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "string",
  • "data": [
    ]
}

OAuth2 Authentication

Endpoints for OAuth2 authentication, including authorization and token exchange.

Obtain OAuth2 Authorization Code

Redirects the user for authentication and consent, then provides an authorization code to the client application.

query Parameters
client_id
required
string

The client ID of the application requesting access

redirect_uri
required
string <url>

The URL to redirect the user after authorization

response_type
required
string
Default: "code"

The type of response requested (e.g., 'code')

scope
string

A space-separated list of scopes the client is requesting

Responses

Response samples

Content type
application/json
{
  • "error": "invalid_request",
  • "error_description": "The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed."
}

Obtain Access and Refresh Tokens

Handles token exchange for authorization code and refresh token grant types.

Request Body schema: application/x-www-form-urlencoded

Token request payload for both grant types

error
string

Authentication required

grant_type
required
string

Specifies the OAuth 2.0 grant type: 'authorization_code' for exchanging auth codes for tokens, or 'refresh_token' for obtaining new access tokens without re-authentication.

client_id
required
string

The client ID of the application.

client_secret
required
string

The client secret of the application.

code
string or null

The authorization code issued by the authorization server. Required for the authorization code flow.

redirect_uri
string or null

The redirect URI associated with the authorization code. Required for the authorization code flow.

refresh_token
string or null

The refresh token to obtain a new access token. Required for the refresh token flow.

scope
string or null

Optional space-separated scopes to request. Should be a subset of the original scopes.

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "token_type": "Bearer",
  • "expires_in": 3600,
  • "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6I...",
  • "refresh_token": "def50200d1c8d7iLCJhbGciOiJSUzI1NiIsImp0aSI6I..."
}

Operators

Get the list of operators

Get operators

Get the information related to all configured operators.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
ignoreDeleted
boolean
Example: ignoreDeleted=true

To ignore deleted operators otherwise deleted operators will be included

italianFiscalCode
string

filter Operator by italianFiscalCode

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Get operator

Get the information related to a specific operator.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

operatorId
required
integer

Operator ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "id": 33963,
  • "name": "Mario Rossi",
  • "italianFiscalCode": "AAA BBB 99H11 L999X",
  • "sequenceNumber": 1,
  • "deleted": false,
  • "colorId": 1
}

Update operator

Update an operator's information.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

operatorId
required
integer

Operator ID

Request Body schema: application/json
required
businessHours
object

Responses

Request samples

Content type
application/json
{
  • "businessHours": { }
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "id": 33963,
  • "name": "Mario Rossi",
  • "italianFiscalCode": "AAA BBB 99H11 L999X",
  • "sequenceNumber": 1,
  • "deleted": false,
  • "colorId": 1
}

Delete operator

Delete an operator.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Operator ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Upload operator image

Upload an image for an operator.

Authorizations:
apiKeyoauth2
path Parameters
operatorId
required
integer

Operator ID

Request Body schema: application/json
required
base64ImageData
string

Base64 encoded image data

Responses

Request samples

Content type
application/json
{
  • "base64ImageData": "string"
}

Response samples

Content type
application/json
{
  • "success": true
}

Patient Calls

API endpoints for patient call management

Create a new call for a patient

Creates a new call record for a specific patient in the system.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

Request Body schema: application/json
error
string

Authentication required

date
required
string <date-time>

Call date and time

description
string

Call description

outcome
string

Call outcome (no_answer, busy, wrong_number, left_voicemail, connected)

purpose
string

Call purpose (lead_without_appointment, appointment_missed, care_plan_acceptance, payment, other)

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "date": "2023-12-01 14:30:00",
  • "description": "Follow-up call regarding treatment",
  • "outcome": "connected",
  • "purpose": "care_plan_acceptance"
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Update a call for a patient

Updates an existing call record for a specific patient in the system.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

callId
required
integer

Call id

Request Body schema: application/json
error
string

Authentication required

date
string <date-time>

Call date and time

description
string

Call description

outcome
string

Call outcome (no_answer, busy, wrong_number, left_voicemail, connected)

purpose
string

Call purpose (lead_without_appointment, appointment_missed, care_plan_acceptance, payment, other)

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "date": "2023-12-01 14:30:00",
  • "description": "Follow-up call regarding treatment",
  • "outcome": "connected",
  • "purpose": "care_plan_acceptance"
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Delete a call for a patient

Deletes an existing call record for a specific patient from the system.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

callId
required
integer

Call id

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Patients

API endpoints for patient management

Get call stream data for a patient

Get call stream data for a patient

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get patients

By passing in the appropriate options, you can search for available patients in the system. Custom fields have an underscore as prefix

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

query Parameters
phoneNumberPrefix
string <0039>

Phone number prefix

phoneNumber
string <1112233444>

Phone number

italianFiscalCode
string
Example: italianFiscalCode=RSSMRA85T10A562S

To filter patients by italianFiscalCode

offset
integer

Offset to move the result window forward

limit
integer

Number of results in response

firstName
string

First Name

lastName
string

Last Name

email
string

Email

dateBirth
string
Example: dateBirth=1989-10-11

Date of Birth

createdAtFrom
string <date>
Example: createdAtFrom=2024-01-01

Filter patients created on or after this date

createdAtTo
string <date>
Example: createdAtTo=2024-12-31

Filter patients created on or before this date

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "links": { },
  • "total": 1,
  • "offset": 0,
  • "limit": 100,
  • "results": [
    ]
}

Create a patient

Adds a new patient to the system. You can also add the custom patient fields that you defined on Gestione -> Pazienti -> Impostazioni Paziente by just putting the technical name and the value on the body.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

Request Body schema: application/json
error
string

Authentication required

firstName
required
string

Patient first name

lastName
required
string

Patient last name

email
string

Patient last name

emailEnabled
boolean

If the patient has email sending enabled

gender
string
Enum: "m" "f"

Gender of the patient

street
string

Street address of the patient

city
string

City of the patient

postcode
string

Zip code of the patient

province
string

Province of the patient

dateOfBirth
string

Date of birth of the patient

placeOfBirth
string

City of birth

italianFiscalCode
string

Italian fiscal code

job
string

Software Engineer

yearlyNumberingYear
string

Yearly numbering year

yearlyNumberingNumber
integer

Yearly numbering number

defaultDiscount
integer

Default percentage of discount

sourceId
integer

ID of the patient's source. You can customize the sources available in the Impostazioni -> Studio -> Fonte Pazienti

priceListId
integer

Price list ID. You can find the price lists in the Impostazioni -> Studio -> Prestazioni -> Listini menu

emailReminderPossible
boolean

Is possible to send emails reminders to the patient?

smsReminderPossible
boolean

Is possible to send SMS reminders to the patient?

createdAt
string <date-time>

Creation date

documentSignatureEmailPossible
boolean

Is possible to send documents requesting signature?

lastModifiedAt
string <date-time>

Last modified date

_sampleCustomField
string <string>

The custom field value

Array of objects (PhoneNumberNewItem)

List of phone numbers

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "firstName": "string",
  • "lastName": "string",
  • "email": "string",
  • "emailEnabled": true,
  • "gender": "m",
  • "street": "Via Albertazzi 1",
  • "city": "Milano",
  • "postcode": "20100",
  • "province": "MI",
  • "dateOfBirth": "1989-10-11",
  • "placeOfBirth": "Milano",
  • "italianFiscalCode": "RSSMRA85T10A562S",
  • "job": "string",
  • "yearlyNumberingYear": "2018",
  • "yearlyNumberingNumber": "2018",
  • "defaultDiscount": 20,
  • "sourceId": 283,
  • "priceListId": 283,
  • "emailReminderPossible": "true",
  • "smsReminderPossible": "true",
  • "createdAt": "2018-04-01 00:00:00",
  • "documentSignatureEmailPossible": "true",
  • "lastModifiedAt": "2022-06-17 00:00:00",
  • "_sampleCustomField": "string",
  • "phoneNumbers": [
    ]
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get a patient

Get patient info. It also works for deleted patients, but returns only some data. The endpoint will also return the custom patient field values. These custom fields have an underscore as prefix

Authorizations:
apiKeyoauth2
path Parameters
patientId
required
integer

Patient id

practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Delete a patient

Delete a patient from the given archive.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

patientId
required
integer

Patient id

archiveId
required
integer

Archive id

Responses

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Update a patient

Update an existing patient from the archive. You can also update custom fields that you defined in Gestione -> Pazienti -> Impostazioni Paziente by using the technical name with an underscore as prefix.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

patientId
required
integer

Patient id

archiveId
required
integer

Archive id

Request Body schema: application/json
error
string

Authentication required

firstName
required
string

Patient first name

lastName
required
string

Patient last name

email
string

Patient last name

emailEnabled
boolean

If the patient has email sending enabled

gender
string
Enum: "m" "f"

Gender of the patient

street
string

Street address of the patient

city
string

City of the patient

postcode
string

Zip code of the patient

province
string

Province of the patient

dateOfBirth
string

Date of birth of the patient

placeOfBirth
string

City of birth

italianFiscalCode
string

Italian fiscal code

job
string

Software Engineer

yearlyNumberingYear
string

Yearly numbering year

yearlyNumberingNumber
integer

Yearly numbering number

defaultDiscount
integer

Default percentage of discount

sourceId
integer

ID of the patient's source. You can customize the sources available in the Impostazioni -> Studio -> Fonte Pazienti

priceListId
integer

Price list ID. You can find the price lists in the Impostazioni -> Studio -> Prestazioni -> Listini menu

emailReminderPossible
boolean

Is possible to send emails reminders to the patient?

smsReminderPossible
boolean

Is possible to send SMS reminders to the patient?

createdAt
string <date-time>

Creation date

documentSignatureEmailPossible
boolean

Is possible to send documents requesting signature?

lastModifiedAt
string <date-time>

Last modified date

_sampleCustomField
string <string>

The custom field value

Array of objects (PhoneNumberNewItem)

List of phone numbers

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "firstName": "string",
  • "lastName": "string",
  • "email": "string",
  • "emailEnabled": true,
  • "gender": "m",
  • "street": "Via Albertazzi 1",
  • "city": "Milano",
  • "postcode": "20100",
  • "province": "MI",
  • "dateOfBirth": "1989-10-11",
  • "placeOfBirth": "Milano",
  • "italianFiscalCode": "RSSMRA85T10A562S",
  • "job": "string",
  • "yearlyNumberingYear": "2018",
  • "yearlyNumberingNumber": "2018",
  • "defaultDiscount": 20,
  • "sourceId": 283,
  • "priceListId": 283,
  • "emailReminderPossible": "true",
  • "smsReminderPossible": "true",
  • "createdAt": "2018-04-01 00:00:00",
  • "documentSignatureEmailPossible": "true",
  • "lastModifiedAt": "2022-06-17 00:00:00",
  • "_sampleCustomField": "string",
  • "phoneNumbers": [
    ]
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get patient timeline

Get the timeline stream for a patient including notes, appointments, calls, claims, and care plans.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
[
  • { }
]

Get patient reminder settings

Get patient's reminder settings for email and SMS.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

query Parameters
selectedAppointmentDate
string

Selected appointment date

Responses

Response samples

Content type
application/json
{ }

Get electronic signature terms and conditions status

Find out if a given patient accepted the electronic signature terms and conditions.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "patientAcceptedTermsAndConditions": true
}

Get patient identification details

Get patient's identification document details.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "documentId": 0,
  • "expirationDate": "string"
}

Upload patient image

Save a web camera image for a patient.

Authorizations:
apiKeyoauth2
path Parameters
patientId
required
integer

Patient ID

Request Body schema: application/json
required
base64ImageData
string

Base64 encoded image data

Responses

Request samples

Content type
application/json
{
  • "base64ImageData": "string"
}

Response samples

Content type
application/json
{
  • "success": true
}

Get required objects information

Get required objects information for a certain patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "numberOfRequiredObjects": 0,
  • "numberOfCompletedRequiredObjects": 0
}

Get patient images

Provide patient's images to show in the image viewer.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

Update a patients custom field

Update an existing patient custom field from the archive. You can also update custom fields that you defined in Gestione -> Pazienti -> Impostazioni Paziente by using the technical name with an underscore as prefix.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

Request Body schema: application/json
error
string

Authentication required

Array of objects (PatientCustomFieldItem)

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "string"
}

Phone Numbers

API endpoints for patient's phone numbers management

Get patient's phone numbers

Get all the related phone numbers of an specific patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create a patient's phone number

Add a new phone number to an existing patient

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

Request Body schema: application/json
error
string

Authentication required

prefix
required
string

Country prefix

number
required
string

Number without country prefix

label
string

Label

smsEnabled
boolean

Is this number available for SMS?

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "prefix": "+39",
  • "number": "3471234567",
  • "label": "Cellulare",
  • "smsEnabled": true
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Get specific patient's phone number

Get an specific phone number of a patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

phoneNumberId
required
integer

Phone number id

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Delete patient's phone number

Delete a specific phone number from a patient.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

patientId
required
integer

Patient ID

phoneNumberId
required
integer

Phone number ID

Responses

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Update an specific patient's phone number

Modify an specific phone number from a patient

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

patientId
required
integer

Patient id

phoneNumberId
required
integer

Phone number id

Request Body schema: application/json
error
string

Authentication required

prefix
required
string

Country prefix

number
required
string

Number without country prefix

label
string

Label

smsEnabled
boolean

Is this number available for SMS?

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "prefix": "+39",
  • "number": "3471234567",
  • "label": "Cellulare",
  • "smsEnabled": true
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Callbacks

API endpoints for handling external callbacks from marketplace applications

Payment Callback

Receives payment status updates from external payment apps

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer
Example: 123

Practice ID

archiveId
required
integer
Example: 456

Archive ID

Request Body schema: application/json
required
error
string

Authentication required

paymentRequestId
required
integer

Payment request ID

paymentStatus
required
string
Enum: "paid" "failed"

Payment status

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "paymentRequestId": 123,
  • "paymentStatus": "paid"
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "message": "Payment data updated successfully"
}

Payment Types

API endpoints for payment type management

Get payment types

Get the information related to all payment types.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Update payment types

Update multiple payment types at once.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Request Body schema: application/json
required
Array
id
integer

Payment type ID

fatturazioneElettronicaClassification
string

Electronic invoicing classification

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "error": "Error message"
}

Delete payment type

Delete a payment type (soft delete).

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Payment type ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Practices

API endpoints for practice management

Get practice

Get the information related to the practice.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": { }
}

Update practice

Update practice settings and information.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

Request Body schema: application/json
required
businessHours
object

Business hours by day

alfadocsToPracticeBillingCompanyName
string

Billing company name

alfadocsToPracticeBillingSubject
string

Billing subject

alfadocsToPracticeBillingStreet
string

Billing street

alfadocsToPracticeBillingCity
string

Billing city

alfadocsToPracticeBillingPostcode
string

Billing postcode

alfadocsToPracticeBillingItalianVatNumber
string

Italian VAT number

alfadocsToPracticeBillingItalianFiscalCode
string

Italian fiscal code

alfadocsToPracticeBillingPaymentMethod
string

Payment method

alfadocsToPracticeBillingIban
string

IBAN

alfadocsToPracticeBillingAccountOwnerName
string

Account owner name

alfadocsToPracticeBillingAccountOwnerAddress
string

Account owner address

alfadocsToPracticeBillingPecAddress
string

PEC address

alfadocsToPracticeBillingProvinceCode
string

Province code

useOutgoingBillNumberPrefix
boolean

Use outgoing bill number prefix

phoneNumber
string

Phone number

Responses

Request samples

Content type
application/json
{
  • "businessHours": { },
  • "alfadocsToPracticeBillingCompanyName": "string",
  • "alfadocsToPracticeBillingSubject": "string",
  • "alfadocsToPracticeBillingStreet": "string",
  • "alfadocsToPracticeBillingCity": "string",
  • "alfadocsToPracticeBillingPostcode": "string",
  • "alfadocsToPracticeBillingItalianVatNumber": "string",
  • "alfadocsToPracticeBillingItalianFiscalCode": "string",
  • "alfadocsToPracticeBillingPaymentMethod": "string",
  • "alfadocsToPracticeBillingIban": "string",
  • "alfadocsToPracticeBillingAccountOwnerName": "string",
  • "alfadocsToPracticeBillingAccountOwnerAddress": "string",
  • "alfadocsToPracticeBillingPecAddress": "string",
  • "alfadocsToPracticeBillingProvinceCode": "string",
  • "useOutgoingBillNumberPrefix": true,
  • "phoneNumber": "string"
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": { }
}

Specialties

Get the list of specialties

Get specialties

Get the information related to all configured specialties.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Delete specialty

Delete a specialty.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Specialty ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Transactions

API endpoints for transaction management

Get a filtered list of undeleted transactions

Get a filtered list of undeleted transactions. By default, the list of transaction is limited to the last 31 calendar days. You can filter transactions using a maximum time range of 31 days.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

archiveId
required
integer

Archive ID

query Parameters
dateStart
string <date-time>

Start date

dateEnd
string <date-time>

End date

direction
string
Enum: "incoming" "outgoing"

Transaction direction

billId
integer

Bill ID

createdByUserId
integer

Filter by creator user ID

createdByUserEmail
string

Filter by creator email

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "count": 0,
  • "data": [
    ]
}

Create a Transaction

Create an transaction. If the transaction is related to a bill, the billId parameter is required. If you are dealing with a bill liability, please remember to delete the bill liability after the transaction is created.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice id

archiveId
required
integer

Archive id

Request Body schema: application/json
error
string

Authentication required

amount
required
number

Amount of transaction

date
required
string <date>

Transaction's date

direction
required
string <string>
Enum: "incoming" "outgoing"

Transaction's direction

billId
integer

Bill's ID

accountId
required
integer

Account ID.

paymentTypeId
required
integer

Payment type ID

relatedToInsurance
boolean

Trasaction related to a insurance

sistemaTsExpenseType
required
string
Enum: "tk" "tk2" "fc" "fv" "sp" "ad" "as" "sr" "sr2" "ct" "pi" "ic" "aa" "nn"

Sistema TS type

Responses

Request samples

Content type
application/json
{
  • "error": "Authentication required",
  • "amount": 23.12,
  • "date": "2020-01-01",
  • "direction": "incoming",
  • "billId": 69215,
  • "accountId": 85665,
  • "paymentTypeId": 2285362,
  • "relatedToInsurance": false,
  • "sistemaTsExpenseType": "tk"
}

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Delete transaction

Delete a transaction by ID.

Authorizations:
apiKeyoauth2
path Parameters
id
required
integer

Transaction ID

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Care Plan Entries

Care Plan Entries

Get care plan entries by care plan

Get a list of care plan entries for a specific care plan.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

carePlanId
required
integer

Care Plan ID

sortMode
required
string

Sort mode (default, creation_asc, creation_desc, manual)

query Parameters
excludeDone
boolean

Exclude done entries

extended
boolean

Include extended data

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get a care plan entry

Get a care plan entry

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer
archiveId
required
integer
carePlanId
required
integer
carePlanEntryId
required
integer

Responses

Response samples

Content type
application/json
{
  • "error": "Authentication required",
  • "status": "success",
  • "data": {
    }
}

Update care plan entry

Update a care plan entry.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

carePlanId
required
integer

Care Plan ID

carePlanEntryId
required
integer

Care Plan Entry ID

Request Body schema: application/json
required
isExecuted
boolean

Is executed

executionDate
string <date>

Execution date

elements
Array of strings

Elements

udi
string

UDI

label
string

Label

Responses

Request samples

Content type
application/json
{
  • "isExecuted": true,
  • "executionDate": "2019-08-24",
  • "elements": [
    ],
  • "udi": "string",
  • "label": "string"
}

Response samples

Content type
application/json
{
  • "success": true
}

Delete care plan entry

Delete a care plan entry.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

carePlanId
required
integer

Care Plan ID

carePlanEntryId
required
integer

Care Plan Entry ID

query Parameters
elements
string

Elements to delete (optional)

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Swap sequence numbers

Swap the sequence numbers of two care plan entries.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

carePlanId
required
integer

Care Plan ID

carePlanEntryId1
required
integer

First Care Plan Entry ID

carePlanEntryId2
required
integer

Second Care Plan Entry ID

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Duplicate care plan entry

Duplicate a care plan entry a specified number of times.

Authorizations:
apiKeyoauth2
path Parameters
practiceId
required
integer

Practice ID

carePlanId
required
integer

Care Plan ID

carePlanEntryId
required
integer

Care Plan Entry ID to duplicate

Request Body schema: application/json
required
count
integer

Number of duplicates to create (1-99)

Responses

Request samples

Content type
application/json
{
  • "count": 1
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}