API Reference
- Getting Started
- Charges
- Invoices
- Items
- Patients
- Providers
- Roles
- Rules
- Webhooks
Charge Get
Get a Charge
by ID. Also returns any Adjustments
, Payments
or Refunds
for the Charge
.
curl --request GET \
--url https://api.decodahealth.com/v1/charge/get/{charge_id} \
--header 'API-KEY: <api-key>' \
--header 'TENANT: <tenant>'
{
"adjustments": [
{
"adjustmentType": "WRITE_OFF",
"amount": 123,
"chargeId": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"id": "<string>",
"providerId": "<string>",
"reason": "<string>"
}
],
"createdDate": "2023-11-07T05:31:56Z",
"customAmount": 123,
"description": "<string>",
"discountAmount": 123,
"discountPercentage": 123,
"explanationOfBenefits": [
{
"chargeBalance": 123,
"chargeId": "<string>",
"contractualAdjustment": 123,
"diagnoses": "<string>",
"diagnosesDescription": "<string>",
"id": "<string>",
"insurancePayment": 123,
"locationName": "<string>",
"manualAdjustment": 123,
"originalChargeAmount": 123,
"patientBalance": 123,
"patientPayment": 123,
"procedure": "<string>",
"procedureDescription": "<string>"
}
],
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalId": "<string>",
"id": "<string>",
"items": [
{
"chargeId": "<string>",
"discountAmount": 123,
"discountPercentage": 123,
"item": {
"description": "<string>",
"id": "<string>",
"image": "<string>",
"meta": {},
"name": "<string>",
"price": 123,
"unit": "<string>"
},
"itemId": "<string>",
"quantity": 123
}
],
"meta": {},
"patient": {
"address": "<string>",
"addressLineTwo": "<string>",
"addressValid": true,
"allergies": [
"<string>"
],
"city": "<string>",
"country": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"dateOfBirth": "2023-12-25",
"email": "<string>",
"externalUserId": "<string>",
"familyHistory": [
"<string>"
],
"firstName": "<string>",
"id": "<string>",
"lastName": "<string>",
"medicalHistory": [
"<string>"
],
"medications": [
"<string>"
],
"meta": {},
"optedOutOfSms": false,
"phoneNumber": "<string>",
"prescriptions": [
"<string>"
],
"state": "<string>",
"type": "<string>",
"zipCode": "<string>"
},
"patientId": "<string>",
"patientPaysProcessingFee": true,
"payments": [
{
"amount": 123,
"charge": {
"externalId": "<string>",
"id": "<string>",
"meta": {},
"total": 123,
"totalOutstanding": 123
},
"chargeId": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"payment": {
"amount": 123,
"createdDate": "2023-11-07T05:31:56Z",
"currency": "USD",
"failedReason": "<string>",
"fee": 123,
"id": "<string>",
"patientId": "<string>",
"payinConfigId": "<string>",
"payinId": "<string>",
"paymentMedium": "POS",
"paymentMethod": {
"accountHolderType": "<string>",
"accountNumberLast4": 123,
"bankName": "<string>",
"brand": "<string>",
"description": "<string>",
"expMonth": 123,
"expYear": 123,
"id": "<string>",
"last4": "<string>",
"patientId": "<string>",
"rainforestPaymentMethodId": "<string>",
"routingNumber": 123,
"type": "CARD"
},
"paymentMethodId": "<string>",
"refunds": [
{
"amount": 123,
"createdDate": "2023-11-07T05:31:56Z",
"fee": 0,
"id": "<string>",
"paymentId": "<string>",
"rainforestRefundId": "<string>",
"reason": "DUPLICATE",
"status": "CANCELED"
}
],
"status": "CANCELED",
"stripePaymentIntentId": "<string>",
"updatedDate": "2023-11-07T05:31:56Z"
},
"paymentId": "<string>"
}
],
"ruleSetId": "<string>",
"status": "OUTSTANDING",
"total": 123,
"totalOutstanding": 123
}
Headers
The tenant you are making this request on behalf of
Your api key
Path Parameters
Response
Type of the adjustment
WRITE_OFF
, ADJUSTMENT
, EXTERNAL_SETTLEMENT
Amount of the adjustment
Date when the adjustment was created
Unique identifier for the adjustment
Reason for the adjustment
The date when the charge was created.
Any un-itemized amount that makes up the charge.
Amount of discount applied to the charge.
Percentage of discount applied to the charge.
Identifier of the charge this explanation of benefit is associated with.
Diagnoses codes for the explanation of benefit.
Description of the diagnoses.
Unique identifier for the explanation of benefit.
Procedure code for the explanation of benefit.
Description of the procedure.
Remaining balance on the charge.
Amount of contractual adjustment.
Amount paid by insurance.
Name of the location where the charge was created.
Amount of manual adjustment.
Original amount charged.
Remaining balance for the patient.
Amount paid by patient.
Unique identifier for the charge.
Identifier of the charge this item is associated with.
Amount of discount applied to this item.
Percentage of discount applied to this item.
Unique identifier for the item.
Quantity of the item being charged.
Summary details of the item being charged.
Unique identifier for the item
Name of the item
Price of the item in cents
Optional description of the item
Optional URL to an image of the item
Any additional metadata about the item relevant to your system.
Optional unit of measurement for the item
Summary details of the patient being charged.
The date and time when the user was created.
The user's first name.
The unique identifier for the user.
The type of user.
The user's primary address.
Additional address information.
Whether the user's address is valid.
List of patient's allergies.
The city of the user's address.
The country of the user's address.
The date of birth of the patient.
The user's email address.
The user's external identifier if available.
List of patient's family medical history.
The user's last name.
List of patient's medical history.
List of patient's medications.
Any additional metadata about the user relevant to your system.
Indicates whether the patient has opted out of receiving SMS messages.
The user's phone number.
List of patient's prescriptions.
The state of the user's address.
The postal code of the user's address.
Identifier of the patient being charged.
Indicates if the patient is responsible for processing fees.
The amount of the payment.
The unique identifier for the charge.
The date and time the payment was created.
Detailed information about the payment.
The total amount of the payment.
The date and time the payment was created.
The fee associated with the transaction.
The unique identifier for the payment.
The medium through which the payment was made.
POS
, VIRTUAL_TERMINAL
, PAYMENT_LINK
, PAYMENT_PLAN
, EMBEDDED_FORM
, SUBSCRIPTION
, CASH
, PATIENT_PORTAL
List of refunds associated with the payment.
DUPLICATE
, DISPUTE
, OTHER
CANCELED
, CREATED
, FAILED
, IN_REVIEW
, PRESENTING
, PROCESSING
, SUCCEEDED
The current status of the payment.
CANCELED
, CREATED
, FAILED
, IN_REVIEW
, PRESENTING
, PROCESSING
, SUCCEEDED
The currency in which the payment was made.
Reason for payment failure if applicable.
The ID of the patient associated with the payment.
The configuration ID for the payin.
The ID of the payin associated with the payment.
Summary of the payment method used.
CARD
, ACH
, APPLE_PAY
The ID of the payment method used.
Stripe's payment intent ID if used.
The date and time the payment was last updated.
The unique identifier for the payment.
Current status of the charge.
OUTSTANDING
, PAID
, EXTERNAL_SETTLEMENT
, VOID
, WRITE_OFF
, REFUNDED
, PAYMENT_PLAN
Total amount of the charge.
Total outstanding amount that is yet to be paid or adjusted away.
Description of the charge.
The creation date of the charge in your external system, if applicable.
External identifier for the charge, if applicable.
Any additional metadata about the charge relevant to your system.
Identifier for the rule set applied to this charge, if any.
curl --request GET \
--url https://api.decodahealth.com/v1/charge/get/{charge_id} \
--header 'API-KEY: <api-key>' \
--header 'TENANT: <tenant>'
{
"adjustments": [
{
"adjustmentType": "WRITE_OFF",
"amount": 123,
"chargeId": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"id": "<string>",
"providerId": "<string>",
"reason": "<string>"
}
],
"createdDate": "2023-11-07T05:31:56Z",
"customAmount": 123,
"description": "<string>",
"discountAmount": 123,
"discountPercentage": 123,
"explanationOfBenefits": [
{
"chargeBalance": 123,
"chargeId": "<string>",
"contractualAdjustment": 123,
"diagnoses": "<string>",
"diagnosesDescription": "<string>",
"id": "<string>",
"insurancePayment": 123,
"locationName": "<string>",
"manualAdjustment": 123,
"originalChargeAmount": 123,
"patientBalance": 123,
"patientPayment": 123,
"procedure": "<string>",
"procedureDescription": "<string>"
}
],
"externalCreatedDate": "2023-11-07T05:31:56Z",
"externalId": "<string>",
"id": "<string>",
"items": [
{
"chargeId": "<string>",
"discountAmount": 123,
"discountPercentage": 123,
"item": {
"description": "<string>",
"id": "<string>",
"image": "<string>",
"meta": {},
"name": "<string>",
"price": 123,
"unit": "<string>"
},
"itemId": "<string>",
"quantity": 123
}
],
"meta": {},
"patient": {
"address": "<string>",
"addressLineTwo": "<string>",
"addressValid": true,
"allergies": [
"<string>"
],
"city": "<string>",
"country": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"dateOfBirth": "2023-12-25",
"email": "<string>",
"externalUserId": "<string>",
"familyHistory": [
"<string>"
],
"firstName": "<string>",
"id": "<string>",
"lastName": "<string>",
"medicalHistory": [
"<string>"
],
"medications": [
"<string>"
],
"meta": {},
"optedOutOfSms": false,
"phoneNumber": "<string>",
"prescriptions": [
"<string>"
],
"state": "<string>",
"type": "<string>",
"zipCode": "<string>"
},
"patientId": "<string>",
"patientPaysProcessingFee": true,
"payments": [
{
"amount": 123,
"charge": {
"externalId": "<string>",
"id": "<string>",
"meta": {},
"total": 123,
"totalOutstanding": 123
},
"chargeId": "<string>",
"createdDate": "2023-11-07T05:31:56Z",
"payment": {
"amount": 123,
"createdDate": "2023-11-07T05:31:56Z",
"currency": "USD",
"failedReason": "<string>",
"fee": 123,
"id": "<string>",
"patientId": "<string>",
"payinConfigId": "<string>",
"payinId": "<string>",
"paymentMedium": "POS",
"paymentMethod": {
"accountHolderType": "<string>",
"accountNumberLast4": 123,
"bankName": "<string>",
"brand": "<string>",
"description": "<string>",
"expMonth": 123,
"expYear": 123,
"id": "<string>",
"last4": "<string>",
"patientId": "<string>",
"rainforestPaymentMethodId": "<string>",
"routingNumber": 123,
"type": "CARD"
},
"paymentMethodId": "<string>",
"refunds": [
{
"amount": 123,
"createdDate": "2023-11-07T05:31:56Z",
"fee": 0,
"id": "<string>",
"paymentId": "<string>",
"rainforestRefundId": "<string>",
"reason": "DUPLICATE",
"status": "CANCELED"
}
],
"status": "CANCELED",
"stripePaymentIntentId": "<string>",
"updatedDate": "2023-11-07T05:31:56Z"
},
"paymentId": "<string>"
}
],
"ruleSetId": "<string>",
"status": "OUTSTANDING",
"total": 123,
"totalOutstanding": 123
}