Fee SchedulesV3

Upload a fee schedule (a collection of rates)

POST
Uploads a new fee schedule.\n Each rate may either be totally new as qualified by it's dimensions or a new version for an existing rate.\n If adding a new version to an existing rate, the rate must be posted with the next version number (previous version + 1) or a EntityConflictError will be returned.\n Use the dry run flag to discover already existing rates and to run validations. If validations for any rate fail, no rates will be saved to the system.

Request

This endpoint expects an object.
dry_run
booleanRequired
rates
list of unionsRequired

Response

This endpoint returns a list of objects
rate_id
UUID
dimensions
object
The dimension values that distinguish this rate from others.
version
integer
The version of this rate in the system.
updated_at
date
updated_by
UUID
entries
list of objects

A rate value in cents for a specific time range. Rate entries can be deactivated, which is set by using the deelte_rate endpoint. Deactivated rate entries are not considered when matching against service lines.

Errors

POST
1curl -X POST https://api.joincandidhealth.com/api/fee-schedules/v3 \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "dry_run": true,
6  "rates": [
7    {
8      "type": "new_rate",
9      "dimensions": {
10        "payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
11        "organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
12        "states": [
13          "AA"
14        ],
15        "zip_codes": [
16          "string"
17        ],
18        "license_types": [
19          "MD"
20        ],
21        "facility_type_codes": [
22          "01"
23        ],
24        "network_types": [
25          "12"
26        ],
27        "cpt_code": "string",
28        "modifiers": [
29          "22"
30        ]
31      },
32      "entries": [
33        {
34          "start_date": "2023-01-01",
35          "rate_cents": 0,
36          "is_deactivated": true
37        }
38      ]
39    }
40  ]
41}'
1[
2  {
3    "rate_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
4    "dimensions": {
5      "payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6      "organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
7      "states": [
8        "AA"
9      ],
10      "zip_codes": [
11        "string"
12      ],
13      "license_types": [
14        "MD"
15      ],
16      "facility_type_codes": [
17        "01"
18      ],
19      "network_types": [
20        "12"
21      ],
22      "cpt_code": "string",
23      "modifiers": [
24        "22"
25      ]
26    },
27    "version": 0,
28    "updated_at": "2023-01-01",
29    "updated_by": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
30    "entries": [
31      {
32        "start_date": "2023-01-01",
33        "rate_cents": 0,
34        "is_deactivated": true,
35        "end_date": "2023-01-01"
36      }
37    ]
38  }
39]
Built with